User Guide

Disputes

Evidence drafted for you. You review and sign every submission.

Part 1

How disputes work

When a dispute opens on your connected Stripe account, Foxhound gets the webhook within seconds and starts assembling evidence. It pulls the recovery email history for that customer, the prior charges on the same card, the address and card verification results, the Stripe Radar signals, and whether 3D Secure authentication happened.

What comes out is a draft. It sits and waits for a person.

The state a dispute is in

01
Draft
Evidence is being assembled. Nothing has been submitted.
02
Pending review
Evidence is ready and waiting for a person on your team.
03
Approved
Somebody approved it. It can now be submitted.
04
Submitted
Sent to Stripe. Waiting on the issuer.
05
Won
The issuer found for you.
06
Lost
The issuer found for the cardholder.
Note. The approval step is enforced by the database, not by a setting. There is no state that reaches Stripe without passing through an approval, and no way to configure one.
Part 2

Evidence building

Foxhound stages evidence from five sources automatically.

  1. 01Prior charge history: previous successful charges from the same customer on the same card.
  2. 02Recovery email history: if a sequence ran for this customer, the email content and whether it was opened or clicked.
  3. 03Address and card verification results from the original charge.
  4. 04Stripe Radar signals: the risk score and any rules that fired.
  5. 053D Secure: whether authentication was completed.

The free-text field at the bottom of the evidence form is for everything else: shipping details, support tickets, correspondence. Add it before anyone approves.

Part 3

Review and submit

Read the staged evidence on the dispute's page, add what only you know, and approve it. Approval is what allows submission, and Foxhound submits to Stripe through the API once it has one.

There is no auto-submit

There is no auto-submit toggle. There never has been.

Note. Foxhound has no automatic-submission setting and will not have one: the approval gate is schema-enforced, so a submission with nobody's name on it cannot be built, let alone configured.

Accepting instead

Accepting closes the dispute without submitting evidence. Stripe charges you its dispute fee, and Foxhound charges nothing on a dispute you accept.

Part 4

Billing

20% of disputes Foxhound wins, capped at $500 per dispute. Nothing on disputes you lose or accept.

Nothing is charged on a dispute you lose, a dispute you accept, or a dispute you handled yourself outside Foxhound.