Help Center/Admin Operations/Open a payment dispute, add evidence and resolve it
Admin Operations•Last updated: 2026-10-20•3 min read

Open a payment dispute, add evidence and resolve it

A dispute is tied to one SUCCEEDED payment: OPEN, EVIDENCE, then resolved for the platform (the charge stands) or against it (the member claim is upheld). Resolving never moves money by itself.

Have questions or need step-by-step guidance on this topic?

Ask AI Copilot

Step-by-Step Procedure

1

Open the dispute

On "Disputes" (/admin/payments/disputes) click "New Record", enter the "Payment intent ID", the "Disputed amount" (at most the amount paid) and the "Reason", then "Save Record". Only one dispute per payment can be unresolved.

2

Add evidence

Click the pencil, choose "Add evidence note", write the "Evidence or resolution note" and optionally an "Evidence reference" (ticket, document or transaction), then save. The dispute moves to EVIDENCE; add as many notes as you need.

3

Resolve

Choose "Resolve for platform (charge stands)" or "Resolve against platform (member upheld)" and write the resolution note. A dispute cannot be resolved before at least one evidence note exists.

4

Link a refund (optional)

When resolving against the platform you may enter the "Linked refund ID" of a refund of the same payment. Create and process that refund on "Refunds": the dispute itself does not pay anything.

Expected Operational Outcome

The dispute is closed with its resolution note, evidence list and optional refund link; the history is kept.

Troubleshooting & Failure Modes

Symptom: "Add evidence before resolving"
Likely Cause: The dispute is still OPEN.
Resolution: Add an evidence note first.
Symptom: "That refund belongs to a different payment."
Likely Cause: The refund id is for another intent.
Resolution: Use a refund of the disputed payment.

Was this guide helpful?

Help us refine our platform documentation