Настройка плагина Рассрочки и кредиты от Т-Банк

Плагин добавляет в чекаут WooCommerce метод оплаты «Кредит/Рассрочка от Т-Банка»: покупатель отправляет анкету в Т-Банк прямо с сайта, банк одобряет заявку и переводит магазину сумму заказа целиком, а покупатель потом платит банку частями.

Перейти на страницу плагина

Требования #

• WordPress 5.9+, WooCommerce 5.6+, PHP 7.4+
• Сайт по HTTPS — без SSL Т-Банк не отправляет вебхуки со статусами заявок
• Юридическое лицо в России (ИП или ООО) без блокировок
• Активная лицензия плагина в разделе «Woodev → Лицензии»

Подготовка #

До установки и настройки плагина нужно подключить услугу «Т-Рассрочка» на стороне банка:

1. Откройте личный кабинет руководителя.
2. В разделе «Магазины» → «Настройки API» возьмите три значения: shopId (идентификатор магазина), showcaseId (идентификатор витрины) и пароль API.

Если кабинета ещё нет — пройдите регистрацию юридического лица. Напишите персональному менеджеру Т-Банка с просьбой согласовать витрину под услугу «Т-Рассрочка». Согласование обычно занимает 1–3 рабочих дня.

Настройка #

Страница настроек: WooCommerce → Настройки → Платежи → Т-Банк — Рассрочки и кредиты.

На странице доступны опции:

• Режим работы — «Боевой» или «Тестовый». В тестовом плагин обращается к демо-витрине Т-Банка (к showcaseId добавляется префикс demo-), в чекауте появляются дополнительные поля для выбора демо-сценария — без реальных заявок в банк.
• Идентификатор магазина (shopId) — значение из «Магазины» → «Настройки API» в кабинете Т-Банка.
• Идентификатор витрины (showcaseId) — значение оттуда же. Если витрин несколько — берите ту, что привязана к домену именно этого магазина.
• Пароль API — нужен для проверки статусов заявок. Без него блок «Информация о кредите» в карточке заказа после одобрения останется пустым.
• Период охлаждения — учитывать ли паузу после подписания договора покупателем перед финальной выдачей кредита Т-Банком. Включается, если такая пауза действует в условиях вашей витрины.
• Текст на кнопке — надпись на кнопке оформления заявки. По умолчанию «Оформить заявку в Т-Банк».
• Промокод — несколько кодов одновременно (например, «Рассрочка 0/0/24» и «Кредит 12 мес.»). Покупатель выбирает вариант в чекауте перед отправкой заявки.
• Информация на странице товара — текст информера над кнопкой «Купить». Поддерживается шаблонный тег %payment_amount% — минимальный месячный платёж, рассчитывается как цена / 19. Показывается только для товаров от 3000 ₽.

Краткое описание базовой настройки #

1. Поставьте галочку «Включить/Отключить».
2. Выберите «Тестовый режим» для первого прогона.
3. Впишите shopId, showcaseId и пароль API из кабинета Т-Банка.
4. Сохраните настройки и сделайте тестовый заказ от 3000 ₽ с одним из демо-сценариев — заказ должен перейти в статус сценария, а в карточке появится блок «Информация о кредите».
5. Переключите «Режим работы» на «Боевой».

FAQ #

В чекауте нет метода «Кредит/Рассрочка от Т-Банка», что проверить? #

Чаще всего страницы корзины и оформления собраны на блочной вёрстке Gutenberg, а не на шорткодах — метод появляется только в классическом чекауте. Откройте WooCommerce → Настройки → Дополнительно → Страницы и убедитесь, что в «Странице корзины» и «Странице оформления заказа» стоят страницы с [woocommerce_cart] и [woocommerce_checkout]. Параллельно проверьте, что лицензия активна в «Woodev → Лицензии», страна заказа — Россия, и все три поля shopId/showcaseId/пароль API заполнены без пробелов.

Покупатель оформил заявку, но в карточке заказа нет блока «Информация о кредите» #

Либо решение из банка ещё не пришло через вебхук — обычно это занимает несколько секунд, иногда до 1–2 минут. Либо сайт работает по HTTP без SSL, и Т-Банк не отправляет уведомления по соображениям безопасности. Откройте WooCommerce → Статус → Журналы и найдите свежий файл с префиксом wc_tinkoff_kvk — в нём видны входящие уведомления и ошибки парсинга.

В тестовом режиме после «Оформить заявку в Т-Банк» страница перезагружается без перехода на форму банка #

Чаще всего showcaseId введён с опечаткой или лишним пробелом, и Т-Банк отказывает в создании заявки на демо-витрине demo-{showcaseId}. Скопируйте showcaseId из кабинета банка заново, вставьте в поле «Идентификатор витрины» без пробелов и сохраните. Точную ошибку API можно посмотреть в свежем файле wc_tinkoff_kvk в журналах WooCommerce.

Как добавить разные условия рассрочки (например, 0/0/24 и кредит на 12 месяцев) рядом в чекауте? #

В поле «Промокод» добавляйте каждое условие отдельной строкой — нужны название (видит покупатель) и код (передаётся в Т-Банк). Покупатель в чекауте выберет вариант радио-кнопками перед отправкой заявки. Промокоды выпускает менеджер Т-Банка под конкретные акции вашей витрины.

Примеры кода #

Изменить делитель для минимального платежа в информере на карточке товара (по умолчанию 19, примерно средняя 19-месячная рассрочка):

add_filter( 'wc_geteway_tinkoff_kvk_loans_rate', static function ( $rate ) {
    return 12; // для 12-месячной рассрочки
} );

Подменить параметры запроса перед отправкой в API Т-Банка — например, динамический промокод по сумме заказа:

add_filter( 'wc_tinkoff_api_create_request_params', static function ( array $params, WC_Order $order, $gateway ) {
    if ( $order->get_total() > 100000 ) {
        $params['promoCode'] = 'big-order-rassrochka';
    }
    return $params;
}, 10, 3 );

Скрыть или добавить строки в блок «Информация о кредите» в карточке заказа:

add_filter( 'wc_tinkoff_order_fields_for_display_data', static function ( array $fields ) {
    unset( $fields['signing_type'] );
    return $fields;
} );