Конвертация с выбором валюты пользователем
Общая информация
Для конвертации с выбором валюты пользователем характерны следующие особенности:
-
Валюта выбирается пользователем из числа доступных.
К доступным валютам относятся все поддерживаемые для используемого проекта мерчанта валюты, к которым в источнике курсов найдены валютные пары. Таким образом, для каждого проекта и целевого действия перечень доступных валют может отличаться.
-
Средства зачисляются на счёт мерчанта в выбранной пользователем валюте: долларах, евро или фунтах стерлингов.
Если пользователь выбрал для оплаты евро, доллары США или фунты стерлингов и платёж проведён в выбранной валюте, средства зачисляются мерчанту в соответствующей валюте, если выбраны болгарские левы — в евро (для платёжной системы Visa) или долларах (для платёжной системы Mastercard). В остальных случаях средства зачисляются в долларах.
- Для такой конвертации используются валютные курсы, устанавливаемые ecommpay.
С вопросами о курсах и порядке их применения можно обращаться к курирующему менеджеру ecommpay.
Перечень валют для выбора пользователем отображается на Payment Page в выпадающем списке с указанием кода валюты. При этом валюта, код которой передан в запросе на оплату, отображается предварительной выбранной.
Рис.: Страница веб-сервиса мерчанта

Рис.: Страница оплаты до выбора валюты

Рис.: Страница оплаты со списком доступных валют

Рис.: Страница оплаты после выбора валюты

Рис.: Страница оплаты после заполнения всех полей

Рис.: Страница результата оплаты

Отображение перечня валют поддерживается для разовых оплат, в том числе при выполнении повторных попыток проведения платежа и регистрации повторяемой оплаты.
Пользователь может подтвердить оплату в исходной валюте или выбрать другую. При выборе другой валюты на платёжной форме вместо первоначальной суммы платежа отображается сумма с учётом конвертации в выбранную валюту. Например, при оплате в размере 95 USD
и выборе пользователем бразильских реалов в платёжной форме отображается сумма в реалах — допустим, 485 BRL
.
Далее на всех страницах платёжной формы, в том числе странице с результатом оплаты, пользователю отображается информация о выбранной им сумме в валюте. Так, для приведённого примера с оплатой в размере 95 USD
отображается сумма оплаты в выбранной пользователем валюте — 485 BRL
.
Подключение
Для получения более подробной информации о возможности использования конвертации с выбором валюты пользователем, а также для её подключения и настройки следует обращаться к курирующему менеджеру ecommpay.
Использование
Для использования конвертации с выбором валюты пользователем на стороне веб-сервиса не требуется действий, отличных от стандартных при проведении оплаты. Схема выполнения этого варианта конвертации в контексте оплаты в одну стадию представлена далее.
Рис.: Схема выполнения конвертации с выбором валюты пользователем
- От Payment Page к платёжной платформе направляется запрос на получение необходимой для конвертации информации.
- На стороне платёжной платформы выполняется обработка запроса.
- От платёжной платформы к Payment Page передаётся необходимая для конвертации информация.
- На Payment Page отображаются поля для ввода реквизитов платёжной карты и список доступных валют.
- Пользователь выбирает валюту и указывает реквизиты платёжной карты.
- От Payment Page к платёжной платформе направляется запрос на оплату с учётом валюты, выбранной пользователем.
Информация о выполненной конвертации передаётся в оповещениях о результатах платежей — в объекте operation
, где в объекте sum_initial
указываются исходные сумма и валюта, а в объекте sum_converted
— конечные сумма и валюта с учётом конвертации. Дополнительно в объекте sum_customer
оповещений передаётся информация о выборе валюты пользователем:
amount
— сумма операции в валюте, выбранной пользователем;currency
— код валюты, выбранной пользователем.
Исключением является выбор пользователем валюты, переданной в запросе на проведение платежа: в этом случае информация о выборе валюты не передаётся.
В следующем примере в оповещении содержится информация о том, что при проведении оплаты в размере 95 USD
пользователем была выбрана валюта BRL
, выполнена конвертация в 485 BRL
и сумма, фактически оплаченная пользователем, составила 485 BRL
.
Рис.: Пример данных из оповещения о результатах оплаты с конвертацией
{
"payment":{
"method":"card",
"sum":{
"amount":95,
"currency":"USD"
},
"id":"11006",
"type":"purchase",
"status":"success",
"date":"2022-06-23T13:32:09+0000",
"description":""
},
"customer":{
"id":"12"
},
"sum_customer":{
"amount":485,
"currency":"BRL"
},
"account":{
"number":"541333******0019"
},
"project_id":42,
"operation":{
"created_date":"2022-06-23T13:32:02+0000",
"request_id":"a23962a836e8e4-db4f1981d9-0006",
"sum_initial":{
"amount":95,
"currency":"USD"
},
"sum_converted":{
"amount":485,
"currency":"BRL"
},
"code":"0",
"message":"Success",
"eci":"05",
"provider":{
"id":6,
"payment_id":"1629803",
"auth_code":"563253",
"endpoint_id":6,
"date":"2022-06-23T10:32:09+0000"
},
"id":682400942,
"type":"sale",
"status":"success",
"date":"2022-06-23T13:32:09+0000"
},
"signature":"BsGd0vcBQjd+aFl8ehEPRjf/eQUABow+VO+/xSG+lqKo6xHQ=="
}