Документация BILLmanager 6

ЮKassa (Неактуальный протокол)

Для использования модуля оплаты ЮKassa необходимо выполнить настройки на стороне платежной системы и подключить модуль в BILLmanager.

Модуль "ЮKassa (Протокол приёма платежей)" использует неактуальный протокол подключения. Данный модуль предназначен для пользователей ЮKassa, которые были зарегистрированы до появления нового протокола подключения. 

Поддержка способов оплаты
Банковские картыНаличныеЭлектронные кошелькиМобильные платежиИнтернет-банкинг
JCB,
Maestro,
Mastercard,
Visa,
Мир.
Терминалы,
банкоматы,
кассы банка,
системы приёма платежей.
MasterPass,
WebMoney,
ЮMoney.
Билайн,
МТС,
Мегафон,
Теле2.
Альфа-Клик,
Промсвязьбанк,
Сбербанк Онлайн.
Поддерживаемые возможности
Поддержка ФЗ-54

Возврат платежей

Рекуррентные платежи

Подписки*

* — чтобы ваши клиенты могли создавать подписки, при настройке интеграции с этим методом оплаты, в качестве способа оплаты выбирайте ЮMoney. Для других способов оплаты подписки не будут работать.

Обратите внимание!
Установка модуля производится из последней доступной версии продукта и влечёт за собой обновление платформы BILLmanager, так как версия модуля не может быть выше версии платформы.

Настройка на стороне платежной системы

В личном кабинете системы ЮKassa в раздел «Настройки» необходимо указать данные для интеграции:


  • Check URL — адрес взаимодействия с биллинговой платформой. Необходимо указать URL: https://<адрес_BILLmanager>/mancgi/ymcheck
  • Aviso URL — адрес взаимодействия с биллинговой платформой. Необходимо указать URL: https://<адрес_BILLmanager>/mancgi/ymresult.
  • Success URL — адрес взаимодействия с биллинговой платформой. Необходимо указать URL: https://<адрес_BILLmanager>/mancgi/ymsuccess.
  • Fail URL — адрес взаимодействия с биллинговой платформой. Необходимо указать URL: https://<адрес_BILLmanager>/mancgi/ymfail.
  • Email для отправки реестров — адрес, на который будут приходить ежемесячные реестры платежей.
  • ShopPassword — пароль магазина. Необходимо задать случайную последовательность символов длиною в 20 символов. 

После выполнения настроек необходимо нажать Сохранить, затем Отправить. Настройки будут проверяться специалистами ЮKassa. Если они верны, то выдаются Shop ID и scid, которые необходимы для настройки на стороне BILLmanager.

Настройка на стороне BILLmanager

Обратите внимание!
Установка модуля производится из последней доступной версии продукта и влечёт за собой обновление платформы BILLmanager, так как версия модуля не может быть выше версии платформы.

Чтобы создать модуль оплаты, перейдите в раздел ПровайдерМетоды оплаты → кнопка Создать. Мастер подключения модуля оплаты состоит из следующих шагов:

  1. Выбор модуля оплаты: "ЮKassa".
  2. Настройка интеграции. Укажите данные для интеграции.
    Активируйте опцию Создать нового клиента, чтобы отобразить ссылку для регистрации в платёжной системе.
    Заполните форму, используя данные существующего клиента в платёжной системе:
    1. Название магазина — название магазина или сервиса.
    2. Номер магазина —  в качестве номера магазина указывается значение Shop ID. 
    3. Номер витрины магазина — в качестве витрины магазина указывается значение scid.
    4. Секретный ключ — в качестве секретного ключа указывается значение ShopPassword.
    5. Способ оплаты — поддерживаемые способы оплаты. Допускается отметить флагами те способы оплаты, что указаны в договоре с ЮMoney. 
    6. Версия протокола — версия используемого протокола подключения. Зависит от срока давности регистрации в системе ЮMoney.
    7. Тестовый режим — при включении флага, оплата будет проводиться в тестовом режиме.
    8. Рекуррентные платежи — флаг разрешает использование рекуррентных платежей. Рекуррентные платежи в BILLmanager используются для автоматического пополнения лицевого счёта и для создания подписок.
    9. Разрешить возврат платежей — флаг разрешает возврат платежей.
  3. Настройка метода оплаты. Настройте внутренние (в пределах BILLmanager) параметры метода оплаты. Подробнее см. шаг 3 в статье Настройка методов оплаты.

Настройка рекуррентных платежей

Для использования рекуррентных платежей необходимо зарегистрировать ресурс на сайте ЮMoney. Для этого следует перейти по ссылке, после чего нажать "Вернуться на сервис" и заполнить форму:

  • Название – название магазина. Название будет видно пользователю.
  • Адрес сайта – сайт, на котором будут приниматься платежи.
  • Email для связи – электронный адрес для отправки уведомлений от системы ЮMoney.
  • Redirect URI – адрес взаимодействия с биллинговой платформой. Необходимо указать URL адрес: https://<адрес_BILLmanager>/mancgi/ymrecurringresult.
  • Логотип — позволяет загрузить логотип сервиса.  
  • Использовать проверку подлинности приложения — флаг должен быть отмечен.

После заполнения данных, необходимо нажать кнопку "Подтвердить". Сайт сгенерирует "ID" (идентификатор приложения) и «Секретное слово». Эти данные необходимо указать в настройках метода оплаты на стороне BILLmanager:

Настройка возврата платежей

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

  • Путь к файлу сертификата, Путь к файлу ключа, Путь к файлу корневого сертификата, Пароль к файлу сертификата — файлы сертификата безопасности. 
  • URL — адрес сервиса возврата платежей: https://penelope.yamoney.ru/webservice/mws/api/returnPayment.
  • IP биллинга — IP-адрес, с которого BILLmanager будет отправлять запросы платежной системе.

Логирование

Логи взаимодействия биллинговой платформы с ЮMoney записываются в файлы:

  • /usr/local/mgr5/var/pmyandexmoney.log — лог файл настройки модуля оплаты;
  • /usr/local/mgr5/var/ympayment.log — лог файл оплаты;
  • /usr/local/mgr5/var/ymresult.log — лог файл получения ответа от платежной системы.