Currencies

Use currency conversion in your e-commerce business or marketplace.

Use the currency_code field to specify the currency code in a request, for example:

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

Currency conversion

The service converts the transaction currency when required. For example, if an invoice must use a currency different from the transaction currency, the service converts the transaction currency to the required currency. If Canada requires an invoice to use Canadian dollars (CAD), for example, the service converts the transaction currency to CAD.

If no currency conversion is required, the service does not convert the transaction currency. You can send any supported currency to the service, and it retains that currency when no conversion is needed.

The API response includes information about any currency conversion, including the target currency, conversion date, and exchange rate source. In the following example, the service converted the transaction currency to British pounds (GBP), using an exchange rate from the Bank of England:

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

Supported currencies

The service supports the following currencies:

CurrencyCurrency code
United Arab Emirates DirhamAED
Australian DollarAUD
Bulgarian LevBGN
Bahraini DinarBHD
Canadian DollarCAD
Swiss FrancCHF
Czech KorunaCZK
Danish KronerDKK
EuroEUR
British PoundGBP
ForintHUF
RupiahIDR
Icelandic KronaISK
Japanese YenJPY
WonKRW
Moldovan LeuMDL
Malaysian RinggitMYR
Norwegian KroneNOK
New Zealand DollarNZD
Oman RialOMR
Polish New ZlotyPLN
Romanian New LeuRON
Saudi Arabian RiyalSAR
Swedish KronerSEK
BahtTHB
New Turkish LiraTRY
US DollarUSD
Uzbekistani SomUZS
South African RandZAR

Did this page help you?