BurnChurn.io Documentation


Thanks for using BurnChurn. The documentation below will help walk you through the simple process of embedding the BurnChurn form on your site to replace your delete button and recover more users!

If you have trouble at any point in the process, feel free to contact us at any point for assistance!


Connecting Stripe

In order to take full advantage of the functionality that BurnChurn offers to automate processes for your users, we integrate heavily with Stripe to manage your users, subscriptions, and payments.

In order to get started, you should either connect your existing Stripe account that is being used on your application, or sign up and create a Stripe account in the process for your payment processing and customers.

Configure Your Settings

BurnChurn offers a number of different functionalities - from notifying you if a user is considering quitting, to extending or changing the plan a user is considering automatically.

In order to take advantage of these features, sign in, and navigate to the Form Editor to customize your form options and actions.

There is more information below regarding how to setup your form for more advanced functionality.

Copy & Paste the Embed Code

Grab the generated embed code below the form editor and replace your delete button with the new embed code. It should look something like the following:

<!-- Insert this code where you would like your form to be -->
<script id="churn-script" src="https://burnchurn.io/embed.js" api-key="9PMFR6NV9GY8XBMOLDLYW440FNNG301M" 
stripe-customer-id="RENDER_CUSTOMER_ID_HERE"></script> <div id="churn-form"></div>

An iframe will populate the space where your delete button used to be. You may have to adjust the styling to get it to look just right.

Once you've completed this step, you need to make sure that you are rendering the customer's Stripe customer key as an attribute to the script in the space indicated by "RENDER_CUSTOMER_ID_HERE". This way we know which user to perform the automatic actions you've set up on.


Add Default Settings

There are three default settings you should set before embedding your form.

The Default Redirect URL allows you to check the option that a user is redirected, and when a custom URL is not supplied, this URL is used.

The webhook URL is the endpoint which we will send webhooks to. Again, you can set a custom webhook endpoint for specific actions, but this will be used as default if you add webhooks.

Your API key is automatically set and unchangeable. This is used to identify your form in requests and should be included (by default) in your embed code.

Customize Text/Appearance

In order to edit the form, you can use the graphical interface to change text, add feedback options, and change the communicated messages.

The changes are modeled on the right-hand side of the page where you have the option to drag/drop to rearrange the order.

When you save changes on this form, they will be automatically updated in your application where the embed code is currently located. These changes happen in real-time and instantly so you can manage changes straight from your dashboard.

In order to customize the style of your form, simply enter CSS into the Custom CSS box, applying styles to the appropriate selector in order to make the changes.

Similar to the rest of the form, these changes happen as they are saved in real-time to your already existing form.

Set Actions

Stripe Actions

Stripe actions allow you to automate the process of most steps regarding the management of your users' accounts.

Simply check the box to enable a stripe action, then select the corresponding action you want to happen for the user.

You can offer discounts, trial extensions, pausing billing, and more to keep users happy and give you time to make sure they do not churn.

Redirect Action

You can also set your form to redirect the user after they have submitted their option.

The default URL can be used, and is typically the dashbooard of the application or similar, or you can specify a custom URL in order to redirect to that URL for that single option.

Email Notifications

Get notified each time a user performs or chooses an option on your form.

This allows you to know which users are considering quitting and respond accordingly.

You can also configure this as a way to "contact support" in case they are interested in quitting because they don't understand the product.

Sending Webhooks

Notify your application of a user's action using webhooks.

Choose to set a custom webhook for that action, or it will automatically send webhooks to the default URL if you indicate to do so.

This way you can perform custom logic based on the choices your users make.

The webhooks contain parameters to interact with your application, below is an example with each of the possible response parameters.

          "stripe_customer": "cus_BiLJgT7PEYNfS7",
          "option_chosen": "I didn't have enough time to try, extend my trial",
          "actions": ["Extend Trial"],
          "redirect": true,
          "redirect_url": "https://yoururl.com/dashboard",
          "result_type": "Save"

Reviewing Insights

Dashboard View

The Dashboard view gives quick insight into the number of users that interacted with your form in a quick, visual way.

Separated into different time sections, you can easily see the number of users that were saved compared to those which interacted with the form.

Easily visualize the improvements made and the number of customers you've saved week to week and month to month.

User Statistics

BurnChurn has a number of reporting tools you can use to determine why your users may quit so that you can adjust to reduce churn.

Among these include tools to easily view churn rates, feedback and choices from users, users in danger of quitting your service, and more.