How to test the Chargebee retention cancellation process?

Modified on: Fri, 7 Oct, 2022 at 8:36 PM


How to test Chargebee retention from Chargebee Billing?

How to test Chargebee retention from UI?

After integration how to test the Chargebee retention cancellation process?


Once your Chargebee Billing and Retention integration is successful, you can test Chargebee Retention and Billing integration using the below options.

  • Testing via a test key in your production app
  • Testing via a sandbox app
Note: Sandboxes are only supported on Performance and Enterprise plans today (Chargbee Retention).


Testing via a test key in your production app

This option is the easiest and fastest way to test your Chargebee Billing to Chargebee Retention integration and is available on all plans. We allow you to integrate a live and test API key when connecting Chargebee. The test API key can be invoked using the Sample Session Generator, and when a Test Key is added to your Chargebee Retention app, we will accept test sessions that come from this site's portal preview. 

Once you have saved your test API key here, you will be able to use the session generator to preview the experience and see that things are processing correctly in Chargebee. 

Here you can choose to use either the live or test key when running sample sessions. 

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.

One issue with this method of testing is that it will not apply the coupon code if you accept a discount using the test key. This is because the coupons synced with your pages are pulled from your live key, and we do not map test key coupon codes today. If you need to be able to test the discount offers specifically, we suggest that you use the sandbox approach

Testing via a Sandbox App

The alternative option is to test via a Chargebee Retention Sandbox app. For Performance and Enterprise customers, we provide the option to add a Sandbox app for end-to-end testing. This covers the use case where you need to test a discount code and see it applied to Billing. 

Sandbox apps need to be updated by your Technical Account Manager (TAM - Your single point of contact) to reflect the latest copy of your production application, and we do not currently support the ability to publish from your sandbox to production. If you need help with setting up your Sandbox, please contact

You will want to connect your test site API key to your Sandbox app so you can use this for testing. 

Related Articles

How to setup Chargebee Billing with Chargebee Retention for Live site?

After integration how to test the Chargebee retention cancellation process?

How to configure Enrichment in Chargebee Retention? 

How to setup Chargebee Retention via the Retention API

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.