Connecting your payment processor to Churn.io enables audience targeting inside your cancel flows and allows Churn.io to apply retention offers directly to your customers' subscriptions. This article explains how to connect, what permissions are required, and what the integration provides.
How to connect your payment processor
Go to Integrations in the main navigation
Find your payment processor in the list and click Connect
Enter your Stripe API key. Churn.io validates the key immediately to confirm it has the required write permissions.
Once validated, the connection status will show as Active.
⚠️ Write access required
Churn.io needs write access to your Stripe account to apply retention offers. Specifically, the API key must have permission to create coupons and update subscriptions. If you provide a read-only key, you will see: "This API key does not have write access. Churn needs permission to create coupons and modify subscriptions to apply retention offers. Please use a key with full access or enable write permissions." Use a Restricted Key with coupon and subscription write permissions, or use your standard Secret Key.
What data the integration provides
Once connected, Churn.io can use the following subscription attributes when targeting offers in your cancel flows:
Plan name and ID
Billing cycle (monthly or annual)
Subscription status (active, trialling, past due)
Customer tenure (how long they have been subscribed)
Trial end date (for trial users)
How offer application works
When a customer accepts a retention offer on either the widget or the hosted cancel page, Churn.io applies the change directly to their Stripe subscription:
Discount: applies a coupon to the subscription
Pause: sets a trial end date to pause billing for the configured period
Free month: applies a 100% off coupon for one billing cycle
Trial extension: extends the subscription trial end date by the configured number of days
When a customer confirms cancellation, Churn.io sets cancel_at_period_end: true on the subscription automatically.
Using Churn.io without a payment processor connected
A processor connection is not required to run cancel flows. Without one, you can still use all flow steps and offer types. Two limitations apply: subscription-based audience targeting will not be available, and offers will not be applied to Stripe automatically. You can connect at any time from Integrations to unlock both.
⚠️ Multiple processors
If your business uses more than one payment processor, you can connect each one separately. Read Adding Another Integration to learn how.
💬 Questions or concerns?
Get help from our support specialists at Churn.io. Click the chat icon at the bottom of your screen to reach us directly.