Оплата T-Pay через редирект

Платежный сервис Роутер поддерживает оплату T-Pay с платежной страницы.

До появления поддержки этого способа оплаты другими банками-эквайерами, оплата T-Pay возможна только в T-Банк. Банк для T-Pay должен быть указан в настройках Партнера в Платежном сервисе. Чтобы изменить настройки, обратитесь в службу поддержки. Текущие настройки можно узнать, отправив запрос /settings/getRouterParams.do.

Включение T-Pay на платежной странице

Чтобы способ оплаты T-Pay был доступен на платежной странице Платежного сервиса, необходимо в запросе регистрации заказа указать в параметре allowedPaymentWays среди прочих способов оплаты значение "TCB_TPAY". Ниже приведен пример запроса.

1. Клиент инициирует покупку товара или услуги на сайте Партнера.

2. Партнер отправляет в Платежный сервис Роутер запрос на регистрацию заказа: register.do для одностадийной оплаты или registerPreAuth.do для двухстадийной оплаты. Подробнее об этих видах оплаты см. в разделе Двухстадийные платежи.

В запросе нужно указать, что на платежной странице должен быть доступен способ оплаты T-Pay. Для этого в параметре allowedPaymentWays среди прочих способов оплаты нужно указать "TCB_TPAY".

Пример запроса

curl --request POST \
'https://api.router.rbsuat.com/v1/register.do' \
-H 'Content-Type: application/json' \
--data-raw \
'{
    "allowedPaymentWays": ["CARD_BINDING", "CARD", "TCB_TPAY"],
    "orderNumber": "order_123473",
    "amount": 1234,
    "currency": "643",
    "language": "ru",
    "returnUrl": "https://mybestmerchantreturnurl.com/success",
    "userName": "test_user",
    "password": "test_user_password",
    "clientId":"client_10001"    
}'

3. Платежный сервис Роутер проверяет данные и регистрирует заказ.

Редирект на платежную страницу

4. Платежный сервис Роутер передает Партнеру ссылку на платежную страницу.

Пример ответа

{
    "errorCode": "0",
    "formUrl": "https://router.rbsuat.com/wl/payment.html?mdOrder=2dc811e7-8d1c-407a-bd25-a4f41f96cc60&language=en",
    "orderId": "2dc811e7-8d1c-407a-bd25-a4f41f96cc60",
    "orderNumber": "order_123457"
}

5. Партнер перенаправляет Клиента на платежную страницу.

Выбор способа оплаты T-Pay

6. Клиент переходит на платежную страницу.

7. Клиент (платежная страница) запрашивает в Платежном сервисе параметры выполнения платежа.

8. Платежный сервис Роутер передает платежной странице параметры оплаты. В результате на платежной странице отображаются доступные способы оплаты.

9. Клиент выбирает платежный инструмент T-Pay.

Оплата T-Pay

10. Платежная страница запрашивает адрес для перехода на T-Pay.

11. Платежный сервис Роутер регистрирует заказ в банке.

12. Банк передает в Платежный сервис Роутер идентификатор заказа в банке.

13. Платежный сервис Роутер сообщает банковский номер заказа и запрашивает ссылку на T-Pay.

14. Банк формирует ссылку T-Pay на основании данных об устройстве Клиента и возвращает ее Платежному сервису.
- Desktop: URL для генерации QR-кода
- Mobile: URL для перехода в мобильное приложение Т-Банк.

15. Платежный сервис Роутер передает платежной странице ссылку T-Pay. В зависимости от устройства Клиента дальнейшие шаги немного различаются.

16. (Desktop) Происходит перенаправление Клиента на страницу с QR-кодом для перехода в мобильное приложение.

17. (Desktop) Клиент сканирует QR-код и переходит в мобильное приложение Т-Банк для оплаты.

18. (Mobile) Клиент сразу из приложения Партнера переходит в мобильное приложение Т-Банк и производит оплату.

19. В то время как Клиент производит оплату, платежная страница периодически отправляет в Платежный сервис Роутер запрос для получения статуса сессии.

20. Платежный сервис Роутер запрашивает статус сессии в банке.

21. Банк возвращает статус сессии в Платежный сервис Роутер.

22. Платежный сервис Роутер отправляет статус сессии на платежную страницу Клиента. Если в статусе сессии нет URL для перенаправления на финальную страницу, выполняется возврат на шаг 19. Если URL есть — переход на шаг 23.

23. После изменения статуса сессии Платежный сервис Роутер перенаправляет Клиента на финальную страницу в зависимости от результата платежа: в случае ошибки на failUrl, а в случае успешной оплаты на returnUrl. При этом к URL адресу будет добавлен query-параметр orderId=[идентификатора заказа в Платежном сервисе].

Финальный статус заказа

24. Клиент (финальная страница) запрашивает в Платежном сервисе финальный статус операции методом getOrderStatusExtended.do.

25-27. Платежный сервис Роутер запрашивает в банке статус заказа и отправляет его на финальную страницу Клиента.