How to setup Brightback for the Chargebee Retention API

Chargebee Merchants who are using APIs to manage their subscriptions can now integrate with the Chargebee Retention API to initiate a Brightback cancel session. This approach is an alternative to the Brightback.JS, and can be leveraged to quickly add Brightback to your existing Chargebee Billing setup or a new billing site deployment. The documentation on how to setup this API can be found in Chargebee's API docs

This API allows you to initiate a cancel session by securely passing Brightback a subscription id, which allows us to return the Cancel Session URL that will be served to the end user when the hit the cancel button on your account management page. When you integrate Chargebee and Brightback, we will map your Billing Fields into Brightback to be used in page personalization and audience definition. You can also pass additional custom fields via the Retention API as well. 

In order to start sending traffic to Brightback you will need to install the Retention API and complete the remaining steps to build out your Brightback Cancel Experiences. 

How Cancels are Processed via Brightback

It is important that you map the settings for how you want to handle Subscription Cancellation from Chargebee to Brightback. These settings will override what you have configured in Chargebee when you route traffic to Brightback. 

Reason Codes not set to Mandatory

Navigate to Configure Chargebee > Advanced Settings > Reason Codes to ensure that this setting is not turned on. If it is, Brightback will not be able to process the results of your Cancels and an error will be logged in the Activity Log. 

Testing your Brightback Integration

Once you have completed your setup in Brightback, you are ready to test and then deploy your Retention integration. To test the integration, you have two options, a Sandbox App or our Sample Session Generator. If you are on Brightback Performance Plan we provide access to a Sandbox app. You can integrate your test site id and test API key into this Sandbox app and use it to generate a sample session and test the integration end-to-end. This will allow you to run a full test starting in your Account Management page without having it impact your production customers. 

If you do not have access to a Sandbox App, you can integrate your Test API Key into the Chargebee Test site in your Brightback settings and then use the Sample Session Generator to trigger a cancel session. 

To do so, first, add your Test site integration details into the Settings > Integrations tab. 

Then you can navigate to Targeting > Session Generator to initiate a sample test session. Note: Test sessions will not count against Reporting, but we will process the events associated with these and update your billing systems accordingly. If you test against a Live Site Key, ensure that you are using a test account when doing so because these tests will update your Chargebee Subscription record. 

Publishing your Retention API Cancel Experience

Once you have completed testing, you are ready to enable Cancellation via Brightback for your live Chargebee site. To do so you will need to update the API to ensure traffic is being sent to your production site. We cover how to do this in API doc. Once this is done, your Brightback Integration is live and your Brightback Dashboard will start to populate with data! 

If you need assistance getting started with the Chargebee Retention API, please reach out to 

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.