Currency support
An overview of currencies supported by Recurly — including gateway-specific currency availability, ISO standard currencies, and zero decimal currency handling.
Recurly supports a wide range of currencies to help merchants accept payments in customers' local currency. The specific currencies available depend on your payment gateway — some gateways support all Recurly currencies, while others have a more limited set.
Available on all Recurly plans
Prerequisites
- Access to one or more supported payment gateways.
- Gateway(s) set up and configured in Recurly.
Limitations
- Supported currencies depend on the payment gateway(s) you have configured.
Definition
Recurly's currency support lets merchants manage transactions in a wide range of currencies — essential for businesses operating across multiple countries or targeting customers in different regions. Offering prices in local currency can improve customer satisfaction and conversion rates.
Note Not all gateways support all currencies. Check the individual gateway's documentation for its supported currencies. When "All available" is listed below, the gateway supports every Recurly currency in the ISO standard list.
Gateway currency support
| Gateway | Supported currencies |
| Adyen | Most currencies, with special handling for Icelandic Króna (ISK) and Chilean Peso (CLP). Does not support Indonesian Rupiah (IDR) or Cape Verdean Escudo (CVE). |
| Braintree | Every currency PayPal supports — limited to PayPal's own currency list. |
| Commerce Hub by Fiserv | All available. |
| CyberSource | All available. |
| FreedomPay | All available. |
| Stripe | All available. When using Gateway Failover, confirm the currency is enabled in both Stripe and Recurly. |
| Worldpay Global eCommerce | All available, except Dominican Peso (DOP) and Nicaraguan Córdoba (NIO). |
ISO standard currencies
Recurly supports the following ISO 4217 currency codes across its gateways. Codes marked with an asterisk (*) are zero decimal currencies.
| Currency | |||||
|---|---|---|---|---|---|
| AED | BZD | GIP | LRD | PEN | TJS |
| AMD | CAD | GMD | LSL | PGK | TOP |
| AOA | CHF | *GNF | MAD | PHP | TRY |
| ARS | *CLP | GTQ | MDL | PKR | TTD |
| AUD | CNY | GYD | MKD | PLN | TWD |
| AWG | COP | HKD | MNT | *PYG | TZS |
| AZN | CRC | HNL | MOP | QAR | UAH |
| BAM | CVE | HRK | MUR | RON | *UGX |
| BBD | CZK | HTG | MVR | RSD | USD |
| BDT | *DJF | HUF | MWK | RUB | UYU |
| BGN | DKK | IDR | MXN | *RWF | UZS |
| *BIF | DOP | ILS | MYR | SAR | VEF |
| BMD | DZD | INR | MZN | SBD | *VND |
| BND | EGP | JMD | NAD | SCR | *VUV |
| BOB | ETB | *JPY | NGN | SEK | WST |
| BRL | EUR | KES | NIO | SGD | *XAF |
| BSD | FJD | KGS | NOK | SHP | XCD |
| BWP | FKP | *KMF | NPR | SLL | *XOF |
| BZD | GBP | *KRW | NZD | SOS | *XPF |
| CAD | GEL | KYD | PAB | SRD | YER |
| CHF | GHS | KZT | PEN | SVC | ZAR |
Note Currencies marked with an asterisk (*) are zero decimal currencies supported by Recurly.
Zero decimal currencies
Zero decimal currencies do not use decimal places in their monetary values. These are common in regions where fractional currency units aren't used in everyday transactions. For example, Japanese Yen (JPY) prices are expressed as whole numbers — an item costs 1,000 JPY, not 1,000.00 JPY.
When processing zero decimal currencies in Recurly, amounts are handled as whole numbers with no fractional component.
Zero decimal currencies supported by Recurly
| Currency | |||||
|---|---|---|---|---|---|
| BIF | CLP | DJF | GNF | JPY | KMF |
| KRW | PYG | RWF | UGX | VND | VUV |
| XAF | XOF | XPF |
Updated 15 days ago
Did this page help you?