Currencies

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.

Available on all Recurly plans

1Definition 2Key benefits 3Setting up multiple currencies 4Specifying a currency 5Payment gateway support 6Tax support

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

Reach a global audience Support for 141 currencies opens your business to customers worldwide, letting them pay in their preferred local denomination.

Cleaner financial management All charges and credits on a single invoice share the same currency, keeping your books straightforward and reducing reconciliation overhead.

Automatic currency selection Hosted Payment Pages automatically select the most appropriate currency based on the customer's geo-location, improving the checkout experience and conversion rates.

Independent pricing per currency Define prices separately for each currency so you can optimize your pricing strategy for each market without being locked into a fixed exchange rate.

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.