Stripe Integration Guide

How to Connect Stripe to Chargeback.io

Follow this guide to connect Stripe to your Chargeback.io account. Step 2 will focus on adding the actual app.

Prerequisites:

• Verified Stripe account with admin access.
• Billing descriptor(s) and ARNs (or BINs and CAID).

Step 1: Add Descriptor(s) & ARNs

Here's a guide to help you find your descriptor(s) in Stripe. If you don’t have ARNs, review this article for alternative options.

How to add your descriptor(s) and ARNs:

1. In the left sidebar, click Alerts.
2. Select Configure from the dropdown.
3. Choose the alert network (e.g., Ethoca) and click + Enroll More Descriptors.
4. For RDR, ARNs are required. If you don’t have ARNs, click Need Help Finding ARNs to override the requirement or add your BIN and CAID.
   1. Send your BIN and CAID to our support team. Ensure you include the email for the account that you used to help us find your account.
5. Enter your descriptor(s) and ARNs (if applicable).
6. Click Continue.

From there, it'll typically take around 12 hours to connect to Ethoca and CDRN. It takes around 7 business days to connect to RDR, but can take more than 14 business days if there's a backlog.

See this piece for more information on the time it takes to enroll.

Step 2: Connect the Stripe App

Method 1 (Recommended)

1. In the left sidebar, click Integrations.
2. Find the Stripe card.
3. Click Connect.
4. You'll be redirected to Stripe to the app installation page.
5. Click Continue.
6. Select the Stripe account you want to connect.
7. Review the requested permissions.
8. Click Install.
9. You’ll be redirected back to Chargeback.io.

After the redirect, the Stripe app will be installed and automatically connected to Chargeback.io. You can confirm the connection in your Integrations list.

Method 2 (Stripe App Marketplace)

1. Go to the Stripe App Marketplace and search for Chargeback.
   1. Alternatively, use this direct link to the Chargeback app page.
2. Click Install from Partner.
3. Follow Steps 6 – 8 from Method 1.

Step 3: Set Up Auto-Refund

Skip this step if you plan to automatically refund all disputed transactions.

To set an auto-refund threshold (limit automatic refunds above a certain amount):

1. Click Alerts in the left sidebar.
2. Choose Configure.
3. Switch to the Auto-Refund tab.
4. Ensure the toggle beside Ethoca and CDRN is green (enabled).
5. Click Edit.
6. Set your desired threshold and save.

Step 4: Add a Balance

A Balance is required to exit Demo Mode and begin enrollment.

1. In the lower-left corner of your dashboard, click Please top up balance here.
2. Under Current Balance, click Add Funds.
3. Enter your desired amount and click Continue.

Funds will be charged to the card you added during signup.

If you don’t have a Balance, you won’t be able to add a new card yourself.  To update your payment method, contact our support.

Step 5: Enable Stripe Dispute Network Token

This step is optional but strongly recommended, especially if you use Rapid Dispute Resolution (RDR).

The Dispute Network Token prevents RDR alerts from appearing as chargebacks in your Stripe analytics. Activating it will make your reports more accurate and reduce confusion.

To enable it:

1. Contact Stripe Support.
2. Send them this message:

   1. Can you please activate the "dispute_network_token" on my account?

3. If the support agent doesn’t understand your request, ask to escalate the ticket to a team member familiar with the “Dispute Network Token” feature.

 

How to Disconnect Stripe

1. In the left sidebar, click Integrations.
2. Find the Stripe card and click Disconnect.
3. You'll be redirected to the Stripe Apps page.

If the app is still installed on Stripe:

1. Go to Installed Apps in Stripe.
2. Click the 3 dots next to the Chargeback app.
3. Select Uninstall.

 

Important Notes

The Stripe app may fail to match a transaction to your Chargeback.io dashboard. If this happens, mark the transaction as Not Found and file a Manual Credit Request.

 

Troubleshooting

Error: “Account Already Connected”

1. If you have another Chargeback.io account, log into that one and check if it’s already linked to your Stripe store.
2. If not, uninstall the app from Stripe and reinstall it.