Для использования модуля оплаты ЮKassa необходимо выполнить настройки на стороне платежной системы и подключить модуль в BILLmanager.
Модуль "ЮKassa (Протокол приёма платежей)" использует неактуальный протокол подключения. Данный модуль предназначен для пользователей ЮKassa, которые были зарегистрированы до появления нового протокола подключения.
| Поддержка способов оплаты | ||||
|---|---|---|---|---|
| Банковские карты | Наличные | Электронные кошельки | Мобильные платежи | Интернет-банкинг |
 | | | | |
| JCB, Maestro, Mastercard, Visa, Мир. | Терминалы, банкоматы, кассы банка, системы приёма платежей. | MasterPass, 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
Чтобы создать модуль оплаты, перейдите в раздел Провайдер → Методы оплаты → кнопка Создать. Мастер подключения модуля оплаты состоит из следующих шагов:
- Выбор модуля оплаты: "ЮKassa".
- Настройка интеграции. Укажите данные для интеграции.
Активируйте опцию Создать нового клиента, чтобы отобразить ссылку для регистрации в платёжной системе.
Заполните форму, используя данные существующего клиента в платёжной системе:- Название магазина — название магазина или сервиса.
- Номер магазина — в качестве номера магазина указывается значение Shop ID.
- Номер витрины магазина — в качестве витрины магазина указывается значение scid.
- Секретный ключ — в качестве секретного ключа указывается значение ShopPassword.
- Способ оплаты — поддерживаемые способы оплаты. Допускается отметить флагами те способы оплаты, что указаны в договоре с ЮMoney.
- Версия протокола — версия используемого протокола подключения. Зависит от срока давности регистрации в системе ЮMoney.
- Тестовый режим — при включении флага, оплата будет проводиться в тестовом режиме.
- Рекуррентные платежи — флаг разрешает использование рекуррентных платежей. Рекуррентные платежи в BILLmanager используются для автоматического пополнения лицевого счёта и для создания подписок.
- Разрешить возврат платежей — флаг разрешает возврат платежей.
- Настройка метода оплаты. Настройте внутренние (в пределах 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 — лог файл получения ответа от платежной системы.