Плагин «Подписка 3KL» часть 2. Глобальные настройки

Сергей Гусев, Алексей Городков
05.03.2026
Плагин «Подписка 3KL» предназначен для организации сценариев платной и бесплатной подписки слушателей на курс. Данная часть инструкции посвящена настройкам способов оплаты (эквайеров).
Описываемый в статье плагин enrol_otpay называется «Подписка 3КL» начиная с версии 4.1.15a.  Начиная с версии 3.9.18b он назывался «Платная подписка 3KL». В более ранних версиях используется название «OT Pay».
Материалы по плагину «Подписка 3KL»:

Плагин «Подписка 3KL» часть 1. Интеграция с сервисами приема платежей описание функциональных возможностей плагина и интеграции с платежными сервисами.

Плагин «Подписка 3KL» часть 3. Настройка платной подписки на курс  добавление платной подписки в курс, настройка способа зачисления, решения.

Функционал, описанный в данной статье, в полном объеме доступен в СЭО 3КL начиная с версии 4.1.8а.
Если вы используете более раннюю версию системы — обратитесь с заявкой на проведение обновления в службу технической поддержки ООО «Открытые технологии».
Внимание!
Действия в данной инструкции с меткой требуются права администратора можно выполнить только при наличии доступа «Полный Администратор». По умолчанию мы предоставляем доступ «Диспетчер-Администратор». Для изменения глобальных конфигураций мы рекомендуем выбрать набор требуемых опций по данной инструкции и обратиться в техническую поддержку с заявкой на конфигурирование системы. Подробнее - в статье Полный административный доступ.
Включение и наcтройка плагина «Подписка 3KL» может быть выполнена силами сотрудников технической поддержки ООО «Открытые технологии». Для этого необходимо подать соответствующую заявку в личном кабинете.
Если вы хотите самостоятельно переконфигурировать свою систему на основе этой инструкции, убедитесь, что вы обладаете всеми необходимыми для этого правами.
Подробнее о плагине «Платная подписка 3КL» в статье «Плагин «Подписка 3КL». Видео инструкция по СЭО 3KL 4.1».

1. Общие настройки плагина требуются права администратора

Перед непосредственной настройкой плагина необходимо убедиться, что он присутствует в перечне способов записи (Настройки->Администрирование->Плагины->Зачисления на курсы->Управления способами записи) и включен (пиктограмма имеет вид ) (Рис. 1.1).

 

Рис. 1.1. Плагин «Подписка 3KL» на странице «Управление способами записи».
Если СЭО 3КL имеет действующий тарифный план и находится на гарантийной технической поддержке, плагин «Подписка 3KL» будет автоматически активен в системе. Дополнительная информация об активации и возможных проблемах — в третьей части статьи.

Раздел «Общие настройки плагина «Подписка 3KL» активированного плагина содержит следующие поля и возможности (Рис. 1.2):

Рис. 1.2. Общие настройки плагина «Подписка 3KL».
  • Кнопка «Панель управления купонами». Позволяет перейти на страницу настроек и управления купонами в системе.
  • Роль по умолчанию. Позволяет определить роль (выбрать из существующих в системе), под которой пользователь будет (по умолчанию) подписываться на курс при использовании этого способа записи.
  • Активность способа записи по умолчанию. Параметр определяет состояние способа записи при добавлении его в курс:
  • Да — способ по умолчанию активен;
  • Нет — способ «Подписка 3KL» добавляется в перечень способов записи курса, но в выключенном состоянии.
  • Время отправки уведомления об истечении срока обучения. Определяет, за сколько дней до окончания срока обучения пользователь получит уведомление об этом.
  • Действие при окончании подписки. Позволяет установить, что произойдет, когда закончится пользовательская подписка на курс. Возможные варианты:
  • Оставить пользователя записанным.
  • Заблокировать запись на курс и удалить назначенные роли.
  • Исключить пользователя из курса.
  • Опция «Разрешить передачу email пользователя во время оплаты». Включение опции быть востребовано в случае, если эквайер поддерживает такую возможность и может использовать электронную почту пользователя, например для автоподстановки в форму оплаты.

-Вернуться к содержанию-

2. Глобальные настройки способов оплаты (эквайеров)

Если в процессе самостоятельного подключения к эквайеру вы предварительно использовали тестовые параметры (адрес тестового серера, тестовые пароль/логин и т.п.), то после того, как плагин был успешно настроен, не забудьте изменить эти значения на реальные, которые вы получили от эквайера.
Если же вы обращаетесь  за помощью по настройке в техническую поддержку ООО «Открытые технологии» — в заявке необходимо сразу указывать реальные (не тестовые!) реквизиты эквайера.

2.1. Настройки способа генерации формы

Если планируется возможность оплаты курса по квитанции, поля раздела (Рис. 2.1.1) должны содержать реквизиты банка, в котором у вас открыт расчетный счет и на который пользователи должны осуществлять оплату.

Рис. 2.1.1. Пример заполнения полей раздела «Настройки способа генерации формы».

Квитанция на оплату (форма ПД-4) будет сформирована системой автоматически, при выборе и настройке в способе зачисления на курс метода оплаты «Зачисление с подтверждением» (Рис. 2.1.2).

 

Рис. 2.1.2. Пример заполненной квитанции ПД-4.

В поле «Сумма» будет подставлено значение «Цена» из настроенного в курсе при помощи плагина «Подписка 3KL» способа зачисления.

«Плательщик» — данные из учетной записи зачисляемого пользователя (или могут быть изменены вручную в модальном окне генерации счета).

«Адрес плательщика», «Дата», «Подпись» — поля заполняются вручную, непосредственно на квитанции.

Строка в поле «Платеж» может быть отредактирована через локального изменение языкового пакета (Настройки->Администрирование->Язык->Локальные изменения языкового пакета) (Рис. 2.1.3).

Рис. 2.1.3. Рабочий интерфейс страницы «Локальные изменения языкового пакета».

Строка стандартного текста имеет вид:

За «{$a->course_code}» по счету №{$a->account_number} от {$a->date} г.

Здесь:

course_code - краткое название курса, 
account_number - номер счета,
date - дата формирования квитанции.
Подробнее о локальных изменениях языкового пакета в статье «Изменение стандартных настроек и текстов, отображаемых пользователям в теме «СЭО 3KL».

-Вернуться к содержанию-

2.2. Настройки способа оплаты ЮKassa (бывшая Яндекс.Касса)

В разделе находятся настройки для электронной оплаты через эквайера ЮКаssа (Рис. 2.2.1).

Рис. 2.2.1. Раздел «Настройки способа оплаты ЮКаssа».

Необходимые значения полей можно уточнить в личном кабинете или технической поддержке эквайера.

Для заполнения анкеты для ЮKassa вам понадобится следующая информация по интеграции:

checkUrl: https://ВАШ_ДОМЕН/enrol/otpay/plugins/yandex/request/check.php
avisoUrl: https://ВАШ_ДОМЕН/enrol/otpay/plugins/yandex/request/aviso.php
shopSuccessUrl и shopFailUrl динамические

Используемый магазином протокол вы сможете увидеть в личном кабинете. Поменять протокол в интерфейсе личного кабинета ЮKassa возможности нет. Новые подключения к ЮKassa создаются только с протоколом API.
Подробнее о эквайере ЮKassa в первой части статьи.

-Вернуться к содержанию-

2.2.1. Особенности формирования чека по платежу в формате фискальных данных ФФД 1.2

Если в процессе оплаты необходимо формировать чеки в соответствии с ФФД 1.2, поля настроек «Предмет расчета» и «Способ расчета» (см. поз. 1 Рис. 2.2.1) должны иметь значения, отличные от «Не передавать».

Конкретное значение полей зависит от реализуемого в вашей СЭО 3KL объекта продажи, типа и условий оплаты, вида онлайн-кассы, и может быть уточнено на сайте эквайера ЮKassa:

Признак предмета расчета (тег в 54 ФЗ — 1212) Признак способа расчета (тег в 54 ФЗ — 1214)
Для ЮКassы Для ЮKassы
Для сторонних онлайн-касс Для сторонних онлайн-касс

-Вернуться к содержанию-

2.3. Настройки способа оплаты Сбер

В разделе находятся настройки для электронной оплаты через эквайера Сбер (Рис. 2.3.1).

Начиная с версии СЭО 3KL 4.1.18a реализована поддержка нового платежного шлюза Сбера.
Для обеспечения работоспособности платежного сервиса необходимо указать в поле «Адрес сервера для запросов» нужный адрес шлюза:
https://securepayments.sberbank.ru — старый шлюз;
https://ecommerce.sberbank.ru — новый шлюз.

Рис. 2.3.1.  Раздел «Настройки способа оплаты Сбербанк».
Обратите внимание, что пара логин/пароль, заполняемая в форме, должна быть от учетной записи пользователя API, а не от личного кабинета эквайринга!
Подробнее о эквайере Сбер в первой части статьи.

-Вернуться к содержанию-

2.3.1. Передача пользовательских данных в платежный шлюз банка

По умолчанию при электронной оплате из СЭО 3КL в банк передается только ФИО пользователя.

Настройка «Поля профиля пользователя для передачи в платежный шлюз банка» позволяет реализовать передачу в платежный шлюз банка дополнительной информации: данных полей профиля пользователя с произвольными названиями. Перечень транслируемых полей профиля и названий к ним определяется при помощи yaml-кода, размещаемого в поле настройки (см. поз. 1 Рис. 2.3.1).

Возможность может быть востребована для реализации автоматической интеграции нескольких систем, например, СЭО 3КL ->эквайер Сбер->1С.Бухгалтерия:
1) Слушатель из среды электронного обучения производит интернет-оплату за курс и, в процессе оплаты, в банк дополнительно передается его уникальный идентификатор пользователя (например, СНИЛС).
2) Информация об оплате выгружается из личного кабинета в банке непосредственно в 1С организации и платеж автоматически учитывается для слушателя, чей уникальный идентификатор присутствовал в банковской выгрузке.

Yaml-код формируется в следующем формате:

- ['префикс_идентификатор поля','название поля']

где:

  • префикс — определяет тип поля профиля (user - для основных полей, profile_field - для дополнительных);
  • идентификатор поля — уникальное наименование этого поля в СЭО 3КL;
  • название поля — название поля, передаваемое в платежный шлюз (если оставить пустым - будет передано название из СЭО 3KL).

Пример yaml-кода:

- ['user_fullname','Плательщик']
- ['user_fullname','ФИО слушателя']
- ['profile_field_edu','Форма обучения']
- ['profile_field_snils','СНИЛС']

здесь:

  • user_fullname — полное имя пользователя (основное поле профиля);
  • profile_field_edu — форма обучения слушателя (дополнительное поле профиля);
  • profile_field_snils — страховой номер индивидуального лицевого счета (дополнительное поле профиля).

На странице личного кабинета Сбера переданные пользовательские данные будут отображаться таблицей вида:

Имя Значение
Плательщик Иванов Иван Иванович
ФИО слушателя Иванов Иван Иванович
Форма обучения дневная
СНИЛС 11111111111
Обратите внимание: передаваемые дополнительные поля профиля пользователя должны быть предварительно созданы в СЭО 3КL и корректно заполнены для всех слушателей. Незаполненные поля передаваться и отображаться не будут.

При передаче данных существуют ограничения по длине передаваемого поля (слишком длинное поле не будет отображено эквайрингом) и по формату передаваемого значения — только текст (нетекстовые поля (файлы и т. п.) будут переданы некорректно).

-Вернуться к содержанию-

2.4. Настройки способа оплаты Epay (JSC Halyk bank) (бывший Казкоммерцбанк)

В разделе находятся настройки для электронной оплаты через эквайера Epay (JSC Halyk bank) (Рис. 2.4.1).

Рис. 2.4.1. Раздел «Настройки способа оплаты Epay (JSC Halyk bank)».

Необходимые значения полей можно уточнить в личном кабинете или технической поддержке эквайера.

Подробнее о эквайере Казкоммерцбанк в первой части статьи.

-Вернуться к содержанию-

3. Настройка купонов

3.1. Общая информация по использованию купонов

Способ оплаты «Зачисление по купону» предназначен для сценариев подписки пользователей на курс с помощью купона на зачисление и использования скидочных купонов при платной записи на курс через другие способы оплаты плагина («Зачисление с подтверждением» и «Электронная оплата»).

Купоны в СЭО 3КL создаются при помощи панели управления купонами. При создании для купона обязательно должны быть определены следующие свойства.

Вид купона:

  • одноразовый (для однократного применения);
  • многоразовый (пользователи могут использовать в системе купон многократно).

Локация использования:

  • для всех курсов (купон может быть применен во всех курсах системы, где настроено использование купонов);
  • для конкретного курса (купон предназначен для зачисления/скидки при зачислении только на определенный курс).

Тип скидки:

  • абсолютная скидка (при использовании такого купона для оплаты подписки на курс цена курса будет уменьшена  на установленную стоимость купона);
  • относительная скидка (при использовании такого купона для оплаты подписки на курс цена курса станет меньше  на столько процентов, сколько указано в купоне);
  • зачисление по купону (позволяет пользователю-владельцу купона бесплатно подписаться на платный курс).

Дополнительно и в зависимости от сценариев использования купонов при создании также можно указать: категорию купона, продолжительность/срок действия купона, число создаваемых купонов. Можно создавать купоны с конкретным именем (кодом).

При использовании купонов разного типа или разных категорий скидка будет суммироваться.
Купоны со статусом «Использован», а также с прошедшим сроком действия больше не могут быть применены для зачисления.
Пример использования купонов в статье «Платные тесты с пересдачей. Курс-решение».

-Вернуться к содержанию-

3.2. Панель управления купонами

Для перехода на страницу «Панель управления купонами» необходимо нажать на кнопку «Панель управления купонами», расположенную в разделе «Общие настройки плагина «Подписка 3KL» (см. Рис. 1.2), или в разделе настроек «Настройки способа подписки купоном» способа зачисления на курс.

Панель управления купонами состоит из двух вкладок:

  • Вкладка «Категории» (Рис. 3.2.1).

Рис. 3.2.1. Вкладка «Категории» панели управления купонами.

На вкладке расположен интерфейс создания новой категории (см. поз. 1 Рис. 3.2.1) и таблица с информацией об уже имеющихся в системе категориях купонов (см. поз. 2 Рис 3.2.1). Нажав на ссылку «Удалить» (см. поз. 3 Рис. 3.2.1) в столбце «Действия», пользователь может удалить выбранную категорию.

  • Вкладка «Купоны» (Рис. 3.2.2).

Рис. 3.2.2. Вкладка «Купоны» панели управления купонами.

Аналогично вкладке «Категории» вкладка «Купоны» содержит интерфейс для создания новых купонов и список всех существующих в системе купонов.

При создании нового купона необходимо указать следующие параметры.

  • Категория. Позволяет выбрать (из имеющихся в системе) категорию купона, в которой он будет размещен.
  • Курс. Устанавливает принадлежность купона к курсу: только для конкретного курса или для всех курсов в системе.
  • Тип купона (одноразовый/многоразовый). Если купон одноразовый, то его можно использовать только один раз.
  • Купон предоставляет. Настройка определяет способ применения купона. Возможные варианты:
    • скидка в размере указанной суммы (абсолютное значение скидки в рублях указывается в поле «Величина скидки»);
    • скидка в % от стоимости курса (процент скидки от стоимости курса указывается в поле «Величина скидки»);
    • зачисление по купону (предъявив при записи купон, пользователь зачисляется на курс бесплатно).
Если выбрано «Зачисление по купону», то в курс должен быть добавлен отдельный способ записи «Платная подписка 3KL» с возможностью зачисления по купону.
  • Величина скидки. Значение скидки, с учетом выбранного в поле «Купон предоставляет» способа применения.
  • Продолжительность действия купона. В этом поле определяется срок, в течение которого купон будет действителен с момента создания (если указать «0», то купон будет действовать без ограничения по сроку).
  • Число купонов. Определяет, сколько будет сгенерировано одинаковых купонов с указанными параметрами.
  • Опция «Создать именные купоны». Если опция установлена, код купона не генерируется системой, а указывается в поле «Имя купонов».
  • Имя купонов. В поле вручную указывается код купона (при установленной опции «Создать именные купоны»).
Коды купонов должны быть уникальными. При попытке создать именной купон с названием (кодом), которое уже существует — система выдаст сообщение об ошибке.

Нажав на ссылку в столбце таблицы «Код» (см. поз. 1, Рис. 3.2.2) можно перейти к истории использования выбранного купона (Рис. 3.2.3).

Рис. 3.2.3. Пример истории использования купона.
Обратите внимание: для созданных купонов и категорий не предусмотрена возможность редактирования. Если купон (категория) были созданы с ошибками — их можно только удалить и создать заново.

-Вернуться к содержанию-

4. Глобальные настройки добровольной заморозки подписок

Механизм добровольной заморозки платных подписок реализован при помощи локального плагина «Заморозка платных подписок 3КL» (local_enrollfreezing3kl). Глобальные настройки заморозки находятся: Настройки->Администрирование->Плагины->Локальные плагины->Заморозка платных подписок 3КL (Рис. 4.1).

Рис. 4.1. Глобальные настройки добровольной заморозки подписок.

Доступны следующие параметры:

  • Опция «Разрешить заморозку подписок». Включает/отключает возможность применения заморозки подписок в системе по умолчанию.
  • Максимально возможное количество заморозок. Параметр определяет, сколько раз в пределах общего разрешенного срока заморозки пользователь может воспользоваться добровольной заморозкой курса (если 0 — количество раз не ограничено).
  • Минимальная продолжительность заморозки (в днях). Минимальное количество дней, на которое единоразово может быть заморожена подписка (если 0 — минимальная продолжительность не ограничена).
  • Максимально возможная общая продолжительность заморозки (в днях). Общее суммарное время , на которое пользователь может заморозить свою подписку (если 0 — время не ограничено).
  • Опция «Разрешать разморозку, если минимальный период заморозки еще не прошел». Если опция включена, то пользователь может разморозить свою подписку раньше, чем закончится ранее настроенное время заморозки.
Имейте ввиду, при досрочной разморозке подписки на курс из максимального общего срока заморозки будет вычитаться значение минимальной продолжительности заморозки (если установлено), а не фактическое время действия заморозки.

-Вернуться к содержанию-

Теги: интеграция, подписка
Рейтинг ответа: 0 (0 оценок)

Комментарии запрещены