Currencies
Recurly supports 141 currencies, letting you price plans independently per currency and present charges to customers in their preferred local denomination — no conversion performed.
Recurly lets you accept payments in up to 141 currencies, so you can price your plans independently for each market and present charges to customers in their local denomination. Recurly passes the currency amount you define directly to your payment gateway — no conversion is performed on our end.
Definition
Multi-currency support lets you offer subscription plans and coupons priced independently in each currency you accept. When a customer checks out, Recurly presents the amount in the currency you've defined and passes it to your payment gateway in that same currency for processing. Recurly does not perform currency conversion — your merchant account may settle the transaction in a different currency depending on your gateway configuration.
Key benefits
Setting up multiple currencies
Enable multi-currency support and define accepted currencies
After multi-currency support is activated on your Recurly account, add the currencies you want to accept. Once a currency is enabled, you can set pricing for your subscription plans and coupons in that currency.
Update existing plans with prices in each currency
Add pricing in every accepted currency to your existing subscription plans. Prices are defined independently per currency, giving you full control over each market.
Confirm gateway compatibility
Verify that the currencies you've enabled are supported by your configured payment gateways. The Currencies Configuration page shows which currencies your current gateway setup can handle.
Enable zero-dollar authorizations
Recurly recommends enabling zero-dollar authorization support on all gateway accounts used to process non-USD currencies. This prevents invalid amount errors that can result from exchange rate differences. See the zero-dollar authorizations section of our gateway documentation for setup steps.
Specifying a currency
How currency is determined at checkout depends on which integration method you're using.
Checkout
When multiple currencies are accepted, Recurly's Checkout hosted page offers several options for currency selection. See Currencies on Checkout for details.
Hosted Payment Pages
Legacy Hosted Payment Pages default to the most appropriate currency for the customer based on their country, detected via automatic geo-IP lookup. See Currencies on Hosted Payment Pages for details.
Recurly.js
Recurly.js forms accept a currency parameter, letting you specify the currency when creating a new subscription or transaction. See the Recurly.js documentation for details.
Invoices
All charges and credits on an invoice are in the same currency. Because Recurly doesn't perform currency conversion, charges in different currencies cannot be combined on the same invoice.
Subscriptions
Currency is stored at the subscription level when the subscription begins. The currency of an active subscription cannot be changed. To switch a subscriber to a different currency, the current subscription must be canceled and a new one created.
Payment gateway support
Some gateways require separate accounts to collect payments in different currencies. For a full list of currencies supported by each gateway integration, see currency support by gateway. Contact your gateway directly for account-specific information.
| Gateway | Multi-currency notes |
| Authorize.Net | Accepts one currency per gateway account. To accept more than one currency, you'll need to open multiple accounts with the gateway. |
| Braintree | Supports multiple currencies. Each currency requires a separate merchant account ID. |
| CyberSource | Supports multiple currencies with a single account. Contact CyberSource to enable additional currencies. |
| PayPal Payments Pro / PayFlow Pro | Currencies are automatically configured for US, CA, and UK merchants based on your PayPal account settings. Note: Japanese yen (JPY) is not currently supported by Recurly. |
| Stripe | Supports multiple currencies with a single Stripe account. You'll need to add a separate gateway instance (using the same credentials) for each currency you're approved to accept. |
| Vantiv | Supports multiple currencies. Each currency requires a separate account. |
Tax support
Tax region support is configured independently from currency enablement — enabling a currency does not automatically enable tax collection for that region. For information on supported tax regions, see the tax documentation.
Updated about 1 month ago