# Конвертация валют {#ru_Gate_Conversion .concept}

статья о порядке проведения через Gate платежей с применением разных валют и встроенной в этот процесс конвертацией

## Общая информация {#section_g2z_3kl_bbb .section}

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

Допустим, пользователь выбирает рублёвую карту для перевода средств в евро на счёт мерчанта, открытый в фунтах стерлингов. В таком случае сумма платежа последовательно конвертируется из рублей в евро и из евро в фунты. Первый из этих пересчётов выполняется на стороне эмитентаили альтернативной платёжной системы\(и не контролируется со стороны Ecommpay\), а второй — на стороне платёжной платформы Ecommpay.

Мерчант также может проводить конвертацию на своей стороне и в запросах на проведение операций отправлять сразу сконвертированную сумму в нужной валюте.

Для платежей, проводимых через Gate, в платёжной платформе поддерживается *конвертация с выбором валюты мерчантом* — без предоставления пользователю возможности выбора валюты платежа.Такая конвертация поддерживается при проведении выплат, а также разовых оплат с использованием любых платёжных методов. Для конвертации используются валютные курсы, устанавливаемые Ecommpay. С вопросами о курсах и порядке их применения можно обращаться к курирующему менеджеру Ecommpay.

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

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

Чтобы узнать, какие платёжные методы в какой валюте поддерживают конвертацию, следует обращаться к описанию этого метода или к курирующему менеджеру Ecommpay.

## Подключение {#section_u2c_qrk_kjb .section}

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

## Использование {#section_zh4_qrk_kjb .section}

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

Информация о выполненной конвертации передаётся в оповещениях о результатах платежей — в объекте `operation`, где в объекте `sum_initial` указываются исходные сумма и валюта, а в объекте `sum_converted` — конечные сумма и валюта с учётом конвертации. Эти объекты входят в стандартную структуру оповещения, описание которой представлено в разделе [Работа с оповещениями](ru_platform_callbacks.md#).

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

```language-json
 {
        "project_id": 239,
        "payment": {
            "id": "EPfa87-bcfd",
            "type": "purchase",
            "status": "success",
            "date": "2020-03-06T14:11:00+0000",
            "method": "Philippines banks",
            "sum":{ 
              "amount":10000, // Сумма, переданная в запросе
              "currency":"USD" // Код исходной валюты, переданный в запросе
            },
            "description": ""
        },
        "operation": {
            "id": 464,
            "type": "sale",
            "status": "success",
            "date": "2020-03-06T14:11:00+0000",
            "created_date": "2020-03-06T14:10:34+0000",
            "request_id": "f6ab99eb0940e43a774b969cb74a88ef08eec6c8951-00000001",
            "sum_initial": {
                "amount":10000, // Сумма, переданная в запросе
                "currency":"USD" // Код исходной валюты, переданный в запросе
            },
            "sum_converted": {
                "amount":519410, // Сумма с учётом конвертации
                "currency":"PHP" // Код конечной валюты
            },
            "code": "0",
            "message": "Success",
            "provider": {
                "id": 1369,
                "payment_id": "7QKID3P3",
                "auth_code": "",
                "endpoint_id": "BOG",
                "date": "2020-03-06T14:10:54+0000"
            }
        },
        "signature": "YZKXHr2ZdK3tPqiMzPpSJZ...+WGku5dANQAVWPteHKmwzMQ+mvGoA=="
    }
}
```

**На уровень выше:**[Вспомогательные процедуры](ru_gate_procedures.md)