Конвертация с выбором валюты пользователем

Общая информация

Для конвертации с выбором валюты пользователем характерны следующие особенности:

  • Валюта выбирается пользователем из числа доступных.

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

  • Средства зачисляются на счёт мерчанта в выбранной пользователем валюте: долларах, евро или фунтах стерлингов.

    Если пользователь выбрал для оплаты евро, доллары США или фунты стерлингов и платёж проведён в выбранной валюте, средства зачисляются мерчанту в соответствующей валюте, если выбраны болгарские левы — в евро (для платёжной системы Visa) или долларах (для платёжной системы Mastercard). В остальных случаях средства зачисляются в долларах.

  • Для такой конвертации используются валютные курсы, устанавливаемые ecommpay.

    С вопросами о курсах и порядке их применения можно обращаться к курирующему менеджеру ecommpay.

Перечень валют для выбора пользователем отображается на Payment Page в выпадающем списке с указанием кода валюты. При этом валюта, код которой передан в запросе на оплату, отображается предварительной выбранной.

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


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


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


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


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

Пользователь может подтвердить оплату в исходной валюте или выбрать другую. При выборе другой валюты на платёжной форме вместо первоначальной суммы платежа отображается сумма с учётом конвертации в выбранную валюту. Например, при оплате в размере 10 USD и выборе пользователем бразильских реалов в платёжной форме отображается сумма в реалах — допустим, 57.60 BRL.

Далее на всех страницах платёжной формы, в том числе странице с результатом оплаты, пользователю отображается информация о выбранной им сумме в валюте. Так, для приведённого примера с оплатой в размере 10 USD отображается сумма оплаты в выбранной пользователем валюте — 57.60 BRL.

Подключение

Для получения более подробной информации о возможности использования конвертации с выбором валюты пользователем, а также для её подключения и настройки следует обращаться к курирующему менеджеру ecommpay.

Использование

Для использования конвертации с выбором валюты пользователем на стороне веб-сервиса не требуется действий, отличных от стандартных при проведении оплаты. Схема выполнения этого варианта конвертации в контексте оплаты в одну стадию представлена далее.



Рис. 5. Схема выполнения конвертации с выбором валюты пользователем
  1. От Payment Page к платёжной платформе направляется запрос на получение необходимой для конвертации информации.
  2. На стороне платёжной платформы выполняется обработка запроса.
  3. От платёжной платформы к Payment Page передаётся необходимая для конвертации информация.
  4. На Payment Page отображаются поля для ввода реквизитов платёжной карты и список доступных валют.
  5. Пользователь выбирает валюту и указывает реквизиты платёжной карты.
  6. От Payment Page к платёжной платформе направляется запрос на оплату с учётом валюты, выбранной пользователем.

Информация о выполненной конвертации передаётся в оповещениях о результатах платежей — в объекте operation, где в объекте sum_initial указываются исходные сумма и валюта, а в объекте sum_converted — конечные сумма и валюта с учётом конвертации. Дополнительно в объекте sum_customer оповещений передаётся информация о выборе валюты пользователем:

  • amount — сумма операции в валюте, выбранной пользователем;
  • currency — код валюты, выбранной пользователем.

Исключением является выбор пользователем валюты, переданной в запросе на проведение платежа: в этом случае информация о выборе валюты не передаётся.

В следующем примере в оповещении содержится информация о том, что при проведении оплаты в размере 10 USD пользователем была выбрана валюта BRL, выполнена конвертация в 57.60 BRL и сумма, фактически оплаченная пользователем, составила 57.60 BRL.

Рис. 6. Пример данных из оповещения о результатах оплаты с конвертацией
{
    "payment":{
        "method":"card",
        "sum":{
            "amount":1000,
            "currency":"USD"
        },
        "id":"11006",
        "type":"purchase",
        "status":"success",
        "date":"2022-06-23T13:32:09+0000",
        "description":""
    },
    "customer":{
        "id":"12"
    },
    "sum_customer":{
        "amount":5760,
        "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":1000,
            "currency":"USD"
        },
        "sum_converted":{
            "amount":5760,
            "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=="
}