T-Pay
T-Pay — это быстрый способ оплаты внутри мобильного приложения Т-Банка.
- Учитывайте требования к дизайну кнопки T-Pay.
- Принимать платежи через T-Pay можно на мобильных устройствах и десктопах.
Принимать платежи через T-Pay можно двумя способами:
- Одностадийный платеж — мерчант списывает деньги за покупку сразу после завершения оплаты.
- Двухстадийный платеж — сначала мерчант блокирует деньги за покупку на карте покупателя и только потом списывает их.
По правилам Национальной системы платежных карт (НСПК), холдировать деньги на карте покупателя можно на срок до 7 дней.
Например, покупатель оплатил товар 1 марта, и его банк заморозил деньги на счете. Подтвердить платеж нужно в течение 7 дней, включая день авторизации — то есть до 7 марта включительно. После этого срока деньги на счете покупателя могут быть расхолдированы и покупатель может их потратить — подтвердить списание не получится.
Одностадийный платеж
- Вызовите метод Инициировать платеж с обязательной передачей параметра
"name":"TPAY"
в объектеpaymentMethod
. - В зависимости от устройства покупателя, вызовите один из методов:
- мобильное устройство — Получить ссылку с обязательной передачей параметра
"name":"TPAY"
в объектеpayment
для редиректа покупателя в мобильное приложение Т-Банка; - десктоп — Зарегистрировать QR с обязательной передачей параметра
"name":"TPAY"
в объектеpayment
для генерации QR-кода для оплаты.
- мобильное устройство — Получить ссылку с обязательной передачей параметра
- Дождитесь оплаты покупателем.
- при успешном сценарии операция перейдет в статус
CONFIRMED
. Страницу сSuccessURL
покупатель увидит, если после оплаты нажмет на кнопку Вернуться в магазин; - при неуспешном — в статус
AUTH_FAIL
, а после трех попыток неудачной оплаты — в статусREJECTED
. В этом случае покупатель будет перенаправлен на страницуFailURL
. Список кодов ошибок.
- при успешном сценарии операция перейдет в статус
Двухстадийный платеж
- Вызовите метод Инициировать платеж с обязательной передачей параметра
"name":"TPAY"
в объектеpaymentMethod
. - В зависимости от устройства покупателя, вызовите один из методов:
- мобильное устройство — Получить ссылку с обязательной передачей параметра
"name":"TPAY"
в объектеpayment
для редиректа покупателя в мобильное приложение Т-Банка; - десктоп — Зарегистрировать QR с обязательной передачей параметра
"name":"TPAY"
в объектеpayment
для генерации QR-кода для оплаты.
- мобильное устройство — Получить ссылку с обязательной передачей параметра
- Дождитесь оплаты покупателем.
- при успешном сценарии операция перейдет в статус
AUTHORIZED
. Страницу сSuccessURL
покупатель увидит, если после оплаты нажмет на кнопку Вернуться в магазин; - при неуспешном — в статус
AUTH_FAIL
, а после трех попыток неудачной оплаты — в статусREJECTED
. В этом случае покупатель будет перенаправлен на страницуFailURL
. Список кодов ошибок.
- при успешном сценарии операция перейдет в статус
- Вызовите метод Подтвердить списание c параметром
paymentId
для подтверждения платежа.- при успешном сценарии операция перейдет в статус
CONFIRMED
; - при неуспешном — в статус
AUTH_FAIL
, а после трех попыток неудачной оплаты — в статусREJECTED
. Список кодов ошибок.
- при успешном сценарии операция перейдет в статус
Особенности при проведении платежей
Метод Инициировать платеж
При отправке запроса:
- При подключении оплаты через T-Pay обязательно передаются параметры устройства в объекте
fingerprint
:"fingerprint": {
"ip": "129.00.00.1",
"os": "iOs",
"webView": "true",
"browser": "Safari"
}