Т-Банк
Что это за документ
Этот документ нужен компании, которая хочет подключить онлайн-оплату через Т-Банк к Omnis.
В Omnis Т-Банк работает как redirect-провайдер: клиент оформляет заказ, переходит на готовую платежную форму Т-Банка, оплачивает заказ и возвращается обратно в приложение.
Omnis создает платежи Т-Банка в одностадийном режиме: деньги списываются сразу после успешной оплаты на платежной форме. Двухстадийный сценарий с отдельным подтверждением списания в Omnis сейчас не используется.
Если в кабинете Т-Банка для терминала включен СБП, покупатель сможет выбрать этот способ на платежной форме Т-Банка. Отдельный экран оплаты в Omnis для этого не нужен.
Что важно понять сразу
Для рабочего запуска обычно нужны четыре шага:
- Получить TerminalKey и Password терминала в кабинете Т-Банка.
- Создать платежный аккаунт в Omnis и выбрать Тип провайдера = Т-Банк.
- Настроить Webhook URL в кабинете Т-Банка.
- Привязать платежный аккаунт к приложению и включить онлайн-оплату в форме оформления заказа.
Релевантные разделы
- Платежные провайдеры - если нужно создать или проверить платежный аккаунт в Omnis.
- Приложения - если аккаунт уже создан и его нужно назначить приложению.
- Блок страницы оформления заказа - если онлайн-оплата не показывается клиенту.
- Оплаты и возвраты - если нужно разбирать реальные оплаты и возвраты.
Что именно брать, копировать и куда вставлять
| Что нужно | Где взять | Куда вставить |
|---|---|---|
| TerminalKey | В кабинете Т-Банка, в настройках терминала | В Omnis, в поле Public key |
| Password | В кабинете Т-Банка, в настройках терминала | В Omnis, в поле Secret key |
| Webhook URL | В Omnis, в карточке платежного аккаунта | В кабинет Т-Банка, в настройки HTTP-уведомлений |
| Платежный аккаунт | В Omnis, после создания записи | В Omnis, в поле Платежный провайдер у приложения |
1. Где онлайн-оплата настраивается в Omnis
Платежный аккаунт создается в разделе:
Система -> Настройки -> Платежные провайдеры
Для первого рабочего или тестового запуска обычно достаточно заполнить:
- Наименование
- Тип провайдера = Т-Банк
- Public key = TerminalKey
- Secret key = Password
Дополнительно можно заполнить:
- Return URL
В Режим подтверждения используется Redirect.
2. Что нужно настроить в Т-Банке
В кабинете Т-Банка нужен терминал с подключением через готовую платежную форму.
В настройках терминала важно:
- получить TerminalKey
- получить Password
- включить нужные способы оплаты, включая СБП, если компания хочет принимать оплату через СБП
- указать Webhook URL, который Omnis показывает в карточке платежного аккаунта
- использовать рублевые платежи
Если для терминала подключена онлайн-касса на стороне Т-Банка, заранее проверьте фискальный сценарий. Omnis не передает чековые позиции в запросы Т-Банка, поэтому фискализация через онлайн-кассу Т-Банка в текущем сценарии не покрывается.
3. Как работает оплата
После создания заказа Omnis отправляет в Т-Банк запрос на создание платежа.
Т-Банк возвращает ссылку платежной формы.
Клиент переходит по этой ссылке, выбирает доступный способ оплаты на стороне Т-Банка и завершает платеж.
Дальше Omnis получает webhook-уведомление и обновляет платежные данные заказа.
Если webhook в кабинете Т-Банка не настроен, Omnis сможет обновить статус только при последующей синхронизации состояния платежа, поэтому автоматическое обновление будет менее предсказуемым.
4. Что не меняется в клиентском приложении
Для клиента и для CMS-модели Omnis сценарий остается таким же, как у других redirect-провайдеров:
- в приложении должен быть назначен платежный аккаунт
- в форме оформления заказа должна быть включена онлайн-оплата
- после выбора онлайн-оплаты клиент уходит на внешнюю платежную страницу
- после оплаты клиент возвращается в приложение
Клиентскому приложению Omnis не требуется отдельный UI под СБП: выбор СБП происходит на платежной форме Т-Банка.
5. Частые ошибки
В Omnis вставили не тот ключ
Для Т-Банка поле Omnis Public key означает TerminalKey, а поле Secret key означает Password.
СБП не появляется на платежной форме
Проверьте настройки терминала в кабинете Т-Банка. Omnis открывает готовую форму провайдера, а набор способов оплаты на этой форме управляется настройками Т-Банка.
Платеж завис в заблокированном состоянии
Проверьте настройки терминала и убедитесь, что используется одностадийная оплата. Omnis отправляет в Т-Банк одностадийный платеж и не выполняет отдельное подтверждение списания для двухстадийного сценария.
Нужна онлайн-касса через Т-Банк
Текущий сценарий Omnis не передает Receipt в Т-Банк. Если компании нужно формировать чеки именно через онлайн-кассу Т-Банка, этот сценарий нужно согласовать отдельно до запуска.
Онлайн-оплата не появляется в приложении
Проверьте, что платежный аккаунт активен, назначен приложению, а в CMS-компоненте оформления заказа включена онлайн-оплата.