Интернет-эквайринг Т-Банк приём платежей Про

Модуль ставится кнопкой «Установить» на этой странице или из админки сайта: Настройки → Marketplace → Установить решение, поиском по названию или по коду rover.tinkoff. Дальше решение появляется в Настройки → Marketplace → Установленные решения, оттуда же запускается сама установка.

— Платёжная система. Три варианта:

• Создать новую — обычный случай.
  
• На основе платёжной системы официального модуля приёма платежей Т-Банка — предлагается, только если такая платёжная система на сайте есть. Переносятся идентификатор терминала, пароль и параметры чека, прежняя платёжная система выключается. Её ограничения (по сайту, типу плательщика, сумме) переносятся отдельной галочкой.
  
• Не создавать — если платёжную систему вы завели или заведёте вручную.
  

Новая платёжная система создаётся выключенной: без терминала и пароля она всё равно не примет оплату, а в оформлении заказа покупатель уже видел бы её в списке.

• регистрирует обработчик платёжной системы «Т-Банк» и обработчики событий заказа;
  
• создаёт две свои таблицы: состояние платежей и журнал операций;
  
• копирует три компонента платёжной формы и блок оплаты для Сайтов24;
  
• ставит два фоновых агента: автоподтверждение зарезервированных платежей (раз в час) и очистку устаревших записей журнала (раз в сутки);
  
• заводит почтовое событие и шаблон письма со ссылкой на оплату — для кнопки «Отправить ссылку на оплату» в карточке заказа;
  
• копирует иконки способов оплаты и страницу возврата покупателя на выбранные сайты.
  

• Идентификатор терминала и Пароль — из личного кабинета эквайринга. Без них модуль не обратится к банку вовсе.
  
• Способ оплаты у платёжной системы один, и выбирается он там же, где обработчик: приём платежей по карте, карта во всплывающем виджете, СБП по QR-коду, СБП во всплывающем виджете, T-Pay или T-Pay во всплывающем виджете. Чтобы покупатель выбирал из нескольких способов, заведите по платёжной системе на каждый — в оформлении заказа покупатель увидит их как отдельные варианты оплаты.
  
• Адрес для получения http-нотификаций, Страница успеха и Страница ошибки уже заполнены стандартными путями, менять их не нужно. Адрес уведомлений модуль передаёт банку в каждом платеже, поэтому отдельно прописывать его в личном кабинете не требуется.
  
• Тип оплаты (группа «Статусы и флаги»): одностадийная — списание сразу, двухстадийная — резервирование на карте и списание после подтверждения. Пустое значение оставляет выбор за терминалом: тип оплаты берётся из его настроек в личном кабинете банка. Заполняйте поле, только если нужно переопределить настройку терминала со стороны сайта — например, держать на одном терминале и одностадийную, и двухстадийную оплату.
  
• Чеки. «Система налогообложения» и «НДС» заполняются всегда: по ним модуль собирает данные чека и отправляет их в банк вместе с платежом, а боевой терминал без них вернёт ошибку. Рядом задаются версия ФФД, предмет и способ расчёта, получатель чека и момент отправки закрывающего чека. Если фискализировать через банк не нужно, касса отключается на его стороне, а не пустыми полями здесь.
  
• Чеки кассой самого сайта печатаются по галочке «Разрешить печать чеков» у платёжной системы: по ней ядро Битрикса ставит платёж в очередь своих кассовых чеков. Данные для банка от неё не зависят, поэтому следите, чтобы чек пробивала одна касса: когда работают и касса сайта, и касса банка, в ОФД уходит два чека на один платёж. Об активной кассе сайта модуль предупредит в настройках платёжной системы.
  
• Статусы заказа под каждое событие: резервирование, оплата, частичная оплата, возврат, отмена. Там же — через сколько дней автоматически подтверждать зарезервированный платёж.
  

Когда поля заполнены, включите платёжную систему и проверьте её ограничения: выключенная платёжная система или ограничение по сайту, типу плательщика либо сумме — самая частая причина того, что способ оплаты не появился в оформлении заказа.

Кнопки СБП и T-Pay рисует сам банк, поэтому нужный способ должен быть включён в личном кабинете эквайринга: Магазины → Приём оплаты → Кнопки быстрой оплаты. Выключенный способ банк пропускает молча — ни кнопки, ни ошибки; через три секунды модуль покажет вместо кнопки ссылку «Перейти к оплате»: она ведёт на платёжную форму банка, и оплата не срывается.

Что происходило с платежом, видно на вкладке «Т-Банк» в карточке заказа: пришло ли уведомление от банка и было ли принято, какой статус модуль поставил заказу, подтверждался ли резерв, уходил ли чек.

Если оплата не доходит, журнал обычно сразу показывает причину:

• уведомления отклоняются по подписи — пароль терминала не тот, что в настройках;
  
• уведомлений нет вовсе — адрес /bitrix/tools/sale_ps_result.php закрыт фаерволом, базовой авторизацией или «техническим режимом» сайта;
  
• платежа нет совсем — платёжная система выключена или скрыта ограничением.
  

Для оплаты заказа или отдельного платежа есть ещё два компонента — «Платежная форма Т-Банк (по заказу)» и «Платежная форма Т-Банк (по оплате)». Им нужен модуль «Интернет-магазин»: заказ или платёж они получают его номером в параметрах. Ставить их можно в любое место сайта, а не только в оформление заказа — например, в личный кабинет или на отдельную страницу оплаты, ссылку на которую покупатель получает письмом. На них же собираются собственные нестандартные сценарии: заказ или платёж создаёт ваш код, а форма принимает по нему деньги на той странице, где это нужно.

Настройки → Marketplace → Установленные решения → удалить. На первом шаге стоит галочка «Сохранить данные о платежах»: таблицы с журналом и состоянием платежей остаются на месте. Снимать её стоит осознанно — в них хранится факт отправки закрывающих чеков, и без этих данных после повторной установки чеки могут уйти в ОФД второй раз.

Платёжную систему модуль за собой не убирает, и это сделано нарочно. В ней хранится всё, что настраивалось руками: терминал и пароль, параметры чека, статусы заказа под каждое событие, ограничения. Удаление платёжной системы уносит эти настройки вместе с ней, а оплаты прежних заказов остаются со ссылкой на платёжную систему, которой больше нет, — поэтому модуль, снятый на время или переставляемый заново, их не трогает.

• расширение php-curl;
  
• «Главный модуль» Bitrix 24.0.0 и выше;
  
• PHP 8.2 и выше;
  
• модуль «Интернет-магазин» — для оплаты заказов и платёжной системы. Без него модуль тоже устанавливается и работает как самостоятельная платёжная форма;
  
• модуль «Оповещения об ошибках» — только если нужны оповещения о сбоях; он бесплатный, и без него модуль работает как прежде.
  

telnet securepay.tinkoff.ru 443

Если ресурс недоступен, свяжитесь со своим хостинг-провайдером и попросите открыть его для отправки запросов.