Интеграция WooCommerce и Т‑Банка: подключение эквайринга пошагово

Интеграцию WooCommerce и Т‑Банка я настраивал на нескольких магазинах на WordPress, и путь от заявки на подключение до боевого платежа обычно укладывается в один-два рабочих дня, если заранее собраны нужные документы и доступы. Ниже раскладываю все шаги по порядку: регистрация терминала, установка плагина, вебхуки, тестовый платёж и ошибки, на которых магазины спотыкаются чаще всего.

Что нужно до старта интеграции WooCommerce и Т‑Банка

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

• ИП или ООО с открытым расчётным счётом
• Домен с действующим SSL-сертификатом - без https терминал не активируют
• WooCommerce версии не старше пары релизов и обновлённый WordPress
• Страницы оферты, политики возврата и реальных контактов на сайте - банк проверяет их перед подключением
• Онлайн-касса для чеков по 54-ФЗ: свой сервис фискализации Т‑Банка либо стороннее решение вроде АТОЛ Онлайн
• Доступ администратора в WP-admin и личный кабинет Т‑Бизнес

Отдельно уточняю у клиента, нужен ли приём по СБП - в WooCommerce он включается тем же плагином, но иногда требует отдельного заявления в банке.

Регистрация терминала эквайринга в Т‑Банке для интернет-магазина

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

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

Установка и настройка плагина Т‑Банка в WooCommerce

Плагин «Т‑Банк эквайринг» ставлю двумя способами: ищу в каталоге плагинов WordPress по названию банка или загружаю zip-архив, который лежит в личном кабинете рядом с ключами терминала. После активации иду в WooCommerce - Настройки - Платежи - Т‑Банк и заполняю:

• TerminalKey и пароль терминала из личного кабинета
• способы оплаты: карта, СБП, сохранённые карты
• соответствие статусов заказа - обычно успешный платёж переводит заказ в «Обрабатывается», а не сразу в «Выполнен»
• URL для уведомлений об оплате (Notification URL) - его прописываю и в плагине, и в кабинете банка

Если магазину помимо самой оплаты нужна автоматика вокруг заказа, например отправка данных в CRM или уведомление в Telegram сразу после списания денег, добавляю хук на смену статуса заказа и дергаю оттуда вебхук n8n:

add_action( 'woocommerce_order_status_changed', function( $order_id, $from, $to ) {
    if ( $to !== 'processing' ) {
        return;
    }
    $order = wc_get_order( $order_id );
    if ( $order->get_payment_method() !== 'tbank' ) {
        return;
    }
    wp_remote_post( 'https://n8n.example.ru/webhook/tbank-paid', array(
        'body'    => wp_json_encode( array(
            'order_id' => $order_id,
            'total'    => $order->get_total(),
            'email'    => $order->get_billing_email(),
        ) ),
        'headers' => array( 'Content-Type' => 'application/json' ),
    ) );
}, 10, 3 );

Такой сценарий закрывает частый запрос: менеджеру нужно видеть оплаченный заказ в мессенджере сразу, а не когда он зайдёт в админку WooCommerce.

Настройка вебхуков и уведомлений об оплате

Notification URL - самое частое место, где интеграция ломается уже после запуска. Банк дергает этот адрес после каждой попытки оплаты, и если сайт ответит не 200 OK или закроет доступ капчей от бота, статус заказа не обновится, даже если деньги списались. Проверяю три вещи:

• адрес доступен без авторизации и без htaccess-защиты - открываю его из другой сети, не из офиса
• плагины безопасности вроде Wordfence и кеширующие плагины не блокируют и не кешируют wc-api эндпоинт
• ответ приходит быстро, без редиректов на https или на www-версию домена

Перед запуском в кабинете Т‑Банка есть кнопка отправки тестового уведомления - ей проверяю связку до первого реального платежа. Логи прихода уведомлений смотрю в WooCommerce - Статус - Журналы, там плагин банка обычно пишет и запрос, и ответ сайта.

Тестовый платёж и запуск в боевой режим

После проверки на тестовом терминале меняю TerminalKey и пароль на боевые и делаю реальный платёж на минимальную сумму - 10 рублей достаточно. Смотрю на три вещи: заказ поменял статус автоматически, деньги отобразились в личном кабинете банка (зачисление на счёт обычно на следующий рабочий день), чек по 54-ФЗ ушёл покупателю на почту или в СМС.

Из ошибок, с которыми сталкивался чаще всего:

• неверная подпись запроса из-за опечатки в пароле терминала - плагин просто не пропускает платёж дальше страницы оплаты
• SSL-сертификат просрочен или выпущен для www-версии домена, а сайт открывается без www
• заказ висит в статусе «Ожидает оплаты», потому что кеширующий плагин отдаёт старую версию страницы вместо ответа от вебхука
• тестовые ключи забыли поменять на боевые, и деньги с реальных карт не списываются

Сравнение подключения эквайринга Т‑Банка с другими способами оплаты в WooCommerce

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

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

Если помимо самого эквайринга нужно завязать в один поток расчёт доставки СДЭК, синхронизацию остатков с 1С или доработку логики статусов заказов под конкретный магазин, такие вещи я беру как отдельный проект по доработке интернет-магазина - обвязка вокруг эквайринга почти всегда требует индивидуальной настройки под бизнес-процессы конкретного магазина.

Частые вопросы

Сколько стоит подключение эквайринга Т‑Банка к WooCommerce?

Сам плагин и подключение терминала бесплатны, банк берёт только комиссию с оборота. Платной может быть только работа по настройке: если нужна не просто установка плагина, а связка эквайринга с CRM, СДЭК и логикой статусов заказов, такая комплексная интеграция у меня идёт от 40 000 ₽.

Какая комиссия у Т‑Банка за приём платежей в интернет-магазине?

По открытым тарифам эквайринга комиссия обычно укладывается в 1,5-2,7% с оборота в зависимости от категории магазина и месячного оборота. Точную ставку банк называет после проверки сайта и подписания договора, это не фиксированная цифра для всех.

Нужна ли отдельная онлайн-касса при подключении Т‑Банка к WooCommerce?

Да, приём оплаты картой или через СБП требует фискального чека по 54-ФЗ. Т‑Банк предлагает свой сервис фискализации, либо чек можно пробивать через стороннее решение вроде АТОЛ Онлайн - без этого шага платёж формально проведён с нарушением.

Что делать, если после оплаты заказ не меняет статус в WooCommerce?

Проверяю доступность Notification URL из внешней сети curl-запросом, смотрю логи в WooCommerce - Статус - Журналы на предмет ответа сайта банку, и отключаю по очереди кеширующий плагин и плагин безопасности - именно они чаще всего блокируют вебхук банка.