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