Skip to main content

T-Pay

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

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

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

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

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

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

  1. Вызовите метод Инициировать платеж. В объекте paymentMethod обязательно передайте параметр "name":"TPAY".
  2. В зависимости от устройства покупателя, вызовите один из методов:
    • Мобильное устройство — Получить ссылку. В объекте payment обязательно передайте параметр "name":"TPAY" для редиректа покупателя в мобильное приложение Т-Банка.
    • Десктоп — Зарегистрировать QR. В объекте payment обязательно передайте параметр "name":"TPAY" для генерации QR-кода для оплаты.
  3. Дождитесь оплаты покупателем.
    • При успешном сценарии операция перейдет в статус CONFIRMED. Покупатель увидит страницу с SuccessURL, если после оплаты нажмет на кнопку Вернуться в магазин.
    • При неуспешном — в статус AUTH_FAIL, а после трех попыток неудачной оплаты — в статус REJECTED. В этом случае покупатель будет перенаправлен на страницу FailURL. Список кодов ошибок.

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

  1. Вызовите метод Инициировать платеж. В объекте paymentMethod обязательно передайте параметр "name":"TPAY".
  2. В зависимости от устройства покупателя, вызовите один из методов:
    • Мобильное устройство — Получить ссылку. В объекте payment обязательно передайте параметр "name":"TPAY" для редиректа покупателя в мобильное приложение Т-Банка.
    • Десктоп — Зарегистрировать QR. В объекте payment обязательно передайте параметр "name":"TPAY" для генерации QR-кода для оплаты.
  3. Дождитесь оплаты покупателем.
    • При успешном сценарии операция перейдет в статус AUTHORIZED. Покупатель увидит страницу с SuccessURL, если после оплаты нажмет на кнопку Вернуться в магазин.
    • При неуспешном — в статус AUTH_FAIL, а после трех попыток неудачной оплаты — в статус REJECTED. В этом случае покупатель будет перенаправлен на страницу FailURL. Список кодов ошибок.
  4. Вызовите метод Подтвердить списание c параметром paymentId для подтверждения платежа.
    • При успешном сценарии операция перейдет в статус CONFIRMED.
    • При неуспешном — в статус AUTH_FAIL, а после трех попыток неудачной оплаты — в статус REJECTED. Список кодов ошибок.

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

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

Отправка запроса

При подключении оплаты через T-Pay в объекте fingerprint обязательно передаются параметры устройства:

"fingerprint": {
"ip": "129.00.00.1",
"os": "iOs",
"isWebView": "true",
"browser": "Safari"
}

Платежи по сохраненным реквизитам

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

openapi@tbank.ru

АО «ТБанк» использует файлы «cookie» с целью персонализации сервисов и повышения удобства пользования веб-сайтом. «Cookie» представляют собой небольшие файлы, содержащие информацию о предыдущих посещениях веб-сайта. Если вы не хотите использовать файлы «cookie», измените настройки браузера.