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

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

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

Включение способа оплаты Alfa Pay на платежной странице

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

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

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

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

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

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

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. Партнер перенаправляет Клиента на платежную страницу.

Выбор способа оплаты Alfa Pay

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

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

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

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

Оплата Alfa Pay

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

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

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

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

14. Прокси Alfa Pay сообщает банку о начале оплаты, получает ссылку на Alfa Pay и возвращает ее в Платежный сервис Роутер.

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

16. Клиент переходит по ссылке Alfa Pay. В зависимости от того, производится ли оплата с телефона или с компьютера, будет открыто мобильное приложение или мобильный банк. Там Клиент выбирает карту для оплаты.

17. Страница Alfa Pay передает данные карты в прокси Alfa Pay. Дополнительно передается признак необходимости подтверждения платежа по 3DS.

18. Прокси Alfa Pay выполняет оплату заказа в банке. Если был запрошен 3DS, клиент дополнительно проходит 3DS аутентификацию. На странице подтверждения необходимо ввести проверочный код.

19. Банк возвращает статус оплаты в прокси Alfa Pay.

20. Прокси Alfa Pay сообщает на страницу Alfa Pay результат оплаты.

Отображение финального статуса оплаты

21. Страница Alfa Pay перенаправляет клиента на страницу результата оплаты. В зависимости от результата платежа это либо ссылка на failUrl, либо на returnUrl.

22. Клиент переходит на указанный адрес.

23. Клиент (финальная страница) отправляет в Платежный сервис Роутер запрос для получения финального статуса заказа getOrderStatusExtended.do.

24-26. Платежный сервис Роутер запрашивает в выбранном банке и передает на финальную страницу статус заказа.