T-Pay

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

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

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

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

• Одностадийный платеж — мерчант списывает деньги за покупку сразу после завершения оплаты.
• ДВУХСТАДИЙНЫЙ платеж — сначала мерчант блокирует деньги за покупку на карте покупателя и только потом списывает их.

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

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

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

1. Вызовите метод ИНИЦИИРОВАТЬ ПЛАТЕЖ.
2. В зависимости от устройства покупателя, вызовите один из методов:
   • мобильное устройство — ПОЛУЧИТЬ ССЫЛКУ для редиректа покупателя в мобильное приложение Т-Банка;
   • десктоп — ПОЛУЧИТЬ QR для генерации QR-кода для оплаты.
3. Дождитесь оплаты покупателем.
   • При успешном сценарии операция перейдет в статус CONFIRMED, и покупатель будет перенаправлен на страницу SuccessURL.
   • При неуспешном — в статус AUTH_FAIL, а после трех попыток неудачной оплаты — в статус REJECTED. ПЕРЕЧЕНЬ КОДОВ ОШИБОК.

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

1. Вызовите метод ИНИЦИИРОВАТЬ ПЛАТЕЖ.
2. В зависимости от устройства покупателя, вызовите один из методов:
   • мобильное устройство — ПОЛУЧИТЬ ССЫЛКУ для редиректа покупателя в мобильное приложение Т-Банка;
   • десктоп — ПОЛУЧИТЬ QR для генерации QR-кода для оплаты.
3. Дождитесь оплаты покупателем.
   • При успешном сценарии операция перейдет в статус AUTHORIZED, и покупатель будет перенаправлен на страницу SuccessURL.
   • При неуспешном — в статус AUTH_FAIL, а после трех попыток неудачной оплаты — в статус REJECTED. ПЕРЕЧЕНЬ КОДОВ ОШИБОК.
4. Вызовите метод ПОДТВЕРДИТЬ СПИСАНИЕ c параметром PaymentId для подтверждения платежа.
   • При успешном сценарии операция перейдет в статус CONFIRMED.
   • При неуспешном — в статус AUTH_FAIL, а после трех попыток неудачной оплаты — в статус REJECTED. ПЕРЕЧЕНЬ КОДОВ ОШИБОК.

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

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

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

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

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

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

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