Документация BILLmanager 6
Режим фокусировки

Т-Банк

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

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

Maestro,
Mastercard,
Visa,
«Мир»



Google Pay,
Apple Pay

Поддерживаемые возможности
Поддержка чеков

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

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

Подписки

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

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

При установке модуля платформа будет обновлена до последней версии. Это происходит из-за того, что модуль устанавливается из последней версии продукта, а версия платформы не может быть ниже версии модуля. Перед установкой модуля рекомендуем создать резервную копию платформы.




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

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

      • Страница возврата при успешном автоплатеже — страница, на которую будет перенаправлен плательщик при успешном cписании средств. Используйте страницу 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  или задайте иной адрес.

        Создание рекуррентных платежей подтверждается только уведомлениями. Если 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 — лог-файл настройки рекуррентных платежей.