Currency conversion

Overview

In general, a payment may involve three currencies: customer account currency, payment currency, and merchant account currency. If all these currencies are the same, there is no need for currency conversion; otherwise you need to convert the payment amount between currencies.

Let's say that the customer uses their dollar-denominated card to pay a certain amount in euros to merchant whose account is denominated in pound sterling. The payment amount is consecutively converted from dollars to euros, and then from euros to pounds. The first conversion operation is performed by the issuer. The second conversion operation is performed by the EtoPlatezhi payment platform.

This option uses exchange rates set by EtoPlatezhi. To learn more about exchange rates, contact your account manager. You can get the information about conversion operations performed by the payment platform from the callbacks with payment results, from Dashboard, or from regular reports sent to email addresses you specify. We recommend that you use this information for reconciliation with EtoPlatezhi because issuers and alternative payment systems use the merchant account currency to keep record of the merchant transactions.

It should be also taken into account that the operation amount and the amount actually debited from the customer's account may not be the same since currency exchange rates usually differ on the date when the payment was initiated and the date when the funds were actually debited. For conversion and compensation in such cases, the customer should contact the card issuer or the organization where the account is opened.

To find out which payment methods and in which currencies support conversion, please refer to the description of this method or to the EtoPlatezhi account manager.

Setup

You do not need to update your web service to support automatic payment currency selection.

Use

Automatic payment currency selection does not require any additional actions on your part and is automatically performed during the payment procedure.

Currency conversion information is included in payment result callbacks: the operation object contains the sum_initial object that specifies the amount and the initial currency and the sum_converted object that specifies the amount and the currency after the conversion operation. For more information about these objects, see Handling callbacks.

The following example shows information about a purchase with a conversion operation in which 100 USD are converted into 519.41 PHP.

 {
        "project_id": 239,
        "payment": {
            "id": "EPfa87-bcfd",
            "type": "purchase",
            "status": "success",
            "date": "2020-03-06T14:11:00+0000",
            "method": "Philippines banks",
            "sum":{ 
              "amount":10000, // Initially requested amount
              "currency":"USD" // Initial requested currency
            },
            "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, // Initially requested amount
                "currency":"USD" // Initially requested currency
            },
            "sum_converted": {
                "amount":519410, // Amount after conversion
                "currency":"PHP" // Automatically selected target currency
            },
            "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=="
}