Документация BILLmanager 5
Документация — ваш лучший друг?
Поделитесь мнением и пройдите небольшой опрос
Пройти опрос

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

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

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

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

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

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

Рекуррентные платежи

Подписки*


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

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

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

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

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

    Раздел "Интеграция" в личном кабинете ЮKassa

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

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

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

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

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

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

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

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

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

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

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

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

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

  • для успешного платежа: https://domain.com/billmgr?func=payment.success
  • для неудачного платежа: https://domain.com/billmgr?func=payment.fail
  • для платежей в обработке: https://domain.com/billmgr?func=payment .pending

    Пояснения

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

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

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

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