Skip to main content

Subscription Management migration

While it is possible to keep currently running subscriptions on the Subscription Management 1.0 data model and only have new business come in as Subscription Management 2.0, we strongly recommend a complete Subscription Migration. The Subscription Migration will update legacy subscriptions with the renewal type and ensure that they comply with Subscription Management 2.0 data structure on the CB backend.

Given that the data model might have an impact on your system integration with CB, migrating your subscriptions to 2.0 means you won’t have to maintain a legacy branch of your integration. It also makes it easier for Customer Support teams as they won’t have to follow separate processes per Subscription Management data model, for more details of the migration advantages, please see Subscription Management 1.0 and 2.0

Subscription migration day

Your Cleverbridge contact will agree with you on a date and time to start the migration. The migration typically takes up to 3 hours but will differ depending on the number of subscriptions you have.

If any of the integration changes discussed above apply to you, please plan your change release for the same day as the CB Subscription migration. It is especially important if you are updating your integration to our REST API for deactivation/reactivation of subscriptions that this change is released close to when your subscriptions receive the new data model. We estimate that a 3-hour delay between the migration and your updates is acceptable but are happy to discuss any concerns and can provide guidance to achieve the closest possible sync between your system and the CB platform.

With the migration, the following updates are done:

  1. CB turns on Subscription Management 2.0 on your account. This means that all new business is created using the new data model.
  2. CB updates links & wording on confirmation pages and emails. With the update, customers are now linked to the CB subscription overview where they can toggle between automatic and manual renewal, instead of getting “cancel your subscription” links.
  3. CB turns on a redirect from old subscription cancellation or reinstate links. Customers opening those links are now redirected the Subscription Overview.
  4. CB updates backend data on existing subscriptions to follow 2.0 data model.
  5. If you receive custom reports, CB will ensure that queries are updated to account for the changed subscription data model
  6. If CB runs email campaigns on your behalf, email trigger rules will be updated to account for the changed subscription data model.
[Important]

On the day of the migration, we recommend that you do not perform major updates to your setup with Cleverbridge and limit updates to your system integration and license management to what’s required for the CleverEssentials onboarding.

URL integration change

This section is only relevant if you currently link customers to CB hosted subscription management pages from your own emails or my-account area. There are no changes to the URL structure of regular CB shopping carts or checkout pages.

While we strongly recommend that you update the Subscription Management links to the Subscription Overview URL, CB also turns on a redirect on the day of the migration as a fallback solution. This way, old subscription cancellation or reinstate links will redirect the customer to the Subscription Overview page.

note

You can use the Subscription Management links not only to refer your customers to their Subscription Overview page, but also to directly send them to the Subscription Renewal or Subscription Upgrade pages.

If you have not yet updated your system to generate “Expiring Links” we recommend that this change is made as part of onboarding CleverEssentials. To learn more about the functionality logic and how to generate valid URLs, see the Expiring links article.


Did you find this doc useful?