docs.modx.pro
mspTBank
mspTBank
Приём оплаты через T-Bank для MiniShop3: redirect, webhook, чеки 54-ФЗ, одно- и двухстадийная схема, возвраты
  • MODX 3
  • PHP 8.2
  • miniShop3
Dependencies
  • miniShop3
  1. Extras
  2. mspTBank
  3. Быстрый старт

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

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

Требования ​

ТребованиеВерсия
MODX Revolution3.0+
PHP8.2+
MiniShop3установлен
pdoTools3.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 символов). Храните как секрет.

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

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

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

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

Шаг 3: Notification URL в T-Bank ​

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

  1. Откройте настройки терминала в личном кабинете интернет-эквайринга.
  2. Укажите Notification URL (HTTPS, ваш домен):
text
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, из документации банка):

ПолеЗначение
PAN2200770239097761
Срок12/30
CVV123

Платите только тестовыми картами из справки 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.

Что дальше ​