Документация BILLmanager

Яндекс.Касса (Актуальный протокол)

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

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

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

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

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

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

Подписки*

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

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

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

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


Для настройки Яндекс.Кассы:

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

    Раздел "Интеграция" в личном кабинете Яндекс.Кассы

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

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

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

    Выбор платёжного модуля BILLmanager на стороне Яндекс.Кассы

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

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

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

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

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


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

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

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

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


  • Номер магазина — укажите значение из поля ShopId в настройках Яндекс.Касса;
  • Секретный ключ — укажите значение из поля Secret Key в настройках Яндекс.Касса;
  • Способ оплаты — выберите один или несколько способов оплаты, доступных для данного платёжного модуля;
  • Рекуррентные платежи — флаг разрешает использование рекуррентных платежей. Рекуррентные платежи в BILLmanager используются для автоматического пополнения лицевого счёта и для создания подписок. Если флаг активен, то укажите:
    • Страница возврата при успешном автоплатеже — ссылка для возврата из личного кабинета Яндекс.Кассы после успешной настройки автоплатежа. Используйте страницу BILLmanager https://domain.com/billmgr?func=payment.recurring.success или произвольную;
    • Страница возврата при неудачном автоплатеже — ссылка для возврата из личного кабинета Яндекс.Кассы после неудачной настройки автоплатежа. Используйте страницу BILLmanager https://domain.com/billmgr?func=payment.recurring.fail или произвольную;
    • Страница возврата при автоплатеже в обработке — ссылка для возврата из личного кабинета Яндекс.Кассы если настройка автоплатежа находится в обработке. Используйте страницу 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.

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

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

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

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

Логирование


Логи взаимодействия биллинговой системы с Яндекс.Касса записываются в файлы:

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