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