Currency conversion is an important feature of any ecommerce business.

To specify the currency code in a request, you use the currency_code field. For example:

{
    "transaction": {
        "tax_timestamp": "2025-03-01T12:00:00Z",
        "description": "Transaction description",
        "currency_code": "EUR",
        "buyer_name": "Test buyer",

Currency conversion

A transaction currency is converted in different scenarios. For example, If the invoice is required to be different to the transaction currency, it is converted into the required currency. For example, if Canada requires all invoices in Canadian dollars (CAD), the transaction currency is converted to CAD.

If none of these actions are performed, no currency conversion is done in the transaction. You can pass any currency into the service and it will not be converted if one of the above does not occur.

The information about how the currency is converted is specified in the responses sent by the API. In this example, the currency was converted to British Pound (GBP) on February 28th 2021 and the rate was from the Bank of England:

                "additional_currencies": {
                    "invoice": {
                        "amount": 82.59,
                        "currency_code": "GBP",
                        "fx_date": "2025-02-28T12:00:00Z",
                        "fx_rate": 0.825900231252,
                        "fx_source": "source_bankofengland",
                        "total_amount": 99.11,
                        "tax_amount": 16.52
                    }

Supported currencies

The following table lists the currencies are supported.