Stripe

Do I need to have a Stripe account?

No, we work with all processors and a Stripe integration is not required. Do note, some of our functionality is only available with Stripe currently (billing descriptors etc.)

Stripe Integration Instructions

  1. Create a new restricted API key in Stripe (https://dashboard.stripe.com/apikeys) ensuring that all the required permissions (see the full list below) are selected.

    1. Follow this link to open the API keys page in Stripe with all of our required permissions pre-filled: Create ChargebackStop link in Stripe

  2. Grab your Stripe account ID from your profile page (https://dashboard.stripe.com/settings/user).

  3. Login to ChargebackStop and under Settings > Integrations add your Stripe account ID and restricted key.

Stripe Integration Permissions

Permission

Description

Charges (Read and Write)

Required for matching network alerts to charges and processing refunds.

Customers (Read)

Essential for linking alerts to customers and accessing payment methods.

Events (Read and Write)

Ensures real-time updates on account changes without the need for frequent resource refetching.

PaymentIntents (Read and Write)

Used for correlating network alerts with charges and initiating refund processes.

⁠PaymentMethods (Read)

Helps match network alerts by analysing the BIN on card objects.

Products (Read):

Provides necessary information related to payment intents and subscriptions.

Prices (Read)

Displays information pertinent to subscriptions.

Subscriptions (Read and Write)

Facilitates the linking of payment intents to invoices, supporting refund and cancellation workflows.

Credit notes (Read and Write)

Enables viewing and managing invoice refunds when using Stripe Billing.

⁠Invoices (Write)

Allows for linking payment intents to their respective subscriptions and updating statement descriptors for Link payments.

Webhooks (Write)

Allows for ChargebackStop to setup webhooks for the platform to automate certain tasks in real time.

Disputes (read)

Allows the platform to sync the disputes to detect if the incoming alert is not disputed yet.

What is synced?

In order to match network alerts to your Stripe transactions and automate refunds, we need to sync the following data into our system:

→ Payment intents / charges

→ Customers

→ Refunds

→ Subscriptions

→ Payment methods (without card numbers)

→ Last 4 digits of card number

→ BIN

→ Disputes

→ Early fraud notification

Stripe made the decision to not disclose card brand, card last 4, authorisation code, BIN, or ARN for transactions paid for with Link in their API. As a result, If you use Stripe Link as a payment method in your Stripe integration, we won't be able to automatically match alerts to Stripe transactions.

If we cannot match an alert due to multiple matching Link transactions existing, you might still be charged for the alert. This is not a valid creditable scenario recognised by Verifi nor Ethoca.

There are a few suggested options to try and prevent unmatched alerts and potentially being charged for them:

  1. If you use Stripe Checkout we have a read made solution - please reach out to discuss

  2. If you don’t use Stripe Checkout then we have a solution but it does require some configuration your side - please reach out to discuss

  3. Use Link it in wallet mode. Read more details in Stripe documentation ("Link with card integrations" tab)

  4. Don’t offer Link

If these options don’t work for your specific case, then we can provide you with the opportunity to manually match these. Instead of us automatically resolving as “Not Refunded” we can add these to your “Action Required” queue. This gives you the opportunity to manually action this alert. Reach out to us, should you wish to activate this.

Last updated

Was this helpful?