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

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

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

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

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

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

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

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

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

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

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

Пользователь может подтвердить оплату в исходной валюте или выбрать другую. При выборе другой валюты на платёжной форме вместо первоначальной суммы платежа отображается сумма с учётом конвертации в выбранную валюту. Например, при оплате в размере 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=="
}