Order Currencies
Order Currency & Automated Currency Conversion
Every API request requires an Order Currency. When the merchant-defined Order Currency differs from the required Payment Currency, our Automated Currency Conversion engine handles the exchange on the fly, ensuring a localized payment experience without manual intervention.
The Concept
In our processing flow, we distinguish between two mandatory fields:
- Order Currency: Defined by the merchant in the API request. This sets the base value of the transaction.
- Payment Currency: The currency in which the final transaction is processed and paid. Automated Currency Conversion is the core logic that bridges these two values. It allows you to maintain consistent pricing in your preferred Order Currency, while we manage the real-time FX conversion whenever the Payment Currency requires a different denomination.
How It Works
The conversion process is seamless and occurs instantly during the transaction initiation:
- API Input: You send the API request with the
amountand the mandatoryorder_currency. - On-the-Fly Conversion: If the
order_currencyis different from thepayment_currency, the Automated Currency Conversion engine is triggered. - Real-Time Rate Application: The system applies the current market exchange rate to determine the final amount.
Payment Amount = Order Amount X FX Rate
- Transaction Completion: The payer completes the transaction in the Payment Currency, while the transaction remains tied to your original Order Currency value for reporting.
Supported Order Currencies
The following currencies are supported as the order_currency value in your API requests:
| Code | Currency Name |
|---|---|
| BRL | Brazilian Real |
| CAD | Canadian Dollar |
| CHF | Swiss Franc |
| CLP | Chilean Peso |
| COP | Colombian Peso |
| CRC | Costa Rican Colón |
| DOP | Dominican Peso |
| EUR | Euro |
| GBP | British Pound |
| GTQ | Guatemalan Quetzal |
| HNL | Honduran Lempira |
| MXN | Mexican Peso |
| PAB | Panamanian Balboa |
| PEN | Peruvian Sol |
| USD | US Dollar |
| UYU | Uruguayan Peso |
Note: While order_currency sets the valuation of the request, it is independent of your settlement configuration. To review how these funds are deposited into your account, please refer to your Merchant Settlement Settings.