Skip to main content
FunnelFox Billing dispute prevention alerts you about pending chargeback disputes before they reach card networks, reducing the risk of your payment provider account being blocked. You can set up dispute prevention from scratch or migrate from another tool.
This is a paid service. Please contact your Solutions Manager to enable it.

​
How it works

FunnelFox Billing intercepts disputes before they become chargebacks. Compare the two scenarios below to see the difference. Without dispute prevention:
1

Customer files a dispute

Customer files a transaction dispute with their bank.
2

Card network processes chargeback

Card network processes the chargeback and withdraws funds.
3

Account block risk

PSP blocks your merchant account due to frequent chargebacks.
With dispute prevention enabled:
1

Customer files a dispute

Customer files a transaction dispute with their card issuer.
2

Automatic refund

FunnelFox Billing automatically refunds the transaction before it becomes a chargeback.
3

Account stays protected

Your merchant account remains in good standing since no chargeback is recorded with the card network.

​
Setup

To enable dispute prevention, provide your merchant account details and connect your Stripe account. This allows FunnelFox Billing to monitor and respond to disputes automatically. Before you start, ask your Solutions Manager to enable dispute prevention, then follow the steps below.

​
1. Provide identifiers

Collect the following details and send them to your Solutions Manager.
1

Billing org ID

Your Billing org ID is part of your FF Billing dashboard URL: https://billing.funnelfox.com/{ORG_ID}/Copy the {ORG_ID} portion from your browser’s address bar.
2

Bank details (BIN/CAID)

Provide your BIN (Bank Identification Number) and CAID (Card Acceptance ID). Contact Stripe Support to get these values.
If you have a new Stripe account or low transaction volume, Stripe Support may not be able to provide BIN/CAID. Make 2 live purchases first — one with a Mastercard and one with a Visa card. You can do this quickly using Stripe Payment Links.
3

Billing descriptor

Your billing descriptor is the text shown on your customer’s card statement. If you use one Stripe account with multiple apps, provide a descriptor for each app.To find your billing descriptor:
  1. Log in to your Stripe Dashboard.
  2. Go to Settings in the top right corner.
  3. Select Business > Business details.
  4. Find yoour billing descriptor under the Statement descriptor.
4

Visa ARNs — optional

If you cannot find your BIN/CAID, provide Visa Acquirer Reference Numbers (ARNs) for 5 recent transactions instead.You can find ARNs in your Visa transactions where a refund has already been processed.

​
2. Create restricted key

  1. Log in to your Stripe dashboard.
  2. Go to Developers > API keys at the bottom left.
  1. Click + Create restricted key.
  1. Select Building your own integration and click Continue.
  1. Name your key.
  2. Set the following permissions:
  • Charges and refunds: Write
  • Invoices: Read
  • Credit notes: Read
  • Subscriptions: Write
  • Connect category: Read
  1. Click Create key.
  2. Provide the key to your Solutions Manager.

​
3. Set up FunnelFox Billing webhook

Skip this step if you’ve already completed the Set up FunnelFox Billing webhook step during your FunnelFox integration or Web SDK integration setup.
  1. Click + Add destination on the Developers > Webhooks page in Stripe.
  2. Select Your account under Events from.
  3. Select the following events and click Continue:
  • charge.refunded
  • charge.succeeded
  1. Select Webhook endpoint under Destination type and click Continue.
  2. Find your Organization ID in your FF Billing dashboard URL: https://billing.funnelfox.com/{ORG_ID}/
  3. Replace {ORG_ID} in https://billing.funnelfox.com/{ORG_ID}/v1/stripe/webhook?region=default with your Organization ID.
Your complete endpoint URL will look like https://billing.funnelfox.com/org_123a4b5678c9d0/v1/stripe/webhook?region=default.
  1. Paste the endpoint URL into the Endpoint URL field and click Create destination.
Your setup is complete. Due to the Visa and MasterCard application review process, this integration will go live in approximately two weeks.

​
Migration

If you’re already using a dispute prevention tool, you can migrate to FunnelFox Billing dispute prevention without going through the full setup. Your existing tool can transfer your account details, including BIN, descriptor, and identifiers directly to Merchanto, so you don’t need to collect and provide them manually.
1

Contact your existing dispute prevention provider

Send the following message to your current dispute prevention tool to initiate the transfer.
Hi Team,Hope all is well.We have decided to start working with a new provider. Could you please transfer our account to the new provider?Here are their details for the transfer:Ethoca - LeadProm - USD Account MM ()Verifi - Entity ID: Organization ID: Additionally, could you please provide the Ethoca and Verifi IDs of our account, so that our new provider can also open a transfer ticket on their side?Please initiate the transfer process, and our new provider will confirm the transfer from their end.Best regards,
Contact your Solutions Manager to get the FunnelFox Billing values for {ETHOCA_ACCOUNT_NUMBER}, {VERIFI_ENTITY_ID}, and {ORGANIZATION_ID} before sending this message.
2

Complete the remaining setup steps

Once the transfer is initiated, complete steps 2 and 3 from the Setup section above to create a restricted Stripe key and set up the FunnelFox Billing webhook if you haven’t already.