Модерация

Т-Банк проверит твой магазин:

  • Есть контакты с телефоном
  • Есть оферта и политика конфиденциальности
  • Хотя бы 5-10 товаров
  • Юр.лицо/ИП существует и активно

Обычно 1-2 рабочих дня. Если отказ — исправь то что попросили, подай повторно.

Terminal Key и Password

В личном кабинете Т-Банк Касса:

  • Terminal Key — 16 символов, публичный идентификатор
  • Password — секретный, используется для подписи запросов

В нашей админке: Настройки → Интеграции → Эквайринг → выбор «Т-Банк» → вставь оба.

NotificationURL

Мы передаём его в каждый платёж: https://vitrina-ai.ru/api/v1/shops/{shop_id}/payments/webhook/tinkoff. Т-Банк при изменении статуса оплаты пингует нас — мы двигаем заказ.

Статусы платежа

  • NEW / FORM_SHOWED / AUTHORIZED — промежуточные, игнорируем (не ломают заказ)
  • CONFIRMED → заказ = paid
  • CANCELED / REJECTED / AUTH_FAIL → заказ = cancelled

Фискализация

В чек уходят:

  • Каждый товар: name, price, quantity, tax (НДС)
  • Отдельная строка «Доставка 310 руб» если есть
  • Сумма — total_amount

Типичные ошибки

  • Не прошла модерация — мало товаров или нет контактов. Доделай, подай заново.
  • «Invalid signature» — неверный Password. Перепроверь, скопируй без пробелов.
  • Чек не пришёл в ФНС — обычно 5-10 минут задержки. Проверь на ofd.ru по ID терминала.