{"__v":3,"_id":"5665e16f63109d0d0036ba19","category":{"__v":29,"_id":"5665dfa0e93ae70d00b96a2a","pages":["5665dfca1b6559190020ae7d","5665e000e93ae70d00b96a2c","5665e0a9e93ae70d00b96a32","5665e0c7d8a06b170063f311","5665e12bd7490819006a503f","5665e1431b6559190020ae86","5665e16f63109d0d0036ba19","5665e192b6c0f60d00eae53d","5665e29ed8a06b170063f315","5665e2b9d7490819006a5044","566630b03360850d00336cb6","566631547cc81e0d00253f1a","566631b38744940d004c3eff","5666328b2342100d007dcbf7","566729ab5d00370d00ede6c2","56672a86f672550d0008523a","56672fd9ee53940d00516267","5667335f5d00370d00ede6db","566735cf6819320d000c2f05","5667362b32dd550d00f3924b","5667373d6819320d000c2f0a","566737c232dd550d00f3924e","5667380ad784a70d00397ce1","56673ee86819320d000c2f1b","56673f95ee53940d0051629d","56673feed784a70d00397cec","5667431e66debc1700503f6a","5667436d66debc1700503f6d","566745066819320d000c2f3d"],"project":"56450a342229d7170010928a","version":"56450a342229d7170010928d","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-12-07T19:36:00.783Z","from_sync":false,"order":2,"slug":"configuration","title":"Configuration"},"parentDoc":null,"project":"56450a342229d7170010928a","user":"55648cf93b87582b003ab8b1","version":{"__v":9,"_id":"56450a342229d7170010928d","project":"56450a342229d7170010928a","createdAt":"2015-11-12T21:52:52.685Z","releaseDate":"2015-11-12T21:52:52.684Z","categories":["56450a352229d7170010928e","56450a472c74cf1900da48ca","565def2677f0090d005819bb","5665dfa0e93ae70d00b96a2a","5665e3db1b6559190020ae8c","5665e47763109d0d0036ba5a","5690123f18c3920d00be8b1c","56944016d8c04d1700e5ae20","569447891005590d0062cace"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"updates":[],"createdAt":"2015-12-07T19:43:43.760Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":7,"body":"## Requirements\n\nMulti Currency support [is available in the Recurly Enterprise edition][1]. You may run transactions in more than one currency through one or more payment gateways that accept the currencies you wish to collect.\n\n[1]: https://app.recurly.com/go/recurly_account/addons\n\n## Configuration\n\n1. 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.\n\n2. After configuring the currencies you accept, update [your existing subscription plans][2] with pricing in all your currencies. When editing pricing, you can define prices independently by currency.\n\n3. Finally, verify the currencies you accept are supported by your configured payment gateways. The [Currencies Configuration page][4] displays the currencies supported by [your current gateway configuration][5].\n\n[2]: https://app.recurly.com/go/plans\n[3]: https://app.recurly.com/go/coupons\n[4]: https://app.recurly.com/go/configuration/currencies\n[5]: https://app.recurly.com/go/configuration/payment_gateways\n\n## Specifying a Currency\n\n### Hosted Payment Pages\n\nIf 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 to your default currency.\n\n### Recurly.js\n\nRecurly.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](https://docs.recurly.com/js/) for more information.\n\n### API\n\nAll requests made to the API with a monetary amount must also specify a currency. This includes:\n\n* [Adjustments][6] (charges and credits),\n* [Subscriptions][7]\n* [Transactions][8]\n\n[6]: /docs/adjustments\n[7]: /docs/subscriptions\n[8]: /docs/transactions\n\n### Supported Currencies\n\n* Australian Dollars (AUD)\n* Brazilian Real (BRL)\n* British Pounds (GBP)\n* Canadian Dollars (CAD)\n* Czech Korunas (CZK)\n* Danish Krones (DKK)\n* Euros (EUR)\n* Hong Kong Dollars (HKD)\n* Hungarian Forints (HUF)\n* Indian Rupee (INR)\n* Israeli New Sheqel (ILS)\n* Mexican Peso (MXN)\n* Norwegian Krones (NOK)\n* New Zealand Dollars (NZD)\n* Polish Złoty (PLN)\n* Singapore Dollars (SGD)\n* Swedish Kronas (SEK)\n* Swiss Francs (CHF)\n* South African Rand (ZAR)\n* United States Dollars (USD)\n\n## Invoices\n\nAll 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*.\n\n## Subscriptions\n\nWhen 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.\n\n## Multi Currency and Payment Gateway Support\n\nSome gateways may require that you open additional accounts in order to collect additional currencies. Because currency support varies by payment gateway, please contact your gateway for more information specific to your account.\n\n* Authorize.Net accepts one currency per gateway account. To accept more than one currency with this gateway, you will need to open multiple accounts with the payment gateway. Please contact your payment gateway to enquire about accepting multiple currencies.\n* Braintree supports multiple currencies. Each currency requires a separate merchant account ID.\n* CyberSource supports multiple currencies with a single account. Please contact CyberSource to enable additional currencies.\n* Litle & Co. supports multiple currencies. Each currency requires a separate account.\n* PayPal Website Payments Pro and PayFlow Pro currencies are automatically configured for US, CA, and UK merchants based on the settings in your PayPal account (with the exception of the Japanese yen, which Recurly does not currently support).\n* SagePay supports multiple currencies with a single account. Please contact SagePay to enable additional currencies.\n* Wirecard supports multiple currencies with a single account. Please contact Wirecard to enable additional currencies.","excerpt":"Companies serving broad geographic regions can benefit greatly by letting their customers pay in their local currency. Recurly makes it easy to offer your plans in multiple currencies so that your customers can choose their preferred denomination.\n\nRecurly presents the currency amount specified by you and submits the transaction to your payment gateway in the same currency. Your merchant account may settle the transaction in a different currency, _e.g._ US Dollars for US companies.\n\nRecurly does not perform currency conversion.","slug":"currencies","type":"basic","title":"Currencies"}

Getting Started

Reference

Configuration

3rd Party Integrations

Security

Currencies

Companies serving broad geographic regions can benefit greatly by letting their customers pay in their local currency. Recurly makes it easy to offer your plans in multiple currencies so that your customers can choose their preferred denomination. Recurly presents the currency amount specified by you and submits the transaction to your payment gateway in the same currency. Your merchant account may settle the transaction in a different currency, _e.g._ US Dollars for US companies. Recurly does not perform currency conversion.
## Requirements Multi Currency support [is available in the Recurly Enterprise edition][1]. You may run transactions in more than one currency through one or more payment gateways that accept the currencies you wish to collect. [1]: https://app.recurly.com/go/recurly_account/addons ## 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][2] with pricing in all your currencies. When editing pricing, you can define prices independently by currency. 3. Finally, verify the currencies you accept are supported by your configured payment gateways. The [Currencies Configuration page][4] displays the currencies supported by [your current gateway configuration][5]. [2]: https://app.recurly.com/go/plans [3]: https://app.recurly.com/go/coupons [4]: https://app.recurly.com/go/configuration/currencies [5]: https://app.recurly.com/go/configuration/payment_gateways ## 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 to 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](https://docs.recurly.com/js/) for more information. ### API All requests made to the API with a monetary amount must also specify a currency. This includes: * [Adjustments][6] (charges and credits), * [Subscriptions][7] * [Transactions][8] [6]: /docs/adjustments [7]: /docs/subscriptions [8]: /docs/transactions ### Supported Currencies * Australian Dollars (AUD) * Brazilian Real (BRL) * British Pounds (GBP) * Canadian Dollars (CAD) * Czech Korunas (CZK) * Danish Krones (DKK) * Euros (EUR) * Hong Kong Dollars (HKD) * Hungarian Forints (HUF) * Indian Rupee (INR) * Israeli New Sheqel (ILS) * Mexican Peso (MXN) * Norwegian Krones (NOK) * New Zealand Dollars (NZD) * Polish Złoty (PLN) * Singapore Dollars (SGD) * Swedish Kronas (SEK) * Swiss Francs (CHF) * South African Rand (ZAR) * United States Dollars (USD) ## 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. Because currency support varies by payment gateway, please contact your gateway for more information specific to your account. * Authorize.Net accepts one currency per gateway account. To accept more than one currency with this gateway, you will need to open multiple accounts with the payment gateway. Please contact your payment gateway to enquire about accepting multiple currencies. * Braintree supports multiple currencies. Each currency requires a separate merchant account ID. * CyberSource supports multiple currencies with a single account. Please contact CyberSource to enable additional currencies. * Litle & Co. supports multiple currencies. Each currency requires a separate account. * PayPal Website Payments Pro and PayFlow Pro currencies are automatically configured for US, CA, and UK merchants based on the settings in your PayPal account (with the exception of the Japanese yen, which Recurly does not currently support). * SagePay supports multiple currencies with a single account. Please contact SagePay to enable additional currencies. * Wirecard supports multiple currencies with a single account. Please contact Wirecard to enable additional currencies.