Приём онлайн-оплаты картой — базовая потребность любого интернет-магазина, и Т-Банк (бывший Тинькофф) — один из самых распространённых эквайеров на российском рынке. Разберём подключение платёжной системы Т-Банка к модулю продаж 1С-Битрикс и типичные ошибки настройки.
Готовый модуль в Маркетплейсе
Для большинства проектов не требуется писать интеграцию с нуля — готовый платёжный модуль Т-Банка доступен через Маркетплейс Битрикса и устанавливается как обычное расширение. После установки модуль появляется в списке доступных платёжных систем в Магазин → Настройки → Платёжные системы.
Настройка платёжной системы
Для подключения потребуются данные, полученные при регистрации в личном кабинете эквайринга Т-Банка: идентификатор терминала и секретный пароль для подписи запросов. Эти значения вводятся в настройках подключённого платёжного модуля — без них модуль установлен, но не сможет реально авторизовать ни один платёж.
Нужна помощь с Битрикс?
Тестовый режим перед боевым запуском
Т-Банк предоставляет тестовый терминал с отдельными реквизитами для проверки интеграции без реальных списаний — обязательный шаг перед переключением на боевые реквизиты: полный цикл оплаты (успешная оплата, отклонённая карта, отмена) стоит пройти на тестовом терминале, а не проверять сразу на реальных деньгах клиентов.
Обработка callback от платёжной системы
После оплаты Т-Банк отправляет уведомление на заданный в настройках URL — обработчик этого уведомления должен корректно проверять подпись запроса перед изменением статуса заказа, иначе злоумышленник теоретически может отправить поддельное уведомление об успешной оплате несуществующего платежа. Готовый модуль из Маркетплейса обычно уже реализует эту проверку — при написании собственной интеграции её пропускать нельзя.
Синхронизация статуса заказа с результатом оплаты
Статус заказа должен меняться именно по callback-уведомлению от платёжной системы, а не по факту возврата покупателя на страницу успеха сайта, — покупатель может закрыть вкладку браузера сразу после оплаты, не дожидаясь редиректа, и в этом случае страница успеха вообще не откроется, хотя платёж прошёл. Callback — единственный надёжный источник подтверждения оплаты, редирект браузера — лишь удобство для пользователя, а не механизм подтверждения.
Автоматический возврат средств из админки
Готовый модуль обычно поддерживает инициацию возврата прямо из карточки заказа в административной панели — без ручного обращения в личный кабинет эквайринга для каждого отдельного возврата. Это заметно ускоряет обработку отмен на проектах с регулярными возвратами по сравнению с ручным процессом через два разных интерфейса.
Комиссия эквайринга и её влияние на бизнес-логику
Комиссия за эквайринг обычно не отражается напрямую в заказе на сайте — она удерживается на стороне платёжной системы при расчётах с магазином. Если бизнес-логике важно учитывать реальную сумму к получению за вычетом комиссии (например, для сверки с бухгалтерией), это требует отдельного расчёта, а не берётся автоматически из данных заказа в Битриксе.
Частые ошибки
- Статус заказа меняется по редиректу, а не по callback. Заказ остаётся неоплаченным при закрытии вкладки после реальной успешной оплаты.
- Переход на боевые реквизиты без полного тестирования. Ошибки интеграции обнаруживаются на реальных платежах клиентов.
- Собственная интеграция без проверки подписи callback. Риск обработки поддельных уведомлений об оплате.
Итог
Подключение Т-Банка к 1С-Битрикс в большинстве случаев сводится к установке готового модуля из Маркетплейса и вводу реквизитов терминала, но требует обязательного тестового прогона перед боевым запуском и понимания, что источник истины для статуса оплаты — callback-уведомление платёжной системы, а не факт возврата покупателя на страницу сайта.