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

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

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

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

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


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

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

В личном кабинете системы Ю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

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

  • Шаг 1 — Выбор метода оплаты. В качестве метода оплаты необходимо выбрать "ЮKassa".
  • Шаг 2 — Настройка интеграции. Ввод информации, необходимой для интеграции с платежной системой.
  • Шаг 3 — Настройка метода оплаты. Настройка внутренних (в пределах BILLmanager) параметров метода оплаты.

Настройка интеграции

Название магазина — название магазина или сервиса.

Номер магазина —  в качестве номера магазина указывается значение Shop ID. 

Номер витрины магазина — в качестве витрины магазина указывается значение scid.

Секретный ключ — в качестве секретного ключа указывается значение ShopPassword.

Способ оплаты — поддерживаемые способы оплаты. Допускается отметить флагами те способы оплаты, что указаны в договоре с ЮMoney. 

Версия протокола — версия используемого протокола подключения. Зависит от срока давности регистрации в системе ЮMoney.

Тестовый режим — при включении флага, оплата будет проводиться в тестовом режиме.

Рекуррентные платежи — флаг разрешает использование рекуррентных платежей. Рекуррентные платежи в BILLmanager используются для автоматического пополнения лицевого счёта и для создания подписок.

Разрешить возврат платежей — флаг разрешает возврат платежей.  

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

Для использования рекуррентных платежей необходимо зарегистрировать ресурс на сайте Ю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 — лог файл получения ответа от платежной системы.