Introduction

Chargeflow now integrates with Recurly — an enterprise-class subscription management and billing platform used by SaaS, media, and e-commerce businesses.

Once connected, Chargeflow automatically looks up the corresponding Recurly transaction, subscription, invoice, customer, and order data the moment a dispute is created — injecting it directly into the dispute record and your Dispute page. If a disputed subscription is still active, Chargeflow can also automatically cancel it in Recurly to prevent further billing. All of this is set up in minutes using just your Recurly subdomain and API key, the same seamless experience as our Chargebee and Recharge integrations.

Getting Started

Already a Chargeflow family member? Great! 🙌

Here's how to connect your Recurly account:

Log in to your Chargeflow account.
Navigate to the Integrations page.
Under the "Subscriptions" section, find the Recurly widget and click "Connect".
In the connection drawer, enter:
- Your Recurly subdomain (format: {yoursubdomain}.recurly.com)
- Your Recurly API key
Click "Connect" to establish the integration.

That's it! Chargeflow will now automatically enrich your disputes with Recurly subscription data as soon as any dispute arises.

How to get your Recurly API Key

Log in to your Recurly account
Go to Integrations → API Credentials
Click "Add Private API Key"
Name the API key as "Chargeflow"
Set the Application Using This Key to “Other” → Application Name “Chargeflow”
Click on "Save Changes"
You will see the newly generated key → Click on the eye to view the key and copy it.

⚠️ A Full Access API key is required. Read-only keys will not work and will result in a connection error.

Not on Chargeflow yet?

Shopify merchants: Install the Chargeflow app from the Shopify App Store, then follow the steps above.
Stripe merchants: Install the Chargeflow app from the Stripe Marketplace, then follow the steps above.
Other merchants: Sign up via our 60-second onboarding, then connect your Payment Processor and Recurly account on the Integrations page.

Don't see your payment processor on our Integrations page?

No worries! You can get in touch with our Customer Support team anytime through our 24/7 Live Chat or by emailing us at support@chargeflow.io — we're always happy to help.

Common Questions

Auto-Cancel Subscriptions with Recurly

Automatically cancel disputed subscriptions in Recurly to prevent further billing and reduce future chargebacks.

What is Auto-Cancel?

When a customer files a dispute against an active Recurly subscription, that subscription often continues billing — leading to more chargebacks. Chargeflow's Auto-Cancel feature solves this by automatically canceling the active subscription in Recurly the moment a dispute is filed.

What happens when a subscription is auto-canceled?

The subscription is set to expire at the end of the current billing term — it is not deleted or terminated immediately.
The customer will not be charged again after the current period ends.
The cancellation is logged in your Recurly account.

How to enable Auto-Cancel

Go to the Integrations page in Chargeflow.
Find the Recurly widget.
Click the gear icon (⚙️) on the widget.
Toggle "Auto-Cancel Subscriptions" to On.

To disable it, follow the same steps and toggle the setting Off.

Requirements

Your Recurly account must be connected to Chargeflow.

A Full Access API key is required for Auto-Cancel to work. If you connected with a limited-permission key, Auto-Cancel will not function correctly.

Troubleshooting: Recurly Integration Disconnected

Learn what to do if your Recurly integration shows as disconnected or reverts to a "Connect" state.

What does this mean?

If your Recurly widget on the Integrations page reverts to showing a "Connect" button instead of your connected account, it means Chargeflow is no longer able to authenticate with your Recurly account.

Why does this happen?

The most common cause is that your Recurly API key was revoked or its permissions were changed. This can happen if:

The API key was manually deleted or rotated in Recurly.
Your Recurly account permissions were updated.
A team member made changes to API credentials in your Recurly admin.

How to fix it

Log in to your Recurly Admin account.
Navigate to Configuration > API Credentials.
Generate a new Full Access API key.
Go back to the Chargeflow Integrations page.
Click "Connect" on the Recurly widget.
Enter your Recurly subdomain and the new API key, then click "Connect".

✅ All your previous settings — including Auto-Cancel preferences — are preserved automatically when you reconnect. You won't need to reconfigure anything.

What Recurly Data Appears on My Dispute Page?

Learn what subscription data Chargeflow pulls from Recurly and how it's used in your disputes.

Overview

When a dispute is filed and your Recurly account is connected, Chargeflow automatically looks up the relevant Recurly data and displays it directly on your Dispute page — no manual input needed.

What data is pulled from Recurly?

Data Type	What's Included
Subscription	Plan name, status, start/end dates, billing frequency, trial info, cancellation reason
Invoice	Amounts, payment dates, line item details, discounts, tax
Customer / Account	Name, email, billing address
Payment Method	Card brand, last 4 digits, expiration date
Order	Products, SKUs, shipping address, discounts applied

Where does it appear?

This data is displayed in the Subscription Section of your Dispute page, marked with the Recurly logo so you can easily identify its source.

⚠️Important: Recurly data fills gaps — it never overwrites

Chargeflow follows a non-destructive enrichment approach. Recurly data is used to fill in missing information only. It will never overwrite existing data already pulled from your payment processor (PSP). This ensures your dispute evidence is always as complete and accurate as possible.