mspTBank — приём платежей через T-Bank для MiniShop3 на MODX Revolution 3.x.

Компонент работает с T-Bank API v2: создаёт платёж, отправляет покупателя на платёжную форму, принимает webhook-уведомления, обновляет статус заказа и поддерживает возвраты. Для интеграции используются методы Init, GetState, Confirm, Cancel, Refund.

Особенности

• рассчитан на MODX 3.0+, MiniShop3, PHP 8.2+
• одностадийная оплата и двухстадийная схема через настройку msptbank_two_stage
• чеки 54-ФЗ через Receipt в Init, Confirm и Refund
• webhook с проверкой подписи Token и обновлением статуса заказа MiniShop3
• возвраты через MODX processor refund
• тестовый режим через msptbank_test_mode: запросы уходят на rest-api-test.tinkoff.ru/v2
• отладочные логи в MODX через msptbank_debug без вывода пароля

Что нужно для подключения

Для реальной интеграции нужны TerminalKey и Password терминала из личного кабинета T-Bank / Т-Бизнес. Универсальной тестовой пары для всех интеграторов в открытой документации банка нет.

Где взять TerminalKey и Password

Сначала подключите интернет-эквайринг в личном кабинете Т-Бизнес: подайте заявку, создайте магазин, заполните данные сайта/компании, настройте тестовый терминал, пройдите тестовые платежи и дождитесь активации рабочего терминала.

После появления терминала откройте:

Личный кабинет интернет-эквайринга → Магазины → нужный магазин → Терминалы → Настроить

В некоторых версиях кабинета путь выглядит как Магазины → Интернет-магазины → нужный магазин → Терминалы → Тестовый или Рабочий → Настроить.

В параметрах терминала скопируйте:

• TerminalKey → настройка MODX msptbank_terminal_key
• Password → настройка MODX msptbank_password

Оба значения состоят из 20 символов и чувствительны к регистру. Password — секрет терминала.

Если в кабинете есть отдельные блоки Тестовый и Рабочий, используйте данные одного и того же терминала. Для production-оплат берите рабочий терминал и выключайте msptbank_test_mode.

Настройка в MODX

После установки откройте системные настройки namespace msptbank и заполните:

• msptbank_terminal_key — TerminalKey терминала T-Bank
• msptbank_password — секретный пароль терминала
• msptbank_test_mode — тестовый контур без реальных списаний
• msptbank_debug — подробные логи для отладки
• msptbank_two_stage — двухстадийная схема оплаты
• msptbank_success_url / msptbank_fail_url — свои URL возврата покупателя, если нужны
• msptbank_send_receipt — передача чеков 54-ФЗ
• msptbank_taxation — система налогообложения для чека
• msptbank_vat — ставка НДС для позиций чека
• msptbank_status_refunded — статус MiniShop3 для возврата

Если включена передача чеков, компонент собирает Receipt из товаров заказа, доставки, итоговой суммы и контактов покупателя. При отсутствии Email и телефона платёж не блокируется: компонент пишет предупреждение в лог и отправляет запрос без чека.

Notification URL

В личном кабинете T-Bank укажите URL уведомлений:

https://ВАШ_ДОМЕН/assets/components/msptbank/webhook.php

Без доступного webhook заказ не сможет автоматически перейти в оплаченный статус после оплаты.

Тестирование эквайринга

Для тестового контура T-Bank включите msptbank_test_mode. Компонент будет отправлять запросы на rest-api-test.tinkoff.ru/v2/. По инструкции банка для тестовой среды обычно используется боевой терминал без приставки DEMO, а IP сервера добавляется в белый список тестовой среды через личный кабинет.

Тестовые карты берите из официальной документации T-Bank. Например, для успешной оплаты без 3DS в документации указан PAN 2200770239097761, срок 12/30, CVV 123.

Возвраты

Возврат выполняется processor-ом:

$modx->runProcessor('refund', [
    'order_id' => 123,
    'amount' => 100.50,
], ['processors_path' => $modx->getOption('core_path') . 'components/msptbank/processors/']);

Документация: developer.tbank.ru.