Подключение Тинькофф Оплаты

Тинькофф Оплата (сейчас Т-Банк) — это интернет-эквайринг с приёмом карт, СБП и BNPL через единый платёжный шлюз. В 1С-Битрикс он подключается как обычная платёжная система на базе Merchant API v2, но требует аккуратной работы с терминалом, паролём и подписью запросов. Разберём весь путь: от заявки в банке до боевого чека по 54-ФЗ.

Тинькофф Оплата и чем она отличается от Тинькофф Кассы

В экосистеме банка исторически было несколько продуктов с похожими названиями, и в Битрикс им соответствуют разные обработчики. Важно не перепутать, что именно вы подключаете.

• Тинькофф Оплата (Merchant API) — интернет-эквайринг: покупатель уходит на платёжную страницу банка (или на бесшовную форму), оплачивает картой/СБП/долями, а магазин получает уведомление о статусе. Это то, о чём статья.
• Тинькофф Касса — связка эквайринга с онлайн-кассой (фискализацией) и расширенным набором операций; её настройка вынесена в отдельный материал.

С технической стороны Оплата работает поверх REST-методов Init, GetState, Confirm и Cancel. В Битрикс это оборачивается в стандартный обработчик платёжной системы (сущность bitrix:sale.pay), поэтому заказ, статус оплаты и возвраты живут внутри модуля sale, а не в стороннем интерфейсе.

Что нужно подготовить до настройки

Перед тем как открывать админку Битрикс, соберите доступы. Без них обработчик настроить не получится, а тестировать вслепую — потеря времени.

1. Заключённый договор интернет-эквайринга и открытый терминал в личном кабинете банка.
2. Terminal Key — идентификатор терминала (для боевого и тестового режима они разные).
3. Пароль терминала (Secret / Password) — секрет, которым подписываются запросы. Его нельзя хранить в открытом виде на фронте.
4. Согласованные в ЛК банка адреса нотификаций и редиректов.

Заранее продумайте, какие URL вы отдадите банку. Обычно это три адреса на стороне сайта: страница успеха, страница ошибки и служебный адрес для серверных уведомлений (webhook), на который банк шлёт POST при смене статуса платежа.

Установка обработчика в Битрикс

Есть два рабочих пути, выбор зависит от редакции и того, кто ведёт проект.

Модуль устанавливается штатно через Marketplace → Установленные решения, после чего в списке платёжных систем появляется новый тип обработчика. Собственный обработчик размещается в каталоге /bitrix/php_interface/include/sale_payment/<код>/ (или в /local/php_interface/include/sale_payment/) и состоит минимум из файла шаблона и .description.php с описанием настраиваемых полей. Именно этот PHP-код и будет собирать запрос Init, проверять подпись входящих нотификаций и переводить заказ в статус «оплачен».

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

Основная работа идёт в разделе Магазин → Платёжные системы (в старых сборках — Магазин → Настройки → Платёжные системы). Создаём новую платёжную систему и выбираем обработчик Тинькофф Оплаты.

• Заполняем Terminal Key и Пароль из личного кабинета банка.
• Привязываем платёжную систему к нужным типам плательщиков — например, только к физлицам, если для юрлиц у вас безналичный счёт.
• Проверяем сопоставление валюты: банк принимает сумму в копейках, поэтому обработчик должен умножать рублёвую сумму заказа на 100.
• Указываем адреса SuccessURL, FailURL и адрес нотификаций, совпадающие с тем, что задано в ЛК банка.

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

Фискализация и чек по 54-ФЗ

Если вы работаете по 54-ФЗ, к платежу нужно прикладывать данные чека. В API это объект Receipt внутри запроса Init: там перечисляются позиции заказа, их количество, цена, сумма и налоговая ставка.

• Ставка НДС для каждой позиции: none, vat0, vat10, vat20 и расчётные ставки.
• Признак предмета и способа расчёта — их обычно берут из настроек товара/типа кассы.
• Контакт покупателя — email или телефон, куда уйдёт электронный чек.

В Битрикс ставки НДС берутся из карточки товара и настроек каталога, поэтому перед боем убедитесь, что у всех товаров корректно проставлен НДС. Расхождение суммы позиций и итога заказа (например, из-за скидки на корзину или доставки без отдельной позиции) банк отклонит — итог чека должен точно сходиться с суммой платежа до копейки.

Тестовый режим и диагностика

Банк даёт отдельный тестовый терминал с собственными ключами и тестовыми картами. Сначала прогоняем полный цикл на нём, и только потом подставляем боевые Terminal Key и пароль.

1. Оформляем тестовый заказ и доходим до перехода на платёжную страницу.
2. Оплачиваем тестовой картой, проверяем возврат на SuccessURL и приход нотификации.
3. Смотрим, что заказ в админке перешёл в статус оплаченного, а не завис в «ожидании».

Если оплата не проходит, диагностику ведём по слоям:

• Token is incorrect — ошибка в подписи: неверный набор полей, сортировка или пароль.
• Заказ не оплачивается после успешной оплаты — не доходит нотификация: проверяйте, что webhook-адрес доступен банку снаружи, отдаёт 200 OK и текст OK.
• Смотрим лог обработчика и системный журнал: Магазин → Платёжные системы → Журнал и события в sale.

Итог

Подключение Тинькофф Оплаты в 1С-Битрикс сводится к четырём вещам: правильный терминал и пароль, корректная подпись запросов Init, рабочий webhook для нотификаций и сходящийся по копейкам чек 54-ФЗ. Если каждый из этих слоёв проверен на тестовом терминале, боевой запуск проходит без сюрпризов.

Мы в B2Bsite подключаем и сопровождаем эквайринг Т-Банка на проектах любой сложности — от типовой установки обработчика до нестандартной фискализации и интеграций с 1С и CRM. Если нужен предсказуемый приём платежей без зависших заказов, поможем настроить и передать всё под ключ.