Быстрый старт

Как принять первый платёж через T-Bank на сайте с MiniShop3.

Требования

Требование	Версия
MODX Revolution	3.0+
PHP	8.2+
MiniShop3	установлен
pdoTools	3.x
Эквайринг T-Bank	терминал в личном кабинете Т-Бизнес

Универсальной тестовой пары TerminalKey/Password для всех интеграторов в открытой документации нет. Ключи выдаёт банк после подключения магазина.

Шаг 1: Установка пакета

1. Убедитесь, что установлен MiniShop3.
2. Управление пакетами → установите mspTBank.
3. Управление → Очистить кэш.
4. Проверьте плагин msptbank_bootstrap на событии OnMODXInit. Он должен быть включён.

Шаг 2: Ключи терминала в MODX

1. Настройки → Системные настройки, фильтр msptbank.
2. Заполните:
   • msptbank_terminal_key: TerminalKey из кабинета T-Bank (20 символов).
   • msptbank_password: Password терминала (20 символов). Храните как секрет.

Где взять в кабинете:

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

TerminalKey и Password должны относиться к одному терминалу. Не смешивайте данные тестового и рабочего терминала.

Подробнее: Системные настройки.

Шаг 3: Notification URL в T-Bank

Без webhook заказ в MODX не перейдёт в «оплачен» автоматически.

1. Откройте настройки терминала в личном кабинете интернет-эквайринга.
2. Укажите Notification URL (HTTPS, ваш домен):

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

1. Включите уведомления о платежах, подтверждениях и отменах (названия флагов зависят от версии кабинета).

Детали обработки: Интеграция, webhook.

Шаг 4: Способ оплаты в MiniShop3

Резолвер создаёт способ TBank с классом MspTBank\Payment\TbankPayment.

1. MiniShop3 → Настройки → Оплаты (или эквивалент в вашей сборке).
2. Включите (Активен) способ TBank.
3. Проверьте, что способ доступен на странице оформления заказа.

Двухстадийная схема включается настройкой msptbank_two_stage, а не вторым способом оплаты.

Шаг 5: Чеки 54-ФЗ

Если в терминале T-Bank подключена онлайн-касса, оставьте msptbank_send_receipt = «Да» и заполните:

• msptbank_taxation: система налогообложения для Receipt
• msptbank_vat: ставка НДС для всех позиций чека.

Компонент добавляет Receipt в Init, Confirm для двухстадийной схемы и Refund. Для T-Bank обязателен Email или Phone покупателя. Компонент берёт контакт из адреса заказа, затем из клиента MiniShop3.

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

Шаг 6: Тестовый контур

Для проверки без боевых списаний:

1. Включите msptbank_test_mode = «Да». Запросы пойдут на https://rest-api-test.tinkoff.ru/v2/.
2. Используйте TerminalKey и Password рабочего терминала без приставки DEMO (по инструкции T-Bank).
3. Добавьте IP сервера в белый список тестовой среды через чат личного кабинета Т-Бизнес.
4. Если проверяете чеки, убедитесь, что у тестового заказа есть Email или телефон.
5. На время отладки включите msptbank_debug = «Да».

Тестовая карта (успех без 3DS, из документации банка):

Поле	Значение
PAN	2200770239097761
Срок	12/30
CVV	123

Платите только тестовыми картами из справки T-Bank.

Шаг 7: Проверка оплаты

1. Оформите заказ с суммой не меньше 0,01 ₽.
2. Выберите TBank и перейдите к оплате. Откроется форма T-Bank.
3. После успеха webhook выставит заказу статус ms3_status_paid (часто ID 3).
4. Если включён msptbank_send_receipt, проверьте в логах, что запрос Init ушёл с Receipt.

Статус не сменился? Проверьте Notification URL, HTTPS, ключи и FAQ.

Что дальше

• Системные настройки: URL возврата, чеки 54-ФЗ, msptbank_two_stage, msptbank_status_refunded
• Интеграция и сценарии: поток оплаты, Receipt, возврат, оплата из личного кабинета
• FAQ: диагностика webhook и тестового API