Skip to main content

How to integrate Stripe with Disputifier

Connecting Stripe to Disputifier gives us the dispute and transaction data to fight and analyze your Stripe disputes. This guide covers three steps: add Disputifier as a team member, create a restricted API key, and connect it inside Disputifier.

Before you start

In this guide, you will be able to:

  • Add Disputifier as a team member on your Stripe account, with the correct roles

  • Create a restricted API key in Stripe with the correct permissions

  • Connect your Stripe API key inside Disputifier

You'll need administrator access to your Stripe account so you can invite team members and create API keys, and access to your Disputifier dashboard.

Note: Adding Disputifier as a team member is required. We may use human input to help analyze and win your disputes, and team access lets our team do this.

Part 1: Add Disputifier as a team member in Stripe

In this first part, you'll invite Disputifier as a team member on your Stripe account and assign the roles we need to help manage your disputes. Start from your normal Stripe dashboard.

  1. Log in to your Stripe Dashboard

  2. Click the Settings wheel at the top right

  3. Go to Team and security

4. Click Add member

5. Enter the email hello@disputifier.com and select all three of the following roles:

  • Dispute Analyst

  • Refund Analyst

  • Support Specialist

6. Click Send invite

Once you've sent the invite, Disputifier will be listed as a pending team member on your Stripe account with the three roles above, until we accept it.

Part 2: Create a restricted API key in Stripe

In this second part, you'll create a restricted API key in Stripe with write access to the specific permission groups Disputifier needs. You'll use this key in Part 3 to connect Stripe inside Disputifier.

  1. In Stripe, click Developers > API keys

2. Click Create restricted key

   3. On the How will you use this API key? screen, select Providing this key to another website

4. Click Continue

5. On the Enter website details screen, fill in the following:

6. Check the Customize permissions for this key box

7. Click Continue

   8. Setting Permissions (Important): Leave the default permissions as they are, except for the following five permission groups, which must each be set to Write access:

  • Core

  • Connect

  • Issuing

  • All webhook

  • Radar

 9. Click Create key, then copy the key. Stripe only shows the full key once, so copy it now and store it somewhere safe until you paste it into Disputifier in Part 3

Note: All other permission groups can be left at their Stripe defaults, only the five groups listed above need to be changed to Write access.

Part 3: Connect Stripe inside Disputifier

In this third part, you'll enter your Stripe API key into Disputifier to complete the connection.

  1. In your Disputifier dashboard, click the Settings tab in the left sidebar

  2. Select Integrations

  3. Scroll down to Payment Processors

  4. On Stripe, click the Add button

5. Click Add account

6. Enter the restricted API key you created in Part 2

7. Use the name of your Stripe account

8. Click Save

Once you click Save, Disputifier will confirm the key was accepted and your Stripe account will show as Active in the Integrations section.

Verify your setup before you finish

Run through this checklist to confirm each part of the Stripe integration was completed correctly:

  • Disputifier is invited as a team member in Stripe with all three roles: Dispute Analyst, Refund Analyst, and Support Specialist (Part 1, Step 5)

  • The invite was sent to hello@disputifier.com (Part 1, Step 5)

  • The API key is a restricted key, not your Stripe secret key (Part 2, Step 2)

  • Write access is set on all five required permission groups: Core, Connect, Issuing, All webhook resources, and Radar (Part 2, Step 8)

  • The full restricted key was copied from Stripe with no extra spaces or missing characters, and pasted into Disputifier (Part 2, Step 9 and Part 3, Step 6)

  • The connection shows as active in Disputifier under Settings > Integrations

Common issues and how to fix them

My Stripe invite is stuck on Pending. This means Disputifier hasn't accepted the invite yet on our end. Contact the Disputifier team through the live chat option in the Disputifier app and let us know your store or website URL so we can locate and accept the invite.

My API key isn't working or the connection won't save in Disputifier. This is usually caused by copying the key incorrectly or missing a required permission. Confirm you created a restricted key (not your Stripe secret key), and re-copy the full key from Stripe into Disputifier, making sure there are no extra spaces or missing characters. If the key still doesn't work, create a new restricted key in Stripe with the same permissions from Part 2 and enter that one instead.

The integration saved, but disputes or transactions aren't coming through. This usually means a permission group is missing Write access. In Stripe, go to Developers > API keys, open your Disputifier key, and confirm that Core, Connect, Issuing, All webhook resources, and Radar all have Write access. If you change any permissions, you'll need to create a new key and update it in Disputifier, since Stripe doesn't allow editing permissions on an existing key.

If you've checked everything above and the Stripe integration still isn't working, contact the Disputifier team through the live chat option in the app. Include your store or website URL and let us know which step the issue occurs at so we can help.

Related Articles
Did this answer your question?