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

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

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

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

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

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

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


Параметры, необходимые для интеграции с BILLmanager находятся в разделе "Настройки магазина":


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

Send notifications to — адрес взаимодействия с биллинговой системой. Укажите следующий URL-адрес: https://<адрес_BILLmanager>/mancgi/ycresult.

Email for sending registers — электронная почта, на которую будут приходить ежемесячные реестры платежей. 

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

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


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

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

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

  • Номер магазина —  укажите значение из поля ShopId в настройках Яндекс.Касса;
  • Секретный ключ — укажите значение из поля Secret Key в настройках Яндекс.Касса;
  • Рекуррентные платежи — флаг разрешает использование рекуррентных платежей. Если активен, то укажите:
    • Страница возврата при успешном автоплатеже — ссылка для возврата из личного кабинета Яндекс.Кассы после успешной настройки автоплатежа. Используйте страницу 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 — лог-файл получения ответа от платежной системы.