API Integration / Getting Started with the Churn Buster API
Dunning
Adaptive Campaigns
Emails
SMS Nudge
Last Chance Offers
Retries
Card Updates
Alerts
Data & Testing
Cancel Flows
Overview
Getting Started
Testing
Deflections
Cancel Reasons
Targeted Offers
Custom Branding
Segmentation
Analytics & Insights
Integrations
Recharge
Stripe
Braintree
API
Getting Started with the Churn Buster API
Successful Payments API Endpoint
Failed Payments API Endpoint
Cancellations API Endpoint
Default Payment Method API Endpoint (always optional)
Customer Endpoint
Upcoming Annual Renewals API Endpoint
Webhook Data Reference
Other
FAQ
Getting Started with the Churn Buster API
The auth model, the four endpoints you'll use most, and how to wire them up from an in-house subscription stack.
This document outlines how to connect your subscription management tool to Churn Buster so the proper events are transferred over for accurate measurement of failed payment recovery.
To get started:
- Sign in to your Churn Buster account, or notify support@churnbuster.io if you don't have an account yet.
- Within your account, you can access your Test API Keys here, along with the Test Debugger to verify events are being sent. Use test keys until ready to go live with Live API Keys.
1. Payment Failures
When a recurring payment fails, notify Churn Buster to track the volume of failed payments and monitor outcomes.
2. Successful Payments
When a recurring payment succeeds, notify Churn Buster to track successful recoveries.
3. Subscription Cancellations
When a subscription is cancelled, notify Churn Buster to track lost recoveries.
4. Payment Method Updates
When a customer's default payment method is updated, notify Churn Buster. This enhances your analytics by also tracking recovery method: retry vs. card update.
Once all event types are being sent over through your Test API Keys (verified in the Test Debugger), please request a QA review to coordinate an account launch and switch to your Live API Keys.
For help, please contact us anytime at support@churnbuster.io or via your dedicated Slack channel.
Important note about "source" and "source_id":
- Wherever you see source in the API docs, set it to "in_house" or another consistent name that references your in-house subscription management system.
- Wherever you see source_id in the API docs, set it to the ID from within your in-house system, with unique ID's for the Customer, Subscription, Payment Method, etc.