mspTBank

mspTBank подключает T-Bank (эквайринг API v2) к MiniShop3 в MODX Revolution 3.x: создание платежа Init, редирект на форму банка, webhook с проверкой подписи Token, чеки 54-ФЗ через Receipt и обновление статуса заказа.

Пространство имён настроек: msptbank. Точка входа уведомлений: assets/components/msptbank/webhook.php.

С чего начать: Быстрый старт.

Возможности

• Redirect-оплата: TbankPayment::send() вызывает Init и возвращает PaymentURL.
• Webhook: POST на webhook.php, проверка Token, сверка суммы, идемпотентное обновление статуса.
• Одностадийная схема: по умолчанию списание после успешной оплаты (CONFIRMED).
• Двухстадийная схема: настройка msptbank_two_stage, PayType = T, auto-Confirm после AUTHORIZED.
• Чеки 54-ФЗ: Receipt в Init, Confirm и Refund при включённом msptbank_send_receipt.
• Возврат: processor refund (API Refund), опционально смена статуса через msptbank_status_refunded.
• Тестовый контур: msptbank_test_mode переключает API на rest-api-test.tinkoff.ru/v2.
• Отладка: msptbank_debug пишет запросы/ответы в лог MODX без пароля терминала.

Для чеков нужна онлайн-касса в терминале T-Bank и Email или Phone в заказе. Если контактов нет, компонент пишет warning и отправляет платёж без Receipt, чтобы не блокировать покупателя.

Системные требования

Требование	Версия
MODX Revolution	3.0+
PHP	8.2+ (расширения json, curl)
MiniShop3	1.0+
pdoTools	3.0+ (рекомендуется для Fenom)

Зависимости

• MiniShop3: заказы, способы оплаты, статусы (ms3_status_paid, ms3_status_canceled и др.).

Регистрация в T-Bank

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

• TerminalKey → msptbank_terminal_key
• Password терминала → msptbank_password

Оба значения по 20 символов, регистр важен. Password терминала храните как секрет. Не публикуйте его в git и тикетах.

Путь в кабинете (формулировки могут отличаться):

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

Подробнее: Быстрый старт, ключи.

Установка

1. Установите MiniShop3 и pdoTools.
2. Установите пакет mspTBank через Управление пакетами.
3. Очистите кэш MODX.
4. В Системные настройки → msptbank задайте ключи терминала.
5. Включите способ оплаты TBank в MiniShop3.

Резолвер создаёт способ оплаты с классом MspTBank\Payment\TbankPayment. Двухстадийность включается настройкой msptbank_two_stage, отдельного способа в MS3 нет.

Плагин msptbank_bootstrap на OnMODXInit подключает автозагрузку MspTBank\. Плагин должен быть включён.

Быстрая настройка webhook

В параметрах терминала T-Bank укажите Notification URL:

https://ваш-домен.ru/assets/components/msptbank/webhook.php

Компонент также передаёт NotificationURL в Init. Без доступного webhook заказ может остаться неоплаченным после успешной оплаты в банке.

Архитектура

Быстрые ссылки

Нужно	Документ
Установить и принять первый платёж	Быстрый старт
Все ключи msptbank_*	Системные настройки
Webhook, чеки, двухстадийная, возврат	Интеграция
Заказ не оплачен, тест	FAQ
Оформление заказа MS3	MiniShop3: заказ

Документация по разделам

• Быстрый старт: установка, ключи, Notification URL, тестовая карта.
• Системные настройки: таблицы настроек, чеки 54-ФЗ, связанные ключи MiniShop3.
• Интеграция и сценарии: API ↔ код, Receipt, поток оплаты, оплата после проверки менеджером, processor refund.
• FAQ: типовые ошибки и диагностика.

Лицензия пакета: GPLv2 и новее.