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

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

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

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

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

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

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

Установка модуля производится из последней доступной версии продукта и влечёт за собой обновление платформы BILLmanager, так как версия модуля не может быть выше версии платформы.

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

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

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

2. В личном кабинете перейдите в раздел Интеграция → Готовые решения.
   

   

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

   Чтобы в указанном выше разделе можно было выбрать интеграцию с BILLmanager, нужно в разделе Договор → Приём платежей указать адрес BILLmanager.

3. Выберите из списка "Ваша система" — BILLmanager и нажмите Сохранить.
   

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

• в разделе Настройки → Магазин — shopId:
  • ShopId — уникальный номер магазина в системе ЮKassa. Используется для настройки интеграции на стороне BILLmanager.
• в разделе Интеграция → Ключи API — secret key:
  • Secret key — секретный ключ магазина. Используется для настройки интеграции на стороне BILLmanager.

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

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

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

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

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

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

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

Установка модуля производится из последней доступной версии продукта и влечёт за собой обновление платформы BILLmanager, так как версия модуля не может быть выше версии платформы.

Чтобы создать модуль оплаты, перейдите в раздел Провайдер → Методы оплаты → кнопка Создать:

1. Выбор модуля оплаты: "ЮKassa".
2. Настройка интеграции. Укажите данные для интеграции.
   Активируйте опцию Создать нового клиента, чтобы отобразить ссылку для регистрации в платёжной системе.
   Заполните форму, используя данные существующего клиента в платёжной системе:

   1. Номер магазина — укажите значение из поля ShopId в настройках ЮKassa;

   2. Секретный ключ — укажите значение из поля Secret Key в настройках ЮKassa;

   3. Способ оплаты — выберите один или несколько способов оплаты, доступных для данного платёжного модуля;

   4. Рекуррентные платежи — флаг разрешает использование рекуррентных платежей. Рекуррентные платежи в 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.

3. Настройка метода оплаты. Настройте внутренние (в пределах BILLmanager) параметры метода оплаты. Подробнее см. шаг 3 в статье Настройка методов оплаты.

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

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

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

Метод оплаты поддерживает функцию для перенаправления клиента после оплаты на произвольную страницу. Используйте разные страницы в зависимости от успешности платежа. Например, страницы 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.

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

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

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

1. Завершите создание метода оплаты.
2. Перейдите в Провайдер → Методы оплаты → Изменить → блок Возврат и отмена платежей.
3. Включите опцию Разрешить возврат платежей и нажмите 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 — лог-файл получения ответа от платежной системы.