Multi-currency

With multi-currency, Shopify customers are able to checkout in their currency and continue to be charged by the currency after their initial checkout. Multi-currency is enabled automatically upon activation of Shopify Markets. One currency can be used for an address and cannot be changed, as the currency for the customer’s address has been set during the initial checkout. 

This guide explains how Shopify’s multi-currency setting currently works with Recharge and any limitations that can arise.

Before you start

• Multi-currency is supported by Recharge. The feature is enabled immediately upon activation of Shopify Markets. 
• For the best user experience, the Prima customer portal theme is recommended for multi-currency. Novum and Theme Engine users will experience partial multi-currency usability. Currency in the customer portal displays as the store’s default currency. However, if the customer is adding or swapping products, a conversion will happen and the customer will be charged in their local currency pricing.
• If you’re using a custom store and are interested in using multi-currency, contact Recharge support.
• Recharge Checkout on Shopify does not work with Shopify’s multi-currency feature. Orders submitted to checkout retain the price from the currency conversion but are processed using the store’s main currency. Refer to Identifying your store’s Recharge checkout platform for more information.

Multi-currency overview

Multi-currency allows customers to view and pay for their subscriptions in their preferred currency and is enabled automatically upon activation of Shopify Markets. If you enable multi-currency on Shopify, customers are charged on a recurring basis with the same price and currency that was used at checkout.

To get started using multiple currencies, Shopify Markets will need to be configured:

1. In the Shopify admin, click Settings and select Markets. Review Shopify’s guide on Managing markets for your multi-currency pricing setup. 
   • You can also refer to Shopify’s Pricing in local currencies for more information on selling in local currencies. 
2. After you’ve completed setting up Shopify Markets, multi-currency settings in Recharge will automatically be enabled. 

Select currency when creating a new address

There is the ability to select a currency when creating new addresses in the merchant and customer portals.

To add a currency to a new address:

1. In the merchant portal click Customers, then search and select your customer. 
2. Click Add an Address and under Currency, select one of your enabled currencies to add to the new address.
   
3. Fill out the address information. Note the address will not save unless the customer has a valid zip code. 
4. Select Add Address to save your changes. 

Compatible features

When using multi-currency, these features are fully supported: 

• Automatic currency conversion is used to calculate product pricing when adding or swapping products in the merchant and customer portal. Refer to Multi-currency conversion and risk for more information. 
• Consistently displayed currency UI experience in merchant and customer portal and currency displays correctly when using custom widgets.
• Percentage discounts are fully supported. 
• Exports including multi-currency related data.
• Ability to select a currency when creating new addresses in the merchant and customer portal. Customers can have a different currency assigned per address. 
• If you enable multi-currency on Shopify, customers are charged on a recurring basis with the same price and currency that was used at checkout
• Updates using the Bulk Updater tool must be grouped by currency
  • Refer to Using the Bulk Updater Tool for more information
• Shopify Markets pricing supported on checkout and recurring orders
• Shopify 2.0 subscription widget supports Shopify Markets pricing
• Shipping rates are charged in customer’s presentment currency using the rates set up in Shopify. Third-party shipping integrations including Recharge shipping zones and rates are supported. 
• Recharge and Shopify taxes, including Avalara. Information is automatically leveraged using the taxes configured on your e-commerce platform. 
• Klaviyo Recharge metrics are currency aware. 
• Recharge Notifications display the customer's currency for Subscription activated, Upcoming charge, 1+ year upcoming charge, and Refund notifications using the{{subtotal_price| amount_with_currency(charge_currency, display_currency_code=True)}}variable. 
  • Stores created after December 7th will automatically have variables that support stores selling in multiple currencies.
  • Stores created before December 7th will need to manually update templates to support multiple currencies.
    • If you have not made custom changes to your notification templates, you can select use default language to include this variable automatically.

Upcoming feature compatibility

• Affinity customer portal theme.

Limitations

Multi-currency allows customers to view and pay for their subscriptions in their preferred currency. There are ongoing efforts to develop and consolidate the multi-currency features offered by Recharge. 

• Legacy Workflows that adjust product or shipping prices are not multi-currency compatible. Price overrides are adjusted regardless of the customer’s currency.
  • For example, if you have a workflow set to change a price to 10.00, the price change will be treated as 10 pesos, 10 USD, 10 EURs, etc.
• Workflows that leverage the following new workflow templates will only run on addresses that use stores’ default currency. Workflows using these templates will not run on multi-currency addresses: 

  • One-off SKU swap 

  • Monthly SKU swap

  • Order Sequence SKU swap 

  • Order Sequence Gift 

• This means workflows using these templates will not run on multi-currency addresses
• Bundles are not compatible as Shopify does not allow order editing on orders with differing currencies than the stores native currency.

• Shopify Checkout Integration JavaScript subscription widget. Merchants should use the Shopify 2.0 Subscription widget or build a custom widget.

• Subscriptions cannot be moved from one customer address to another if the presentment currencies are different. To change currencies cancel the existing subscription and add a new subscription.
  • If you have 20 or more customers to move to a new currency, contact Recharge support.
• Fixed-based discount codes will not work on recurring orders. Fixed-based discount codes applied through the customer or merchant portals can only be applied to addresses that share the store’s currency. See Shopify’s guide on Discounts when using multiple currencies for more information. 
• Foreign Exchange rate may differ slightly between Shopify and Recharge. Recharge uses a conversion rate snapshot which is captured on a daily basis. This source may differ from Shopify’s and other eCommerce platforms' conversion rates.
• If you have a Braintree or PayPal via Braintree setup within Recharge, multi-currency is not currently supported for Braintree payment methods. 
  • Customers and merchants are blocked from adding a Braintree payment method to an address that is in a presentment currency different from the store currency.

FAQ

How does Recharge analytics work if I sell in multi-currency?

Recharge analytics will display in the store's default currency. Multi-currency charges are converted into the store’s default currency. Each transaction is converted based on the day the transaction occurred.

Why do I see charge amount discrepancies in my analytic data?

Stores selling in multi-currency prior to January 24, 2023 are expected to see discrepancies in charge amounts reported in the Recharge Revenue KPIs analytics, Product SKU, and Product Variant dashboards. These charges use the customer's presentment currency charged amount while displaying it as the default store currency amount.

This is a display limitation as multi-currency wasn’t yet fully supported. Our recommendation is to refer to Shopify’s reporting for any analytic data for multi-currency prior to January 24, 2023. Charge amounts will always be converted to the default store currency for stores using multi-currency after January 24, 2023.

How do I make bulk price updates for customers with varying currencies?

Updates using the Bulk Updater tool must be grouped by currency. Stores with multi-currency customers can follow the instructions listed in Using the Bulk Updater Tool to update pricing. 

Can I settle in more than one currency?

Stores can only add one payment processor account per Shopify and Recharge store. While you can charge your customers in multiple currencies, the payments will settle in the store currency.

Why are there discrepancies between the amounts reported in Recharge and price the customer paid? 

Historically, the charge line item details (taxes, shipping, and total) were presented in the store default currency regardless of the customer's presentment currency. This caused discrepancies between the amounts reported in Recharge vs. the price the customer paid and the line item amounts reported in the Shopify order details.

For multi-currency charges processed after January 24, 2023, all merchants using Shopify Checkout Integration with multiple currencies can now view:

• Exact amount paid for charge line items (as reported in Shopify order details).
• Customer’s presentment currency in which the amount was paid.

All processed charge details will display the charge details in the customer's presentment currency and showcase what they paid. Our recommendation is to refer to Shopify’s reporting for multi-currency charge amounts prior to January 24, 2023.

How do I enable different currencies?

Update your currencies directly on Shopify and Recharge will update your available currency list automatically. Custom stores can enable currencies using the Store API object.

What if I decide to stop selling in a market but already have subscribers who pay in that currency?

Customers who already have an address created in a currency that you previously offered will continue to be charged in their set currency and be able to add or edit products within that existing address. 

New checkouts or address creations will no longer have the option to select the deleted currency.

Can I set fixed product prices for different currencies in Recharge?

No, if a customer adds or swaps a product within Recharge, the price is calculated by doing an automatic conversion based on the foreign exchange rate. 

If you have fixed prices set in Shopify and a customer checks out with a subscription, Recharge  captures the fixed price that is passed from Shopify. The customer will continue to be charged that amount. Recharge fully supports Shopify market pricing with the widget.

How does adding and swapping in the customer and merchant portals work with multi-currency?

Recharge calculates the price in the customer’s presentment currency by multiplying the

store currency product price in the store currency by the foreign exchange rate at the close of prior business day. Refer to Multi-currency conversions and risk for more information.

Will my customers see a price change on recurring orders every month?

No, customers will pay the price paid at checkout.

How do Recharge exports work if I sell in multi-currency?

The Subscriptions - All export populates presentment currency (the currency the customer used during checkout)  for stores with more than one presentment currency enabled. The following exports including additional columns that are available for Shopify Checkout Integration merchants with multi currency customers:

• Subscriptions (All export types)
• Onetimes - All
• Customers - Shipping Addresses
• Charges - (All export types)
• Orders - (All export types)

Multi-currency glossary

• Conversion rate is the rate used to convert your store currency to the presentment currency.
• FX rate is the current market exchange rate. It is the pricing method used to surface presentment currency prices in the widget, the merchant portal and the customer portal.
• Presentment currency is the currency that the customer uses when they pay for their orders at checkout. This can differ from the store's default currency. 
• Store currency is the main currency your store uses to set the prices of products and appears on your reports. This can be checked in Shopify by clicking Settings and Store Details.