Docs
Chargebee Retention's native integration with Recurly makes it easy for you to retain subscribers and revenue by reducing voluntary churn. By connecting Chargebee Retention to Recurly, you will be able to enable our four main billing integration use cases:
These use cases are core to Chargebee Retention and allow you to perform some of the key elements of your canceel flow, including:
In Recurly, head to the Integrations settings in the left sidebar menu.
Select API credentials.
You'll want to use a Private API key. Select Add a Private API key.
Name your API Key Chargebee Retention (so you know what you're using it for later) and add Notes if you'd like to remember how it's being used. You also will want to use a Write API key so we can update subscriptions on your behalf. However, if you don't want to give Chargebee Retention write access, Read-Only will work for our Attribution and Enrichment use cases.
Identify that the API key will be used for a third-party application and select Other, and label as Chargebee Retention.
Save your changes and your API key will generate! Copy the API key and head back to the Chargebee Retention App.
In Chargebee Retention, head to the Settings in the lower left sidebar. Find Recurly under Integrations and select Connect.
Pop in the API key you copied in the last step, Save and Continue
You're now connected!
We allow you to also add a Test API Key that links to a Sandbox or dev environment, which can be used when generating a sample session via the Session Generator under Targeting.
In order to use the Recurly integration, you'll need to enable it in settings and send along the Recurly Subscription ID in the request body of the installation snippet,.
Once Recurly is connected, you will need to activate the core use cases of the integration in the Settings Page under Setup.
Once Recurly is connected, you can leverage Chargebee Retention's enrichment feature to reduce the engineering time and effort needed to install the Chargebee Retention.js snippet. With the integration enabled, Chargebee Retention will use the Recurly Subscription ID to lookup and key subscriber data in Recurly (such as first purchase date or billing frequency), and sync it back into Chargebee Retention to map to Chargebee Retention fields using Field Mappings located under 'Settings' (read below).
If you do not send a valid subscription id or have a valid connection to Recurly, Chargebee Retention will not be able to pull subscription information at load time. In this case, your subscriber would be routed to your control or default cancel experience, and any dynamic field data used for personalization will default to the fallback variables._
Before you can successfully map Recurly data into Chargebee Retention, you must first ensure that you are capturing the Recurly Subscription ID via the Chargebee Retention.js, and have mapped this field to the Subscription ID in the field mappings page.
Once successfully connected to Recurly, navigate to 'Field mappings' under Settings, to start mapping. For each Chargebee Retention field that you will map to, you must first specify the field data type (e.g. text, date, decimal, email, URL), then select the source field in Recurly, visible under the Recurly source in the menu dropdown.
Go ahead and map as many fields as you would like. Mapped fields can be used to personalize the cancel page, target the cancel experience/offers, and in reporting via the customer's page.
Missing a field? Please contact retention-support@chargebee.com and we'll look into adding it.
When a user completes a cancel on the Chargebee Retention page, we will update Recurly to mark the subscription as canceled. This process works as follows:
You can choose how to apply the cancel in Recurly under the Setup tab for the integration.
Select the options that match how you currently handle cancellations in Recurly and hit Save & Close.
You also can process Offer updates directly to Recurly subscriptions. We support the ability for you to map Discounts, Pauses, Extensions and Plan Changes directly to Recurly Subscriptions. When the user selects one of these Offers in the cancel flow, we will apply it directly to the corresponding Subscription in Recurly. To get started with Offer Management, go ahead and enable this toggle in the Settings page.
Next, create a "Discount" type offer in Chargebee Retention, where you will finalize the offer content, button copy, and define where the offer appears on your Chargebee Retention page ("Placement").
Finally, you will use the "Billing" sidebar to browse and select the Billing coupon created above in Recurly, is applied to your customers' subscription when they accepts this offer!
The Attribution integration enables Chargebee Retention to cross-check your billing system to validate any Chargebee Retention Saved or Watch List customers haven't canceled or let their accounts lapse in other ways beyond Chargebee Retention, and calculate the dollar amount in revenue saved (or lost) per customer that hits your Chargebee Retention Page. Once you've enabled the Recurly Attribution integration, you'll see a Revenue data card start to populate in the Chargebee Retention Settings menu showing you the last sync, and how many accounts have matched to a customer in Recurly.
If your Recurly account is not configured properly, or you don't use Recurly to manage subscriptions, you may alternatively automatically cancel or modify your subscriptions using Chargebee Retention's webhooks or pass through URLs (which requires some engineering to set up), as follows:
You would need to have already set up a Coupon in Recurly, then the Chargebee Retention webhook will apply the coupon to the actual customer.
Passive deflects (scenario 3, above) do not need any subscription modifications in Recurly, and the canceler is redirected back to a returning URL specified in the Chargebee Retention.js snippet ('save_return_url').
Need a Chargebee Retention developer sandbox for testing the integration with a Recurly dev account? Please contact retention-support@chargebee.com or your account manager, who can promptly set up your developer account.
The final step to using our Recurly integration is to send cancel sessions to Chargebee Retention with the unique subscription id populated dynamically in the snippet. Below is an example of the minimum properties you would need to send in order to create unique cancel sessions.
<a id="bb-cancel" href="/fallback">Cancel</a>
<script
type="text/javascript"
src="https://app.retention.chargebee.com/js/current/brightback.js?compiled=true"
></script>
<script type="text/javascript">
if (window.Brightback) {
window.Brightback.handleData({
app_id: "RETENTION_APP_ID",
subscription_id: "5ca5ee44aca90909d5effa4884b19269",
});
}
</script>
You of course can send other properties like usage activity in a custom object for personalization and targeting. For more info on that or other installation options check out our full article on installing Chargebee Retention.