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

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

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

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

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

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

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

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

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

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

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

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

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

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

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. Платежный сервис Роутер передает финальный статус на платежную страницу. Статус заказа содержит суммы в целевой валюте.

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

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

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

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