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

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

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

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