Requirements

Multi Currency support is available in the Recurly Professional, Elite, and Enterprise plans. You may run transactions in more than one currency through one or more payment gateways that accept the currencies you wish to collect.

Configuration

1. Once Multi Currency support is enabled on your Recurly account, you can then specify which currencies you want to accept for your account. When a currency is added to your accepted list, you may then define pricing for your subscription plans and coupons using the new currency.

2. After configuring the currencies you accept, update your existing subscription plans with pricing in all your currencies. When editing pricing, you can define prices independently by currency.

3. Verify the currencies you accept are supported by your configured payment gateways. The Currencies Configuration page displays the currencies supported by your current gateway configuration.

4. Finally, Recurly recommends enabling support for zero dollar authorizations across any and all gateway accounts being used to process any non-USD currencies. Due to differences in exchange rates, certain currencies may return invalid amount errors when zero dollar verifications are not used. To enable zero dollar verifications, please see this section of our documentation.

Specifying a Currency

Hosted Payment Pages

If you accept multiple currencies, the hosted payment pages will default to the most appropriate currency for your customer, based on their country. The customer's country is determined with an automatic geo-IP address lookup. The customer may select a different currency before completing the order. If the most appropriate currency is not available, we will use your default currency.

Recurly.js

Recurly.js forms accept a currency parameter so you can specify the currency when creating a new subscription or transaction. Please see the Recurly.js documentation for more information.

API

All requests made to the API with a monetary amount must also specify a currency. This includes:

• Adjustments (charges and credits),
• Subscriptions
• Transactions

Supported Currencies

Recurly supports 141 currencies across our gateway integrations. See the full list of currencies supported by gateway here.

Note: Recurly recommends using zero dollar authorizations for any non-USD currencies to avoid any issues with verifications.

Invoices

All charges and credits on an invoice will be in the same currency. Because Recurly does not perform currency conversion, Recurly will not combine charges of different currencies on the same invoice.

Subscriptions

When a new subscription starts, the currency is saved on the subscription level. You may not change the currency of the subscription after the subscription has started: you must terminate the subscription and start another one in its place.

Multi Currency and Payment Gateway Support

Some gateways may require that you open additional accounts in order to collect additional currencies. A list of currencies supported by each of our gateway integrations can be seen here. Because currency support varies by payment gateway, please contact your gateway for more information specific to your account.

Tax Support

Tax region support is enabled separately of currency enablement. For more information on the tax regions currently supported on Recurly, please review our tax documentation.