The following types of currencies are used in the service:

• Settlement Currency: This is the currency used to settle payments.
• Report Currency: This is the currency used in reports.
• Transaction Currency: This is the currency specified in the currency_code field in API requests. This is is the currency of the transaction.

You can use the Currencies dictionary to return a full list of currencies.

Currency Conversions

🚧

Warning

The rates that are used for currency conversions are retrieved from third parties. As such, we do not guarantee that these rates are accurate.

API Integration

You use the currency_code field to specify the currency in transactions. For example:

 {
      "transaction": {
          "transaction_lines": [
              {
                  "custom_id": "line1",
                  "amount": 100
              }
          ],
          "buyer_ip": "109.121.15.46",
          "currency_code": "EUR",
          "billing_country_code": "BE",
          "buyer_credit_card_prefix": "424242424",
      },
      "private_token": "priv_***********"
  }

The information about the currency conversion is returned in the additional_currencies fields in the API responses:

                  "additional_currencies": {
                    "invoice": {
                        "fx_rate": 3.75,
                        "amount": 375.0,
                        "currency_code": "SAR",
                        "total_amount": 393.75,
                        "tax_amount": 18.75
                    }