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