T-Pay

T-Pay — это быстрый способ оплаты внутри мобильного приложения Т-Банка.

Принимать платежи через T-Pay можно на мобильных устройствах и десктопах.

Особенности способа оплаты

Поддержка платежных систем: «Мир», Visa и Mastercard.
Эмитент: Т-Банк.
Срок оплаты: можно настроить от 1 минуты до 90 дней. Значение по умолчанию: 24 часа.
Срок холдирования: 7 дней.
Минимальная сумма операции: 1 рубль.
Поддерживается одно- и двухстадийная оплата.
Возврат: частичный и полный.
Поддерживаются платежи по сохраненным реквизитам.
Отображение в реестре: T-Pay.

Прием платежей

Принимать платежи через T-Pay можно двумя способами:

Одностадийный платеж — мерчант списывает деньги за покупку сразу после завершения оплаты.
Двухстадийный платеж — сначала мерчант блокирует деньги за покупку на счете покупателя и только потом списывает их.

По правилам Национальной системы платежных карт (НСПК), холдировать деньги на счете покупателя можно на срок до 7 дней.

Например, покупатель оплатил товар 1 марта, и его банк заморозил деньги на счете. Подтвердить платеж нужно в течение 7 дней, включая день авторизации — то есть до 7 марта включительно. После этого срока деньги на счете покупателя могут быть расхолдированы и покупатель может их потратить — подтвердить списание не получится.

Одностадийный платеж

Вызовите метод Определить возможность проведения платежа для определения возможности проведения оплаты через T-Pay.
Вызовите метод Инициировать платеж.
Вызовите метод Получить ссылку для редиректа покупателя в приложение Т-Банка при оплате с мобильного устройства или в веб-интерфейс T-Pay — с десктопа.
Открытие ссылки для оплаты внутри iframe не допускается. Вместо использования iframe необходимо реализовать прямой редирект пользователя.
Дождитесь оплаты покупателем.
- При успешном сценарии операция перейдет в статус CONFIRMED. Страницу SuccessURL покупатель увидит только после того, как нажмет на кнопку Вернуться в магазин или Готово.
- При неуспешном сценарии — в статус AUTH_FAIL, а после трех неудачных попыток оплаты — в статус REJECTED. Список кодов ошибок.

Двухстадийный платеж

Вызовите метод Определить возможность проведения платежа для определения возможности проведения оплаты через T-Pay.
Вызовите метод Инициировать платеж.
Вызовите метод Получить ссылку для редиректа покупателя в приложение Т-Банка при оплате с мобильного устройства или в веб-интерфейс T-Pay — с десктопа.
Открытие ссылки для оплаты внутри iframe не допускается. Вместо использования iframe необходимо реализовать прямой редирект пользователя.
Дождитесь оплаты покупателем. При успешном сценарии операция перейдет в статус AUTHORIZED. Страницу SuccessURL покупатель увидит только после того, как нажмет на кнопку Вернуться в магазин или Готово.
Вызовите метод Подтвердить списание c параметром PaymentId для подтверждения платежа.
- При успешном сценарии операция перейдет в статус CONFIRMED.
- При неуспешном сценарии — в статус AUTH_FAIL, а после трех неудачных попыток оплаты — в статус REJECTED. Список кодов ошибок.

Особенности при проведении платежей

Метод Инициировать платеж

При оплате через T‑Pay в объекте DATA вы можете передавать параметры устройства, с которого будет осуществлен переход. Пример:

"DATA": {
  "TinkoffPayWeb": true,
  "Device": "Desktop",
  "DeviceOs": "iOS",
  "DeviceWebView": true,
 }

TinkoffPayWeb — параметр, который отвечает за использование платежной формы мерчанта как основной. Если вы используете собственную платежную форму, передавайте "DATA":{"TinkoffPayWeb":true}.

Рекомендации для заполнения полей:

Mobile — при оплате c мобильного устройства;
Desktop — при оплате c десктопа.