Плагин «OT Pay» часть 1. Интеграция с сервисами приема платежей

Сергей Гусев, Алексей Городков
2022-09-30 11:22
Материалы по плагину «OT Pay»:

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

Плагин «OT Pay» часть 2. Активация и глобальные настройки - активация плагина в системе, данные для первоначальной (глобальной) настройки плагина в зависимости от планируемых типов оплаты в курсах и от эквайеров.

Плагин «OT Pay» часть 3. Настройка платной подписки на курс - добавление платной подписки на курс с помощью плагина, настройки этого способа зачисления, ряд типовых решений для различной тарификации курсов.

Cодержание:
1. Общая информация о плагине
   1.1. Возможности
      1.1.1. Сценарий «Зачисление на курс по купону»
      1.1.2. Сценарий «Оплата по счету»
      1.1.3. Сценарий «Электронная оплата»
      1.1.4. Сценарий «Облачная касса»
      1.1.5. Сценарий «Доступ по условию»
      1.1.6. Сценарий «Заморозка подписки»
    1.2. Возможности настройки внешнего вида
2. Возможности и особенности интеграции
   2.1. Общая информация об интернет-оплате
   2.2. Особенности интеграции СЭО 3КL с сервисами платежей
   2.3. Последовательность действий при интеграции с сервисами платежей
      2.3.1. Выбор подходящего вам эквайера
      2.3.2. Заключение договора с выбранным эквайером
      2.3.3. Подключение к облачной кассе
      2.3.4. Передача в техподержку реквизитов для подключения
      2.3.5. Тестирование оплаты из СЭО
3. Часто задаваемые вопросы по интеграции с платежными сервисами

1. Общая информация о плагине

Разработанный ООО «Открытые технологии» плагин «OT Pay» предназначен для организации разнообразных сценариев платной подписки и может применяться для автоматической записи слушателей на курс после онлайн-оплаты. Плагин позволяет:

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

Плагин поддерживает следующие способы оплаты:

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

Для работы плагина нужно выполнить следующие действия:

  • подать заявку на включение модуля платной подписки, чтобы активировать в системе модуль «OT Pay»;
  • передать в техническую поддержку реквизиты для настройки СЭО в части организации приема платежей;
  • добавить и настроить способы записи на курс;
  • протестировать прохождение платежей.

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

1.1. Возможности

1.1.1. Сценарии «Зачисление на курс по купону»

Купон на бесплатное зачисление

  1. Пользователь вводит код купона на зачисление на курс.
  2. Система проверяет купон, и если он действителен, тут же записывает пользователя на курс.

Купон на скидку

  1. Пользователь вводит коды купонов на скидку.
  2. Система проверяет купоны и пересчитывает стоимость курса с учетом скидки по действующим купонам; отображает пользователю цену со скидкой и кнопки перехода к оплате.

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

1.1.2. Сценарий «Оплата по счету»
  1. Пользователь выбирает оплату по счету - «Сформировать счет».
  2. Система выдает пользователю форму с запросом Наименование/ФИО плательщика.
  3. Пользователь вводит Наименование/ФИО плательщика в форму и нажимает «Сформировать счет».
  4. Система формирует извещение-квитанцию в формате PDF.
  5. Пользователь распечатывает квитанцию и оплачивает счет в банке.
  6. Управляющий в «Панели администрирования заявок» может видеть, что пользователь сформировал счет. При поступлении оплаты управляющий вручную изменяет статус заявки на «Оплачено».
  7. Система зачисляет пользователя на курс.

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

1.1.3. Сценарий «Электронная оплата»
  1. Пользователь выбирает способ электронной оплаты - «Перейти на страницу оплаты».
  2. Система отображает форму ввода реквизитов карты, электронного кошелька, оплаты с мобильного и других доступных способов оплаты.
  3. Пользователь вводит реквизиты и производит оплату.
  4. Система электронной оплаты передает данные в СЭО об успешном платеже.
  5. Система зачисляет пользователя на курс.

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

1.1.4. Сценарий «Облачная касса»
  1. Эквайер передает данные о платеже в облачную кассу.
  2. Облачная касса формирует чек и высылает его клиенту.
Для предварительного ознакомления с процессом оплаты можно использовать данные тестовых карт, предоставляемых некоторыми мерчантами, например ЮКасса, СберБанк .

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

1.1.5. Сценарий «Доступ по условию»
  1. Пользователь заходит на страницу описания интересующего его курса.
  2. Система проверяет условия доступа к зачислению.
  3. Если пользователь соответствует условиям, ему становится доступна возможность быть зачисленным на курс.
Сценарий может быть применен как для платного, так и бесплатного доступа к курсу; позволяет сформировать сложную логику условий доступа; дает возможность настраивать видимость условий (описания) доступа в зависимости от соответствия условиям или авторизации пользователя в системе.

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

1.1.6. Сценарий «Заморозка подписки»
  1. Администратор включает в курсе функцию добровольной заморозки и настраивает для нее максимально возможный срок.
  2. У пользователя ограниченная по времени подписка на курс и, по объективным причинам,  он не может некоторое время обучаться на курсе. Пользователь активирует добровольную заморозку на нужный ему период.
  3. Система проверяет, соответствует ли запрашиваемый период заморозки настройкам, и приостанавливает обучение пользователя в курсе.
  4. По окончанию срока заморозки пользователь продолжает свое обучение, время подписки автоматически продлевается на время заморозки.

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

1.2. Возможности настройки внешнего вида

Для привлечения внимания, при отображении платных курсов в Витрине курсов  изображение курса может быть оформлено с помощью дополнительных элементов: стикером с ценой курса; тематической наклейкой (Акция, Скидка, Новинка и т. п.); информацией об уровне сложности; кратким описанием курса и т.п. (Рис. 1.2.1).

Рис. 1.2.1. Фрагмент Витрины курсов.

Отображение способов подписки на курс на странице описания курса будет зависеть от настроек способов оплаты в курсе (Рис. 1.2.2).

Рис. 1.2.2. Пример страницы описания курса с вариантами оплаты.

При настройке, каждый способ оплаты можно снабдить кратким пояснением для пользователя (Рис. 1.2.3).

Рис. 1.2.3. Оформление комментариев к способам оплаты курса.

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

2. Возможности и особенности интеграции

2.1. Общая информация об интернет-оплате

Интернет-эквайринг реализует возможность безналичной оплаты услуг и товаров, предоставляемых на вашем сайте, с помощью банковской карты; электронными деньгами (ЮMoney, WebMoney, Qiwi-кошелёк); через терминалы (Евросеть, Qiwi, Элекснет); а также посредством мобильных платежей через сотовых операторов. Процедура такой оплаты включает несколько последовательных этапов. Например, процесс оплаты картой (Рис. 2.1.1):

1) Пользователь делает покупку в интернет-магазине: выбирает необходимые товары и услуги; отмечает их (перемещает в корзину).

2) Пользователь инициирует процесс оплаты, выбирает вариант оплаты карточкой. Происходит переадресация на страницу провайдера, где покупатель вводит данные карточки.

3) Провайдер формирует запрос и направляет его в банк-эмитент.

4) При успешной обработке запроса проводится авторизация в платежной системе.

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

6) Непосредственно продажа.

7) Банк-эквайр получает клиринговый файл.

8) Выполняется возмещение по операциям в пользу интернет-магазина.

9) Формируется отчет о платеже, а покупатель будет перенаправлен на страницу магазина.

Рис. 2.1.1. Схема электронной оплаты с помощью банковской карты в интернет-магазине.

В описанном процессе принимают участие:

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

Для приема платежей через интернет, продавцу нужно:

  • заключить договор с эквайером;
  • подключить онлайн-кассу (согласно действующей редакции Закона № 54-ФЗ, для торговли через интернет необходимо подключить онлайн-кассу и выписывать чеки).
Онлайн-кассу можно подключить через эквайеров. Каждый эквайер обычно поддерживает определенные виды онлайн-касс.

Важно иметь в виду, что эквайер подключается не к организации вообще, а к конкретному сайту, и  определенные технические требования (см. п. 2.3.2) предъявляет именно к подключаемому ресурсу. Таким образом сайт на момент подключения должен быть активен и соответствовать требованиям эквайера.

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

2.2. Особенности интеграции СЭО 3КL с сервисами платежей

В текущей версии плагина «ОТ Рау» реализована интеграция со следующими эквайерами: Сбер, ЮKassa, Quazkom. Если у вас заключен договор с эквайером, который еще не поддерживается, вы можете обратиться в техническую поддержку ООО «Открытые технологии» на платную доработку плагина.

На интеграцию с новыми системами процессинга платежей действует фиксированный тариф: 32 нормо-часа. Для этого необходимо создать в личном кабинете заявку в категории «Выделенный специалист/Разработчик или сисадмин». Перед началом работ специалисты технической поддержки выполнят проверку API сервиса и возможности реализации интеграции. Это обусловлено тем, что не все сервисы можно интегрировать с системой.

Если окажется, что интеграцию выполнить невозможно, то заявка будет отклонена, а нормо-часы за проверку возможности интеграции списаны не будут.

Некоторые сервисы могут иметь свои готовые плагины интеграции, которые можно поставить бесплатно, через заявку на сторонний плагин. Однако, они не будут покрываться гарантийной техподдержкой и у них отсутствует поддержка тех уникальных возможностей, которые предоставляет плагин ОТ Pay: подписка с регистрацией в одно действие, скидочные купоны, отдельный тариф на продление, временная заморозка по инициативе слушателя и  т. п.

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

2.3. Последовательность действий при интеграции с сервисами платежей

2.3.1. Выбор подходящего вам эквайера
  • ЮKassa (бывшая Яндекс Касса)

Разнообразные способы оплаты. Доступны дополнительные инструменты: автоплатежи, оплата в рассрочку и др. Поддерживает ряд партнерских онлайн-касс. Комиссии от 3,5-6%.

Компания «Яндекс.Деньги» объявила о ребрендинге сервиса с 15 декабря 2020г., изменив наименование на ЮMoney. Платежный сервис для бизнеса Яндекс.Касса теперь называется ЮKassa. В плагине «OT Pay» обновлены платежные протоколы в связи с ребрендингом ЮKassa. После обновления СЭО 3KL все изменения применятся автоматически. Если используется устаревший способ подключения («протокол HTTP» или «старый платежный API»), во время обновления произойдет автозамена в настройке «Адрес сервера для запросов» со старого адреса на новый. В случае использования в этой настройке какого-либо нестандартного решения, необходимо вручную внести изменения так, чтобы в платежных запросах был прописан адрес https://yoomoney.ru/eshop.xml. Рекомендуем выполнить все необходимые настройки в Юkassa и переходить на использование способа подключения «Протокол API».
  • Сбер

Все платежи защищены по международным стандартам. Для разрешения любых вопросов работает круглосуточная служба поддержки. Платежи проводятся через онлайн-кассу, а оплату можно принимать множеством способов. Комиссии от 1,8-2%.

  • Quazkom (Казкоммерцбанк, Казахстан)

Крупнейший в Казахстане коммерческий банк-эквайер. Комиссии от 2,5-4%.

Если удобного для вас эквайера еще нет в перечне доступных — инициируйте процедуру интеграции с ним.

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

2.3.2. Заключение договора с выбранным эквайером

Воспользоваться эквайрингом могут ИП или юридические лица. Для заключения договора с эквайером нужно подать заявку на его сайте (заявку на обратный звонок менеджера), в которой указать базовую информацию: Ф.И.О, контакты и ИНН. Рейтинг интернет-эквайеров можно посмотреть здесь.

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

В процессе заключения договора эквайер проводит проверку вашего ресурса.

  • ЮKassa

Служба безопасности ЮKassa проверяет подключаемые площадки на соответствие ряду требований:

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

Интеграция со Сбербанком проходит проще чем с ЮKassa: обычно не проводится проверка сайта на товары и цены.

Подробная информация о требованиях изложена в  «Требования, предъявляемые к ресурсу магазина».

Кроме этого,  потребуется заполнение технической анкеты API (Рис. 2.3.2.а).

Рис. 2.3.2.а. Пример технической анкеты от ЮKassa.
  • Наименование магазина. То название, которое будет видеть пользователь во время платежа.
  • Адрес сайта. Указывается адрес (URL) ресурса (например, https://moodle.opentechnology.ru).
  • CMS.  Система управления контентом сайта (движок).
  • Адрес для уведомлений. Адрес интеграции, отвечающей на запросы эквайера (https://ваш_сайт_СЭО/enrol/otpay/plugins/yandex/request./notification.php).
  • Email для реестров. Адрес электронной почты, на которую будут приходить реестры платежей.

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

2.3.3. Подключение к облачной кассе

Для соблюдения закона №54-ФЗ при проведении электронных платежей необходимо подключиться к облачной кассе, либо принять решение о формировании чеков вручную (для этого у вас должен дежурить кассир, который будет оперативно формировать и высылать чеки).

Чтобы открыть онлайн кассу, необходимо зарегистрироваться в личном кабинете на сайте поставщика услуги, заполнить данные организации, подписать Договор, оплатить счет, получить номера ККТ и зарегистрировать их в ФНС.

  • ЮKassa

Предоставляет интеграционный сервис с онлайн-кассами:

Оплата по 54-ФЗ для ЮKassa

  • Сбер

Предоставляет свой сервис. Описание услуги и заявка на подключение. Контакты.

Для включения онлайн-кассы в модуле «OT Pay» нужно обратиться в техническую поддержку ООО «Открытые технологии».

СЭО 3КL не отправляет кассовые чеки на почту слушателя, это осуществляют другие сервисы.

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

2.3.4. Передача в техподдержку реквизитов для подключения

Для настройки и активации интеграции, в зависимости от планируемых для использования способов оплаты, в техническую поддержку ООО «Открытые технологии» необходимо передать:

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

Перед активацией необходимо передать в техническую поддержку следующие данные:

  • Для настройки простой оплаты через банк - ваши банковские реквизиты, перечень см. пункт 5.2. Настройки способа генерации формы.
  • Для подписки купоном - схему или описание желаемой купонной программы или отдельного купона (см. пункт 5.6. Настройки панели управления купонами).
  • Для электронной оплаты - реквизиты подключения к эквайеру, информация об онлайн-кассе, системе налогообложения и ставке НДС.

По выбранному эквайеру передается следующая информация:

  • ЮKassa
  1. Адрес сервера для запросов
  2. Идентификатор магазина (shopId)
  3. Пароль магазина (shop password)
  4. Номен витрины (scid)
  5. Интеграция с онлайн-кассой (Нет/Да)
  6. Система налогообложения
  7. Ставка НДС
  8. Поддерживаемые платежные системы
Пример данных, которые сообщает Ю.Kassa пользователю сервиса (их нужно сообщить в нашу техподдержку):
Адрес сервера для запросов - https://money.yandex.ru/eshop.xml
ShopID xxxxxx
Scid xxxxxxx
ShopPassword 123456
Подробная информация по настройке в разделе Настройки способа оплаты Ю.Kassa
  • Сбер
  1. Адрес сервера для запросов
  2. Логин
  3. Пароль*
  4. Период ожидания авторизации платежа от банка
  5. Поддерживаемые платежные системы
* —Обратите внимание, что пара логин/пароль должна быть от учетной записи пользователя API, а не от личного кабинета эквайринга!
Пример технической информации от Сбербанка:
Адреса серверов для Api запросов:
Тестовый сервер - https://3dsec.sberbank.ru/payment/rest/
Боевой сервер - https://securepayments.sberbank.ru
Пример информации для техподдержки ОТ:
Адрес сервера для запросов: тестовый https://3dsec.sberbank.ru ; боевой https://securepayments.sberbank.ru
Логин xxxxx
Пароль xxxxx
Период ожидания авторизации платежа от банка: максимальный срок предавторизации 30 дней
Поддерживаемые платежные системы: мир, visa, master card, jcb
Подробная информация по настройке в разделе Настройки способа оплаты Сбербанк
  • Казкоммерцбанк
  1. URL для авторизации суммы в банке
  2. URL для подтверждения-анулирования авторизации
  3. Серийный номер сертификата
  4. Имя магазина(сайта)
  5. ID продавца в платежной системе
  6. Приватный ключ пользователя
  7. Пароль к приватному ключу пользователя
  8. Публичный ключ банка
  9. Поддерживаемые платежные системы
Подробная информация по настройке в разделе Настройки способа оплаты Казкоммерцбанк

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

2.3.5. Тестирование оплаты из СЭО 3КL

После настройки и активации интеграции проводится проверка корректности оплаты с помощью тествового сервера эсквайера и тестовых карт (например: ЮКасса, СберБанк).

При успешном результате, выпоняется тестирование реальных платежей.

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

3. Часто задаваемые вопросы по интеграции с платежными сервисами

  • ЮKassa

1) Где найти адрес сервера для запросов, пароль магазина и номер витрины для передачи в техническую поддержку?

Адрес сервера для запросов, пароли (в том числе и пароль магазина  shop password) и номера витрины выдаются ЮKassa. Прверьте входящие электронные письма или обратитесь в техподдержку ЮKassa.


2) В процессе заключения договора от ЮКаssа приходят сообщения:
«На сайте https://ваш_сайт(СЭО) нет платных товаров/услуг. Разместите цены и сообщите нам» или
«На сайте нет цен. Необходимо разместить на сайте подробную информацию о своих товарах и услугах (опубликуйте каталог). Сообщите нам, когда всё будет готово».
Как ответить и что делать?

Предоставьте техподдержке ЮKassa ссылку на курс из СЭО 3КL в таком виде, чтобы было видно, что имеется платная услуга. Например, отправьте ссылку на страницу описания курса, где указано, что курс платный (размещена цена).


3) Нам пришло письмо от техподдержки ЮKassa:
«Обращаем Ваше внимание, что для проверки подключаемого сайта нашей службой безопасности необходимо чтобы сайт соответствовал следующим требованиям:
- На сайте обязательно наличие хотя бы одного товара. Если на сайте представлено несколько разделов, обязательно наполнение каждого из разделов хотя бы одним товаром с актуальной информацией и реальной ценой.
- Если на сайте принимается оплата за услуги, то должны быть размещены тарифы и пользовательское соглашение.
- Необходимо указание реквизитов организации и контактных данных.
- Оплата должна производиться на подключаемом сайте, без переадресаций.
Просьба сообщить по факту завершения наполнения сайта».
Что делать и как на него ответить?

В ответном письме ЮKassa необходимо предоставить ссылки на страницы с описаниями платных курсов. В самой же среде электронного обучения в основном меню можно расположить/настроить пользовательское соглашение и прайс-лист (тарифы), в блоке html/подвале/шапке  указать реквизиты организации. Расположить ссылки на эти страницы через элементы док-панели.


  • Сбер

1) Как создать кнопку для оплаты курса, если у нас есть бланк квитанции сбербанка с QR-кодом? Можем ли мы сделать так, чтобы слушатель мог выбрать способ оплаты по QR-коду?

На текущий момент, функционала для квитанции с QR-кодом в плагине «OT Pay» нет. В рамках расширенной технической поддержки за нормочасы мы можем рассмотреть возможность разработки данного функционала.


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

Tags: интеграция, подписка
Average rating: 5 (2 Votes)

You cannot comment on this entry