billingHelp

Disputes and evidence

Chargebacks, inquiries and fraud warnings — deadlines, what evidence to gather, and how to submit it for each provider.

A dispute is opened by the buyer's bank, not by the buyer through your store. It arrives by webhook from Stripe, PayPal or Square. Authorize.net does not send dispute notifications; handle those in its Merchant Interface.

Dispute statuses A chargeback opens as Opened and moves to Evidence due; after you submit evidence it is Submitted and ends Won or Lost. An inquiry may close without money moving, or escalate into an opened chargeback. A fraud warning moves no money: refunding the payment usually prevents a chargeback, and the warning is then closed. Chargeback Opened Evidence due Submitted Won Lost payment back to Paid (flagged)payment becomes Chargeback Inquiry Inquiry Closed Escalated becomes a chargeback Fraud warning Fraud warning Closed refund now → usually no chargeback
Dispute statuses
Text description

A chargeback opens as Opened and moves to Evidence due; after you submit evidence it is Submitted and ends Won or Lost. An inquiry may close without money moving, or escalate into an opened chargeback. A fraud warning moves no money: refunding the payment usually prevents a chargeback, and the warning is then closed.

The Disputes screen#

Open cases are listed with the soonest evidence deadline first. Due soon marks deadlines within 3 days. Owners and admins are emailed when a dispute opens, with its deadline.

KindMoney moved?What to do
ChargebackYes: the amount is held backSubmit evidence before the deadline
InquiryNoAnswer the questions; it may close or escalate into a chargeback
Fraud warning (Stripe)NoUsually refund now: a refund costs less than a lost chargeback

What evidence to gather#

Good evidence answers the bank's reason code directly. Collect only what applies:

  • Proof of purchase — the receipt, the confirmation code, the date and the product.
  • Proof of delivery or use — download logs, license check-ins (the license's machine list), sign-in history, shipping tracking.
  • Communication — emails with the buyer, especially any where they confirm the purchase or the problem was solved.
  • Your policies — the terms and refund policy as shown at the time of purchase, and that the buyer accepted them.
  • For "canceled subscription" claims — the dates the subscription was active and that it was not canceled before the charge.

Write a short, factual note that ties the files to the reason. Avoid emotion and long histories.

Adding and submitting evidence#

On the dispute's page:

  1. Add files — PDF, PNG, JPEG or plain text, up to 5 MB each. The type is checked from the content, not the file name. Files are stored privately and only your workspace can download them.
  2. Add notes.
  3. Submit:
    • Stripe: the notes, the customer's email, the product description and the first file are sent through the API in one submission. Submit once you have everything; Stripe accepts one submission.
    • PayPal and Square: submit in the provider's dashboard, then press Submit here to record it, so the case is tracked.

When the provider decides, the case becomes Won (the payment returns to Paid, flagged) or Lost (the payment becomes Chargeback and paid access ends).

Keeping disputes rare#

  • Use a clear product name and description; the store name appears on the buyer's statement.
  • Answer support email quickly and refund when a buyer is unhappy.
  • Watch the dispute rate on Analytics: the alert threshold is 1.0%, with a warning at 0.75%.

Tutorial: handle a dispute step by step