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:
| Currency | Currency code |
|---|---|
| United Arab Emirates Dirham | AED |
| Australian Dollar | AUD |
| Bulgarian Lev | BGN |
| Bahraini Dinar | BHD |
| Canadian Dollar | CAD |
| Swiss Franc | CHF |
| Czech Koruna | CZK |
| Danish Kroner | DKK |
| Euro | EUR |
| British Pound | GBP |
| Forint | HUF |
| Rupiah | IDR |
| Icelandic Krona | ISK |
| Japanese Yen | JPY |
| Won | KRW |
| Moldovan Leu | MDL |
| Malaysian Ringgit | MYR |
| Norwegian Krone | NOK |
| New Zealand Dollar | NZD |
| Oman Rial | OMR |
| Polish New Zloty | PLN |
| Romanian New Leu | RON |
| Saudi Arabian Riyal | SAR |
| Swedish Kroner | SEK |
| Baht | THB |
| New Turkish Lira | TRY |
| US Dollar | USD |
| Uzbekistani Som | UZS |
| South African Rand | ZAR |
Updated 15 days ago
