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

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

Модуль "ЮKassa" использует актуальный протокол подключения. Рекомендуем использовать данный модуль всем новым пользователям ЮKassa.

Поддержка способов оплаты
Банковские карты	Наличные	Электронные кошельки	Мобильные платежи	Интернет-банкинг

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

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

Обратите внимание!

№ 54-ФЗ устанавливает требование о наличии в чеке наименований оплаченных товаров и услуг. Чтобы чеки формировались корректно в соответствии с законом, вы должны установить модуль Онлайн-кассы.

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

Для настройки ЮKassa:

Войдите в личный кабинет или зарегистрируйтесь на сайте ЮKassa. Подробнее о регистрации см. документацию ЮKassa.
В личном кабинете перейдите в раздел Интеграция → Готовые решения.

Раздел "Интеграция" в личном кабинете ЮKassa
Обратите внимание!
Чтобы в указанном выше разделе можно было выбрать интеграцию с BILLmanager, нужно в разделе Договор → Приём платежей указать адрес BILLmanager.
Выберите из списка "Ваша система" — BILLmanager и нажмите Сохранить.

Выбор платёжного модуля BILLmanager на стороне ЮKassa

Параметры, необходимые для интеграции с BILLmanager, появятся в личном кабинете:

в разделе Настройки → Магазин — shopId;
в разделе Интеграция → Ключи API — secret key.

ShopId — уникальный номер магазина в системе ЮKassa. Используется для настройки интеграции на стороне BILLmanager.

Secret key — секретный ключ магазина. Используется для настройки интеграции на стороне BILLmanager.

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

Обратите внимание!

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

Чтобы настроить рекуррентные платежи в ЮKassa, вам необходимо:

В Личном кабинете написать сообщение менеджеру ЮKassa. Для этого нажмите на иконку оператора в правом верхнем углу.
В разделе Решение проблем напишите сообщение. Например: "Хочу подключить рекуррентные платежи. Как это сделать?"
Ответ от менеджера ЮKassa с инструкциями для дальнейших действий придёт к вам на почту.

Возможные инструкции от ЮKassa

Настройка на стороне BILLmanager

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

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

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

Настройка платёжного модуля на стороне BILLmanager

Номер магазина — укажите значение из поля ShopId в настройках ЮKassa;
Секретный ключ — укажите значение из поля Secret Key в настройках ЮKassa;
Способ оплаты — выберите один или несколько способов оплаты, доступных для данного платёжного модуля;
Рекуррентные платежи — флаг разрешает использование рекуррентных платежей. Рекуррентные платежи в BILLmanager используются для автоматического пополнения лицевого счёта и для создания подписок. Если флаг активен, то укажите:
- Страница возврата при успешном автоплатеже — ссылка для возврата из личного кабинета ЮKassa после успешной настройки автоплатежа. Используйте страницу BILLmanager https://domain.com/billmgr?func=payment.recurring.success или произвольную;
- Страница возврата при неудачном автоплатеже — ссылка для возврата из личного кабинета ЮKassa после неудачной настройки автоплатежа. Используйте страницу BILLmanager https://domain.com/billmgr?func=payment.recurring.fail или произвольную;
- Страница возврата при автоплатеже в обработке — ссылка для возврата из личного кабинета ЮKassa, если настройка автоплатежа находится в обработке. Используйте страницу BILLmanager https://domain.com/billmgr?func=payment.pending или произвольную.
  Пояснения
  domain.com — домен или публичный IP-адрес сервера с BILLmanager.

Обратите внимание!

Для оплаты обязательна отправка чеков. Перейдите в Провайдер → Методы оплаты → Изменить → блок настроек Отправка чеков онлайн и выберите Способ отправки чеков "Отправка чеков платёжной системой".

Перенаправление после оплаты

Метод оплаты поддерживает функцию для перенаправления клиента после оплаты на произвольную страницу. Используйте разные страницы в зависимости от успешности платежа. Например, страницы BILLmanager:

для успешного платежа: https://domain.com/billmgr?func=payment.success
для неудачного платежа: https://domain.com/billmgr?func=payment.fail
для платежей в обработке: https://domain.com/billmgr?func=payment .pending
Пояснения
domain.com — домен или публичный IP-адрес сервера с BILLmanager.

Чтобы указать страницы возврата при создании метода оплаты, дойдите до третьего шага и заполните поля Страница возврата при успешном платеже, Страница возврата при неудачном платеже и Страница возврата при платеже в обработке. Также вы можете указать их после создания метода оплаты в Провайдер → Методы оплаты → Изменить → блок Настройки.

Возврат платежей

Чтобы разрешить возврат платежей:

Завершите создание метода оплаты.
Перейдите в Провайдер → Методы оплаты → Изменить → блок Возврат и отмена платежей.
Включите опцию Разрешить возврат платежей и нажмите Ok, чтобы сохранить настройки.

Логирование

Логи взаимодействия биллинговой системы с ЮKassa записываются в файлы:

/usr/local/mgr5/var/pmyandexcheckout.log — лог-файл настройки модуля оплаты;
/usr/local/mgr5/var/ycpayment.log — лог-файл оплаты;
/usr/local/mgr5/var/ycrecurring.log — лог-файл настройки рекуррентных платежей;
/usr/local/mgr5/var/ycresult.log — лог-файл получения ответа от платежной системы.