Плагин «Подписка 3KL» часть 2. Глобальные настройки
Плагин «Подписка 3KL» часть 1. Интеграция с сервисами приема платежей — описание функциональных возможностей плагина и интеграции с платежными сервисами.
Плагин «Подписка 3KL» часть 3. Настройка платной подписки на курс — добавление платной подписки в курс, настройка способа зачисления, решения.
Если вы используете более раннюю версию системы — обратитесь с заявкой на проведение обновления в службу технической поддержки ООО «Открытые технологии».
1. Общие настройки плагинатребуются права администратора
2. Глобальные настройки способов оплаты (эквайеров)
2.1. Настройки способа генерации формы
2.2. Настройки способа оплаты ЮКаssа
2.2.1. Особенности формирования чека по платежу в формате фискальных данных ФФД 1.2
2.3. Настройки способа оплаты Сбер
2.3.1. Передача пользовательских данных в платежный шлюз банка
2.4. Настройки способа оплаты Epay (JSC Halyk bank)
3. Настройка купонов
3.1. Общая информация по использованию купонов
3.2. Панель управления купонами
4. Глобальные настройки добровольной заморозки подписок
Действия в данной инструкции с меткой требуются права администратора можно выполнить только при наличии доступа «Полный Администратор». По умолчанию мы предоставляем доступ «Диспетчер-Администратор». Для изменения глобальных конфигураций мы рекомендуем выбрать набор требуемых опций по данной инструкции и обратиться в техническую поддержку с заявкой на конфигурирование системы. Подробнее - в статье Полный административный доступ.
Если вы хотите самостоятельно переконфигурировать свою систему на основе этой инструкции, убедитесь, что вы обладаете всеми необходимыми для этого правами.
1. Общие настройки плагина требуются права администратора
Перед непосредственной настройкой плагина необходимо убедиться, что он присутствует в перечне способов записи (Настройки->Администрирование->Плагины->Зачисления на курсы->Управления способами записи) и включен (пиктограмма имеет вид ) (Рис. 1.1).
Раздел «Общие настройки плагина «Подписка 3KL» активированного плагина содержит следующие поля и возможности (Рис. 1.2):
- Кнопка «Панель управления купонами». Позволяет перейти на страницу настроек и управления купонами в системе.
- Роль по умолчанию. Позволяет определить роль (выбрать из существующих в системе), под которой пользователь будет (по умолчанию) подписываться на курс при использовании этого способа записи.
- Активность способа записи по умолчанию. Параметр определяет состояние способа записи при добавлении его в курс:
- Да — способ по умолчанию активен;
- Нет — способ «Подписка 3KL» добавляется в перечень способов записи курса, но в выключенном состоянии.
- Время отправки уведомления об истечении срока обучения. Определяет, за сколько дней до окончания срока обучения пользователь получит уведомление об этом.
- Действие при окончании подписки. Позволяет установить, что произойдет, когда закончится пользовательская подписка на курс. Возможные варианты:
- Оставить пользователя записанным.
- Заблокировать запись на курс и удалить назначенные роли.
- Исключить пользователя из курса.
- Опция «Разрешить передачу email пользователя во время оплаты». Включение опции быть востребовано в случае, если эквайер поддерживает такую возможность и может использовать электронную почту пользователя, например для автоподстановки в форму оплаты.
2. Глобальные настройки способов оплаты (эквайеров)
Если же вы обращаетесь за помощью по настройке в техническую поддержку ООО «Открытые технологии» — в заявке необходимо сразу указывать реальные (не тестовые!) реквизиты эквайера.
2.1. Настройки способа генерации формы
Если планируется возможность оплаты курса по квитанции, поля раздела (Рис. 2.1.1) должны содержать реквизиты банка, в котором у вас открыт расчетный счет и на который пользователи должны осуществлять оплату.
Квитанция на оплату (форма ПД-4) будет сформирована системой автоматически, при выборе и настройке в способе зачисления на курс метода оплаты «Зачисление с подтверждением» (Рис. 2.1.2).
В поле «Сумма» будет подставлено значение «Цена» из настроенного в курсе при помощи плагина «Подписка 3KL» способа зачисления.
«Плательщик» — данные из учетной записи зачисляемого пользователя (или могут быть изменены вручную в модальном окне генерации счета).
«Адрес плательщика», «Дата», «Подпись» — поля заполняются вручную, непосредственно на квитанции.
Строка в поле «Платеж» может быть отредактирована через локального изменение языкового пакета (Настройки->Администрирование->Язык->Локальные изменения языкового пакета) (Рис. 2.1.3).
Строка стандартного текста имеет вид:
За «{$a->course_code}» по счету №{$a->account_number} от {$a->date} г.
Здесь:
course_code - краткое название курса,
account_number - номер счета,
date - дата формирования квитанции.
2.2. Настройки способа оплаты ЮKassa (бывшая Яндекс.Касса)
В разделе находятся настройки для электронной оплаты через эквайера ЮКаssа (Рис. 2.2.1).
Необходимые значения полей можно уточнить в личном кабинете или технической поддержке эквайера.
Для заполнения анкеты для ЮKassa вам понадобится следующая информация по интеграции:
checkUrl: https://ВАШ_ДОМЕН/enrol/otpay/plugins/yandex/request/check.php
avisoUrl: https://ВАШ_ДОМЕН/enrol/otpay/plugins/yandex/request/aviso.php
shopSuccessUrl и shopFailUrl — динамические
2.2.1. Особенности формирования чека по платежу в формате фискальных данных ФФД 1.2
Если в процессе оплаты необходимо формировать чеки в соответствии с ФФД 1.2, поля настроек «Предмет расчета» и «Способ расчета» (см. поз. 1 Рис. 2.2.1) должны иметь значения, отличные от «Не передавать».
Конкретное значение полей зависит от реализуемого в вашей СЭО 3KL объекта продажи, типа и условий оплаты, вида онлайн-кассы, и может быть уточнено на сайте эквайера ЮKassa:
| Признак предмета расчета (тег в 54 ФЗ — 1212) | Признак способа расчета (тег в 54 ФЗ — 1214) |
| Для ЮКassы | Для ЮKassы |
| Для сторонних онлайн-касс | Для сторонних онлайн-касс |
2.3. Настройки способа оплаты Сбер
В разделе находятся настройки для электронной оплаты через эквайера Сбер (Рис. 2.3.1).
Для обеспечения работоспособности платежного сервиса необходимо указать в поле «Адрес сервера для запросов» нужный адрес шлюза:
https://securepayments.sberbank.ru — старый шлюз;
https://ecommerce.sberbank.ru — новый шлюз.
2.3.1. Передача пользовательских данных в платежный шлюз банка
По умолчанию при электронной оплате из СЭО 3КL в банк передается только ФИО пользователя.
Настройка «Поля профиля пользователя для передачи в платежный шлюз банка» позволяет реализовать передачу в платежный шлюз банка дополнительной информации: данных полей профиля пользователя с произвольными названиями. Перечень транслируемых полей профиля и названий к ним определяется при помощи yaml-кода, размещаемого в поле настройки (см. поз. 1 Рис. 2.3.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 |
При передаче данных существуют ограничения по длине передаваемого поля (слишком длинное поле не будет отображено эквайрингом) и по формату передаваемого значения — только текст (нетекстовые поля (файлы и т. п.) будут переданы некорректно).
2.4. Настройки способа оплаты Epay (JSC Halyk bank) (бывший Казкоммерцбанк)
В разделе находятся настройки для электронной оплаты через эквайера Epay (JSC Halyk bank) (Рис. 2.4.1).
Необходимые значения полей можно уточнить в личном кабинете или технической поддержке эквайера.
3. Настройка купонов
3.1. Общая информация по использованию купонов
Способ оплаты «Зачисление по купону» предназначен для сценариев подписки пользователей на курс с помощью купона на зачисление и использования скидочных купонов при платной записи на курс через другие способы оплаты плагина («Зачисление с подтверждением» и «Электронная оплата»).
Купоны в СЭО 3КL создаются при помощи панели управления купонами. При создании для купона обязательно должны быть определены следующие свойства.
Вид купона:
- одноразовый (для однократного применения);
- многоразовый (пользователи могут использовать в системе купон многократно).
Локация использования:
- для всех курсов (купон может быть применен во всех курсах системы, где настроено использование купонов);
- для конкретного курса (купон предназначен для зачисления/скидки при зачислении только на определенный курс).
Тип скидки:
- абсолютная скидка (при использовании такого купона для оплаты подписки на курс цена курса будет уменьшена на установленную стоимость купона);
- относительная скидка (при использовании такого купона для оплаты подписки на курс цена курса станет меньше на столько процентов, сколько указано в купоне);
- зачисление по купону (позволяет пользователю-владельцу купона бесплатно подписаться на платный курс).
Дополнительно и в зависимости от сценариев использования купонов при создании также можно указать: категорию купона, продолжительность/срок действия купона, число создаваемых купонов. Можно создавать купоны с конкретным именем (кодом).
3.2. Панель управления купонами
Для перехода на страницу «Панель управления купонами» необходимо нажать на кнопку «Панель управления купонами», расположенную в разделе «Общие настройки плагина «Подписка 3KL» (см. Рис. 1.2), или в разделе настроек «Настройки способа подписки купоном» способа зачисления на курс.
Панель управления купонами состоит из двух вкладок:
- Вкладка «Категории» (Рис. 3.2.1).
На вкладке расположен интерфейс создания новой категории (см. поз. 1 Рис. 3.2.1) и таблица с информацией об уже имеющихся в системе категориях купонов (см. поз. 2 Рис 3.2.1). Нажав на ссылку «Удалить» (см. поз. 3 Рис. 3.2.1) в столбце «Действия», пользователь может удалить выбранную категорию.
- Вкладка «Купоны» (Рис. 3.2.2).
Аналогично вкладке «Категории» вкладка «Купоны» содержит интерфейс для создания новых купонов и список всех существующих в системе купонов.
При создании нового купона необходимо указать следующие параметры.
- Категория. Позволяет выбрать (из имеющихся в системе) категорию купона, в которой он будет размещен.
- Курс. Устанавливает принадлежность купона к курсу: только для конкретного курса или для всех курсов в системе.
- Тип купона (одноразовый/многоразовый). Если купон одноразовый, то его можно использовать только один раз.
- Купон предоставляет. Настройка определяет способ применения купона. Возможные варианты:
- скидка в размере указанной суммы (абсолютное значение скидки в рублях указывается в поле «Величина скидки»);
- скидка в % от стоимости курса (процент скидки от стоимости курса указывается в поле «Величина скидки»);
- зачисление по купону (предъявив при записи купон, пользователь зачисляется на курс бесплатно).
- Величина скидки. Значение скидки, с учетом выбранного в поле «Купон предоставляет» способа применения.
- Продолжительность действия купона. В этом поле определяется срок, в течение которого купон будет действителен с момента создания (если указать «0», то купон будет действовать без ограничения по сроку).
- Число купонов. Определяет, сколько будет сгенерировано одинаковых купонов с указанными параметрами.
- Опция «Создать именные купоны». Если опция установлена, код купона не генерируется системой, а указывается в поле «Имя купонов».
- Имя купонов. В поле вручную указывается код купона (при установленной опции «Создать именные купоны»).
Нажав на ссылку в столбце таблицы «Код» (см. поз. 1, Рис. 3.2.2) можно перейти к истории использования выбранного купона (Рис. 3.2.3).
4. Глобальные настройки добровольной заморозки подписок
Механизм добровольной заморозки платных подписок реализован при помощи локального плагина «Заморозка платных подписок 3КL» (local_enrollfreezing3kl). Глобальные настройки заморозки находятся: Настройки->Администрирование->Плагины->Локальные плагины->Заморозка платных подписок 3КL (Рис. 4.1).
Доступны следующие параметры:
- Опция «Разрешить заморозку подписок». Включает/отключает возможность применения заморозки подписок в системе по умолчанию.
- Максимально возможное количество заморозок. Параметр определяет, сколько раз в пределах общего разрешенного срока заморозки пользователь может воспользоваться добровольной заморозкой курса (если 0 — количество раз не ограничено).
- Минимальная продолжительность заморозки (в днях). Минимальное количество дней, на которое единоразово может быть заморожена подписка (если 0 — минимальная продолжительность не ограничена).
- Максимально возможная общая продолжительность заморозки (в днях). Общее суммарное время , на которое пользователь может заморозить свою подписку (если 0 — время не ограничено).
- Опция «Разрешать разморозку, если минимальный период заморозки еще не прошел». Если опция включена, то пользователь может разморозить свою подписку раньше, чем закончится ранее настроенное время заморозки.