Fusebill's subscription migration feature provides a powerful way for you to manage the way your customers' services evolve over the lifetime of your relationship with them.
Migrations can be used to manage:
- Upgrades and downgrades
- Frequency changes (e.g. migrate from monthly to yearly in the same Plan)
- Free trial conversions
- Plan updates (e.g. migrate to the 2017 version of a legacy Plan)
- "Custom" migrations
In order to support subscription migrations, you must first configure a Plan Family and define Relationships and Rules within the family which are used to identify which migration paths are valid and what the system should do when migrating from one subscription to another. These settings are defined in the Catalog; please see Creating Plan Families for more information.
Subscriptions that belong to Plan Families and have valid migration paths will have a "Migrate" button
() in their Actions column on the Subscriptions grid.
- Click the Migrate button () button to begin a migration.
- Step 1 of the Migration wizard will prompt you to choose a destination plan from a list, from among the valid migration paths that have been configured in the Catalog. Choose one by highlighting the line and click Next.
- Step 2 will allow you to override any of the Relationship defaults that were configured in the Catalog if desired. Usually, you will want to follow the defaults as set up by your Catalog owner, but you may need to change some settings depending on the circumstances. For more information about each of these settings, see Managing Relationships and Rules.
You can also choose the timing of the migration:
- Now - The migration will occur as soon as you finish the wizard. The source subscription will be in "migrated" status and the new subscription will be active.
- On next billing period - The migration will occur on the source subscription's next billing period.
- On specific date - Choose a date on which the migration will be scheduled to occur. This can be particularly handy, for example, to set up a 14-day free trial.
- When you have finished configuring these settings, click Preview Migration to continue. If you have chosen to migrate on next billing period or specific date, click Done to complete the migration schedule.
- Step 3 of the wizard will show you a preview of the invoice that will be generated if you complete the migration. Do one of the following:
- Click Migrate Subscription to complete the migration and generate the new invoice. The source subscription will be marked as "Migrated" in the Subscription grid and the new subscription will become "Active".
- Click Cancel to exit the migration wizard without making any changes to the subscription.
- Click Back to return to the settings page to make more changes.
What Happens When a Subscription is Migrated?
When you complete a migration, Fusebill does all of the "heavy lifting" in the back end to ensure that the billing, accounting, and reporting remain accurate. Here's a list of the things that happen when the migration occurs:
- If there are charge reversals, then the new invoice will automatically use available funds from those charges before it attempts to charge the customer's payment method for any additional charges incurred due to the migration event. The customer will see this on their new invoice as a reduction in the amount owing (and collected if they are on auto-collect).
- Earnings are correctly calculated based on the settings as they were configured in the Catalog; partial/pro-rated reversals are handled on the source subscription and the earnings for the destination subscription begin as of the time of migration.
- MRR Contraction is recorded for the source subscription and MRR Growth is recorded for the destination subscription
- If the two subscriptions are the same frequency, then the destination subscription "adopts" the source subscription's billing period, so that the billing date remains the same. Pro-ration rules are respected.
- If the two subscriptions are of different frequencies (e.g. monthly and annual), then the destination subscription creates a new billing period starting on the day of the migration.
- Projected invoices are updated to remove any projections for the old subscription and new ones are generated for the destination subscription.
- The migration action is audit logged.
What Happens When I Schedule on Next Billing Period or Specific Date?
In general, the same things happen to a scheduled migration as if you were migrating now, as described above. In addition, a few other things will happen at the time of the migration:
- Any end of period charges that are billed in arrears will be calculated according to the source plan's pricing (i.e. the one you are migrating from) at the time of the billing period rollover. This usage charge will show up as a line item on the new invoice, along with the new start of period recurring charge for the destination plan.
- In the Subscriptions grid for a customer, if a subscription is scheduled to be migrated, you can see the scheduled migration date:
- If the scheduled date is on the next billing period, then any counters (discount periods, uplifts, etc.) will be decremented before the destination subscription is made active. If the scheduled date does not fall on a billing period boundary, then none of these counters are decremented.
- You can make changes to and/or cancel the scheduled migration at any time up to the scheduled date by clicking the Migrate button again and moving through the wizard. There is a Remove Migration button at the bottom of the wizard which allows you to cancel the scheduled migration. The current (source) subscription will remain active and the migration plan will be removed from the system.
Note: Changes made to the destination Plan during the time that this migration is scheduled will be reflected in the migrated subscription when it occurs. The system does not keep a "snapshot in time" of the destination plan at the time that you schedule the migration.