Конвертация валют

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

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

• Европейский центральный банк,
• Центральный банк Российской Федерации,
• Сервис Currencylayer.

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

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

Подключение

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

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

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

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

В следующем примере в оповещении содержится информация о том, что при проведении оплаты в размере 100 USD выполнена конвертация в 519,41 PHP.

{ 
  "project_id":42,
  "payment":{ 
    "id":"15dd47055381e8375e7b2d0cb16f",
    "type":"purchase",
    "status":"success",
    "date":"2019-09-17T11:50:29+0000",
    "method":"dragonpay",
    "sum":{ 
      "amount":10000, // Сумма, переданная в запросе
      "currency":"USD" // Код исходной валюты, переданный в запросе
    },
    "description":""
  },
  "operation":{ 
    "id":200004157,
    "type":"sale",
    "status":"success",
    "date":"2019-09-17T11:50:29+0000",
    "created_date":"2019-09-16T13:17:31+0000",
    "request_id":"622d6f7f9e6bce298676b38e45",
    "sum_initial":{ 
      "amount":10000, // Сумма, переданная в запросе
      "currency":"USD" // Код исходной валюты, переданный в запросе
    },
    "sum_converted":{ 
      "amount":519410, // Сумма с учётом конвертации
      "currency":"PHP" // Код конечной валюты
    },
    "provider":{ 
      "id":1165,
      "payment_id":"DY3TU78",
      "date":"2019-09-16T21:17:39+0000",
      "auth_code":"",
      "endpoint_id":"BPI"
    },
    "code":"0",
    "message":"Success"
  },
  "signature":"MJv7KNMpfogAxwRIL9tVftZ1ZZ5D/aZAeb0VMdeR+CqGrNxYyilUwSm...=="
}

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

При оплатах через Payment Page с использованием платёжных карт поддерживается возможность выбора валюты платежа пользователем. К валютам, доступным для такого выбора, относятся евро (EUR), доллары США (USD), фунты стерлингов (GBP) и российские рубли (RUB). При этом для каждого проекта настраивается свой перечень, который может включать в себя как все перечисленные валюты, так и часть из них.

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

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

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

Например, при оплате в размере 95,00 USD и выборе пользователем валюты евро, в платёжной форме отображается курс евро к доллару США и сумма в евро — допустим, 87,26 EUR.

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

При завершении оплаты пользователю отображается информация о сумме в исходной валюте, сумме в валюте, выбранной пользователем, и о курсе конвертации. Так, для приведённого примера с оплатой в размере 95,00 USD актуальна следующая информация:

• сумма оплаты в выбранной пользователем валюте — 87,26 EUR;
• сумма оплаты в исходной валюте — 95,00 USD;
• курс евро к доллару США.

Эта же информация отображается на платёжной форме и при отклонении оплаты с конвертацией.

Рис.: Страница результата оплаты с информацией о конвертации

Подключение

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

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

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