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

Т-Банк

Для использования модуля оплаты Tinkoff зарегистрируйтесь в платёжной системе и настройте модуль на стороне BILLmanager.

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

Maestro,
Mastercard,
Visa,
«Мир»



Google Pay,
Apple Pay

Поддерживаемые возможности
Поддержка ФЗ-54

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

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

Подписки

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

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

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

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

  1. Выбор модуля оплаты: "Т-Банк".
  2. Настройка интеграции. Укажите данные для интеграции.
    Активируйте опцию Создать нового клиента, чтобы отобразить ссылку для регистрации в платёжной системе.
    Заполните форму, используя данные существующего клиента в платёжной системе:
    1. Идентификатор терминала — идентификатор терминала для подключения к API Т-Банк. Данные выдаются при регистрации в платёжной системе;
    2. Пароль терминала — пароль терминала для подключения к API Т-Банк. Данные выдаются при регистрации в платёжной системе;
    3. Использовать адрес уведомлений из личного кабинета терминала — определяет откуда клиентам будет отправлена ссылка при совершении платежей:
      • опция включена — из личного кабинета терминала;
      • опция выключена — из BILLmanager.
    4. Рекуррентные платежи опция включает использование рекуррентных платежей и создание ССО (сохранённых способов оплаты). Рекуррентные платежи в BILLmanager используются для автоматического пополнения лицевого счёта. При настройке автоплатежей со стороны клиента будет автоматически выполнен платёж в 1 рубль. Это необходимо для подтверждения работоспособности банковской карты. По завершении процедуры активации рекуррентного платежа он будет отменен.
      Если флаг активен, то укажите:

      • Страница возврата при успешном автоплатеже — страница, на которую будет перенаправлен плательщик при успешном автоплатеже. Используйте страницу BILLmanager https://domain.com/billmgr?func=payment.recurring.success или произвольную;
      • Страница возврата при неудачном автоплатеже — cтраница, на которую будет перенаправлен плательщик при неудачном автоплатеже. Используйте страницу BILLmanager https://domain.com/billmgr?func=payment.recurring.fail или произвольную;
      • Страница возврата при автоплатеже в обработке — страница, на которую будет перенаправлен плательщик при автоплатеже в обработке. Используйте страницу BILLmanager https://domain.com/billmgr?func=payment.pending или произвольную.

        Пояснения
        Обратите внимание!

        Создание рекуррентных платежей подтверждается только уведомлениями. Если BILLmanager не получил уведомление от Т-Банк, то новые автоплатёж или ССО не будут созданы.

        Уже созданные автоплатежи и ССО будут работать даже без уведомлений.

    5. Система налогообложения — позволяет выбрать используемую систему налогообложения, используется при формировании чеков;
    6. Если у вас подключён модуль Онлайн-кассы, укажите Способ отправки чеков:
      • не отправлять чеки;
      • отправка через онлайн-кассу;
      • отправка чеков платёжной системой.
    7. Разрешить возврат платежей — при включенной опции разрешает возврат платежей.
  3. Настройка метода оплаты. Настройте внутренние (в пределах BILLmanager) параметры метода оплаты. Подробнее см. шаг 3 в статье Настройка методов оплаты.

Дополнительная информация

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

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

Логирование

Логи взаимодействия биллинговой платформы с Т-Банк записываются в файлы:

  • /usr/local/mgr5/var/pmtinkoff.log — лог-файл настройки модуля оплаты, совершения рекуррентных платежей и возвратов, проверки статусов платежей по расписанию;
  • /usr/local/mgr5/var/tinkoffpayment.log — лог-файл оплаты;
  • /usr/local/mgr5/var/tinkoffnotification.log — лог-файл уведомлений;
  • /usr/local/mgr5/var/tinkoffrecurring.log — лог-файл настройки рекуррентных платежей.