Подключение Тинькофф Кассы (эквайринг)

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

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

В Битриксе исторически встречаются два обработчика: «Тинькофф Оплата» и «Тинькофф Касса». Разница не в бренде, а в наборе задач. «Оплата» — это про перенаправление покупателя на платёжную форму и приём денег. «Касса» дополнительно закрывает требования 54-ФЗ: вместе с эквайрингом Т-Касса пробивает фискальный чек через встроенную облачную ККТ и передаёт его в ОФД.

Технически это один и тот же протокол Т-Кассы (бывш. Tinkoff Acquiring API), но при подключении кассы вы дополнительно передаёте в запрос состав заказа: наименования позиций, цены, количество, ставку НДС и признак способа/предмета расчёта. Без этих данных фискальный чек сформировать нельзя.

• Нужен только приём карт, а чеки бьёт ваша 1С или отдельная касса — хватит обработчика оплаты.
• Нужен приём карт и чек «под ключ» от Тинькофф — подключаете Тинькофф Кассу с фискализацией.

Что подготовить до настройки в Битриксе

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

1. Активированный интернет-эквайринг и подключённая онлайн-касса в кабинете Тинькофф.
2. Terminal Key (идентификатор терминала) и Пароль (Secret/Password) терминала — их вы внесёте в настройки платёжной системы Битрикса.
3. Согласованная ставка НДС и система налогообложения (ОСН, УСН доход, УСН доход-расход и т. д.) — от этого зависит, какой признак ставки уйдёт в чек.
4. Домен магазина, добавленный в белый список терминала, и рабочий HTTPS.

Создание платёжной системы в 1С-Битрикс

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

Если в списке обработчиков нет актуальной «Тинькофф Кассы», обновите модуль sale и коммерческие обработчики через Marketplace → Обновление решений, либо установите официальный модуль эквайринга из Маркетплейса. Обработчик представляет собой файл-хендлер в каталоге /bitrix/modules/sale/handlers/paysystem/ (или в /local/..., если ставится отдельным решением).

При создании обязательно задайте:

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

Заполнение параметров обработчика

После выбора обработчика открывается блок настроек. Ключевые поля привязываются к профилю оплаты — их можно задать константой или связать со свойством заказа.

Отдельный блок — фискализация. Здесь выбираете систему налогообложения и ставку НДС по умолчанию (например, vat20, none для УСН). Битрикс подставит эти значения в объект Receipt, который уходит вместе с запросом Init. Если у товаров в каталоге заданы свои ставки НДС, они имеют приоритет над значением по умолчанию.

Фискализация чеков и связь со статусами заказа

Логика такая: покупатель на странице заказа выбирает Тинькофф Кассу и нажимает «Оплатить». Битрикс формирует запрос Init с суммой и составом чека и перенаправляет клиента на платёжную форму Т-Кассы. После успешной оплаты банк сам пробивает фискальный чек через облачную кассу и отправляет его в ОФД, а покупателю — на e-mail или телефон.

Результат банк возвращает магазину двумя путями:

• Notification (webhook) — серверный запрос от Т-Кассы на URL вашего обработчика. Именно он переводит заказ в статус «оплачен», а не возврат покупателя на сайт.
• SuccessURL / FailURL — страницы, куда возвращается покупатель после оплаты или отказа.

URL для нотификаций указывается в настройках терминала в кабинете Тинькофф и должен вести на обработчик оплаты Битрикса (страница результата платёжной системы). Если notification не настроен или закрыт файрволом, деньги спишутся, а заказ на сайте останется неоплаченным.

Тестирование и запуск в бой

Перед боевым приёмом обязательно прогоните оплату в тестовом режиме. Включите «Тестовый режим» в настройках платёжной системы и используйте тестовый терминал и тестовые карты из документации Тинькофф.

1. Оформите заказ на сайте и дойдите до оплаты — проверьте, что открывается платёжная форма с правильной суммой.
2. Проведите тестовую оплату и убедитесь, что пришёл webhook и заказ в админке стал оплаченным.
3. Проверьте сформированный чек в тестовом кабинете: состав позиций, ставки НДС, признак расчёта.
4. Отдельно протестируйте возврат — Т-Касса поддерживает полный и частичный возврат по API, при котором пробивается чек возврата.

Диагностику ошибок ведите по журналу: Магазин → ... → Журнал и /bitrix/php_interface/log при включённом логировании обработчика. В ответах API смотрите поля ErrorCode и Message — по ним ясно, проблема в подписи, сумме чека или закрытом терминале.

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

Итог

Тинькофф Касса закрывает сразу две задачи магазина на 1С-Битрикс: интернет-эквайринг и фискализацию по 54-ФЗ без отдельной ККТ и договора с ОФД. Ключевые точки, где чаще всего ломается интеграция, — это подпись запроса (Terminal Key + пароль), настроенный webhook-нотификаций и точное совпадение состава чека с суммой платежа вместе с корректными ставками НДС и признаками расчёта.

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