Why does my customer's currency change after a subscription update?

Scope

While managing subscriptions in Chargebee, you might notice that a customer's preferred currency changes unexpectedly after a subscription update. This can occur even if no currency is specified in the API calls. Understanding how Chargebee determines and updates currency settings can help prevent unexpected changes.

Solution

To ensure your customer's preferred currency remains consistent, follow these steps:

1. Set a Preferred Currency: Always set a preferred currency for your customers if you want it to remain unchanged.
   • Navigate to Customers > Select Customer > Edit.
   • In the Preferred Currency field, specify the desired currency.
   • Click Save to apply the changes.
2. Understand Default Behavior: If a preferred currency is not set, Chargebee defaults to the base currency.
   • The base currency is used for the first subscription created for the customer.
   • Subsequent subscriptions will not change the preferred currency unless explicitly updated.
3. Review Subscription Changes: When updating subscriptions, verify if the currency needs to be specified.
   • If the subscription currency differs from the preferred currency, ensure the preferred currency is set to avoid automatic updates.
4. Check Base Currency Settings: Ensure your account's base currency is correctly configured.
   • Navigate to Settings > Configure Chargebee > Business Profile.
   • Verify that the base currency setting matches your business requirements.

Important Notes

• If a preferred currency is set, it will not change regardless of subscription currency updates.
• Always review currency settings when creating or updating subscriptions to prevent unexpected changes.
• Consider setting a default preferred currency for all new customers to streamline the process.