Docs

Log in to read the version of docs relevant to your site.

Transitioning from BGN to EUR - Effective from Jan 1, 2026

Why This Change Is Required

  • Starting January 1, 2026, Bulgaria will officially adopt EUR (€) as its national currency, replacing the BGN (Bulgarian Lev).
  • All electronic BGN transactions will be declined after December 31, 2025.
  • To remain compliant, you must update all billing, invoicing, subscriptions, and credits from BGN to EUR before year-end 2025.
  • As a proactive measure, if any BGN subscriptions are not cancelled before December 30, 2025, Chargebee will automatically cancel these subscriptions on that date.

1. Use EUR Price Points for All New Sales

  • Enable EUR in Chargebee: Navigate to Settings > Configure Chargebee > Currencies. Skip if you already have EUR as a currency.

  • Create new EUR Price Points

    Note:

    Skip if you already have EUR price points for your products.

    • For each plan/add-on/charge where you have BGN price points, create equivalent EUR price points.

    • You may use the fixed conversion rate 1 EUR = 1.95583 BGN, or adjust pricing strategically.

    • Ensure you have the correct accounting codes set up for these.

    • Publish and verify the new EUR price points on your customer-facing interfaces (e.g., checkout, customer self-serve, and more).

      • If your customer interfaces are custom-built, please coordinate with the engineering team that maintains those interfaces to update the price points.
    • If you are using Chargebee Entitlements (configured at price point level), please ensure that the new EUR price points have the same entitlements as the old BGN price points.

    • Please ensure that the price points are replicated in any systems connected to Chargebee (CPQ, CRM, Accounting, and more), as necessary.

  • Once you have the new EUR price points available in all your customer interfaces, archive all BGN price points to block new sign-ups or plan upgrades in BGN.

2. Migrate Existing BGN subscriptions to EUR

Note:

You can skip this step if there are no BGN subscriptions in the following states: Active, In Trial, Paused, Future, Scheduled, or Non-Renewing.

While the following actions can also be performed via the Chargebee web interface, the instructions below are specific to the API.

  • Schedule cancellation of subscriptions with BGN currency using the cancellation API and selecting cancel_option as

    • immediately: (Recommended) If there’s no impact of this cancellation on your end users.

    • end_of_term: If the current billing period ends before Dec 30, 2025. This ensures that customers receive the full value they’ve paid for.

    • specific_date: Specify any date before Dec 30, 2025, if the current billing period ends on any date after Dec 30, 2025.

      (Recommended) Please enable reason codes from Settings > Configure Chargebee > Reason Codes > Subscriptions > Subscription Cancellation. You can set a custom cancel_reason_code, such as BGN_Currency_Deprecated to identify these cancelled subscriptions later for your reporting.

  • Create a new subscription with the equivalent EUR price point (created in point #1 above) using the create subscription API. You can schedule the creation of this subscription to a timestamp post-scheduled cancellation using the start_date parameter to ensure that the new EUR price point subscription becomes active immediately post-cancellation of the BGN price point subscription.

  • (Optional) Use a custom field (such as old_subscription_id) at the subscription level and pass the old subscription ID as the value of this custom field when creating the new subscription in the previous step. This will help you link and track the old transactions and invoices associated with the BGN subscription.

Note:

  • No subscriptions with BGN price points can remain active or renew after December 31, 2025, as all electronic BGN transactions will be declined post this period.

  • As a proactive measure, if BGN subscriptions are not cancelled before December 30, 2025, then Chargebee will cancel these subscriptions automatically on December 30, 2025.

  • Align the billing start date of the EUR subscription with the previous BGN subscription’s end date for a smooth transition.

  • If there are any paid invoices, then prorated credits may be issued for these invoices, depending on the proration setting. (Refer to points #3 and #4 below to understand more about invoices & credit notes.)

  • You cannot apply a BGN credit note to an EUR invoice in Chargebee, so you can choose to issue new EUR credit notes manually using the Standalone credit notes feature. (Refer to point #4 below.)

  • Consider turning off email notifications for customer segments with BGN currency if you don’t want to inform them about this transition.

  • Apple and Google subscriptions recorded as omnichannel subscriptions will not be impacted, as the Apple & Google stores will take care of this currency switch, and Chargebee will automatically switch this based on the notifications from the stores.

  • If you are on Chargebee’s legacy mobile subscriptions solution, then Chargebee will take care of migrating these subscriptions from the BGN price point to EUR by deleting existing BGN subscriptions and creating corresponding new EUR subscriptions with the same subscription ID on December 30, 2025. You can fetch these deleted subscriptions using list subscriptions API and passing include_deleted parameter value as true.

3. Managing Open BGN Invoices & Unbilled Charges

  • Before Dec 30, 2025:

    • Invoice all unbilled charges in BGN
    • Close any invoices that are still in draft/pending status
    • Generate any new one-time/recurring invoices that are to be issued in BGN
    • Collect any pending payments from all open invoices in BGN (not paid, posted, or payment due)
  • After Dec 30, 2025:

    • Delete any unbilled charges issued in BGN
    • Void any open invoices issued in BGN (not paid, posted, or payment due)
    • Create new one-time invoices in EUR tied to the new subscription if required (using the standard BGN to EUR conversion rate: 1 EUR = 1.95583 BGN)

4. Handling BGN Credit Notes

  • Before Dec 30, 2025:

    • Issue any new credit notes if needed in BGN
    • Apply existing refundable BGN credit notes on any open invoices or refund back to the customer in BGN
    • Refund credits before payment processors stop supporting BGN

    Note: BGN credits cannot be applied to EUR invoices.

  • After Dec 30, 2025:

    • Void old BGN credit notes
    • Issue new EUR credit notes manually using the Standalone credit notes feature (Tip: Record the fixed conversion rate used for audit consistency: 1 EUR = 1.95583 BGN)

How This Affects Analytics

  • All canceled BGN subscriptions will be treated as churn in Chargebee’s reports.

  • All newly created EUR subscriptions will be treated as new acquisitions.

  • Expect a temporary spike in churn and new subscriptions, especially in December 2025 and January 2026.

Information

This is expected and purely technical. Internally annotate this in your reporting.

Keep Your Customers Informed

We strongly recommend that you communicate with your customers prior to these changes taking effect.

Please inform them about the change in currency, any EUR pricing adjustments, and the effective date of the switch. This will help avoid confusion or support requests.

Additional Notes

  1. When you schedule cancellation of BGN subscriptions, you can choose to disable subscription cancellation emails for these specific cancellations. This is crucial because you will be creating an equivalent subscription in EUR, and the BGN cancellation is not a typical subscription termination. To prevent these emails, navigate to:
    • Navigate to Settings > Configure Chargebee > Email Notifications.
    • Locate Subscription cancellations.
    • Choose the Edit option on the enabled notification.
    • Select the Manage segments option.
    • Create a new segment that specifically excludes subscriptions with the BGN currency. Filter to be used while creating segment - Subscription: currency is not BGN.
  2. If you want to segregate the churn numbers showing up in your reports (Revenue Story) due to this activity, you can use a specific subscription cancellation reason (say, “Canceled due to BGN-EUR migration”) while canceling these subscriptions. (Configuring Reason Codes)
  3. To ensure that your customers get uninterrupted access to your products and services, make sure to assess the impact of these changes on your provisioning system.

See also

API Reference

Was this article helpful?