Оплата с конвертацией валюты

Платежный сервис Роутер поддерживает оплату с конвертацией валюты. Заказ регистрируется в одной валюте, а оплата конвертируется в другую валюту по выбору Партнера. Конвертация выполняется по курсу ЦБ РФ на день покупки.

По своему выбору Партнер может:

Скрыть исходную валюту и сумму заказа от банка.
Показывать клиенту как оригинальную валюту, так и целевую по выбору Партнера.
Установить дополнительную комиссию за конвертацию.

Конвертация валют должна быть задана в настройках Партнера в Платежном сервисе. Для настройки обратитесь в службу поддержки.

Схема интеграции

Регистрация заказа в исходной валюте

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

2. Партнер отправляет в Платежный сервис Роутер запрос на регистрацию заказа в исходной (оригинальнной) валюте:

register.do для одностадийной оплаты или
registerPreAuth.do для двухстадийной оплаты.

Подробнее об этих видах оплаты см. в разделе Двухстадийные платежи.

При использовании способа оплаты XBORDER_1 есть следующие особенности регистрации заказа с конвертацией валют:

В запросе должно быть указано описание заказа в параметре description.
В запросе должно быть указано значение исходной валюты в параметре currency.
Значение allowedPaymentWays будет проигнорировано, так как способ оплаты XBORDER_1 переопределяет другие способы оплаты на стороне Платежного сервиса. Для включения этого способа оплаты обратитесь в службу поддержки.

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

curl --request POST \
'https://api.router.rbsuat.com/v2/register.do' \
-H 'Content-Type: application/json' \
--data-raw \
'{
    "orderNumber": "order_123456",
    "amount": 1234,
    "currency": "643",
    "returnUrl": "https://mybestmerchantreturnurl.com",
    "userName": "test_user",
    "password": "test_user_password",
    "description": "test payment"
}'

curl --request POST \
'https://api.router.rbsuat.com/v1/register.do' \
-H 'Content-Type: application/json' \
--data-raw \
'{
    "orderNumber": "order_123456",
    "amount": 1234,
    "currency": "643",
    "returnUrl": "https://mybestmerchantreturnurl.com",
    "userName": "test_user",
    "password": "test_user_password",
    "description": "test payment"
}'

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_123456"
}

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

Загрузка платежной страницы

6. Клиент загружает платежную страницу.

7. Платежный сервис выполняет конвертацию валюты.

8. Платежный сервис передает на платежную страницу итоговую сумму заказа.

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

Оплата в целевой валюте

9. Клиент вводит данные для оплаты, затем нажимает Оплатить.

10. Платежный сервис Роутер регистрирует и оплачивает заказ в Банке в целевой валюте. На данном этапе может потребоваться прохождение 3DS.

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

12. Платежный сервис Роутер передает финальный статус на платежную страницу. Статус заказа содержит суммы в целевой валюте.

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

Отмены, возвраты, завершения платежей

Отмена, возврат и завершение оплат с конвертацией валюты осуществляются теми же методами, что и для обычных оплат, см. Отмены, возвраты и Завершения.

При завершении двухстадийных платежей и возвратах Партнер должен указывать оригинальную валюту. Платежный сервис проведет конвертацию по курсу в день покупки.