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