Updating Subscription currency

Last updated on: May 31, 2023

To change the currency of existing subscriptions without needing to ask your customer to return to your website or app, first create new product & price objects in the relevant currency. Then for each impacted Customer, complete the following steps:

  1. Remove or void any open discounts, invoice items, invoices, or quotes in the previous currency

  2. If your customer has a balance in the previous currency, create customer balance transactions to convert this balance into the new currency balance.
  3. Cancel any subscriptions or subscription schedules with Price(s) in the old currency with prorations disabled.
  4. Create a subscription or subscription schedule with Price(s) in the new currency using the previous subscription’s period end as the billing cycle anchor with prorations disabled.

This flow allows you to reuse the same Customer and PaymentMethod objects for the new currency subscriptions. We recommend notifying your customers about this change and allowing them to change their payment method for the Subscription if they wish, either using the Payment Element or the Customer Portal.

Looking for something else?