Methods
| Method | Description |
|---|---|
list(query?) | List disputes with optional filters |
updateEvidence(disputeId, evidence) | Add or update evidence for a dispute |
submit(disputeId) | Submit a dispute for review |
close(disputeId) | Close a dispute (accept the chargeback) |
List disputes
Update evidence
Add evidence to support your case. Evidence can be files or text:File evidence
Text evidence
Evidence request fields
| Field | Type | Required | Description |
|---|---|---|---|
type | "file" | "text" | Yes | Evidence type |
file_id | string | File only | ID of an uploaded file |
category | string | Yes | Evidence category (e.g., "receipt", "customer_communication") |
description | string | No | Description of the evidence |
content | string | Text only | Text content of the evidence |
Submit a dispute
After adding all evidence, submit the dispute for review:Close a dispute
Accept the chargeback and close the dispute:Response data
| Field | Type | Description |
|---|---|---|
id | string | Dispute ID |
payment_id | string | Associated payment ID |
status | string | Dispute status |
amount | number | Disputed amount |
reason | string | Dispute reason |
evidence | array | Submitted evidence items |
created_at | string | ISO timestamp |
updated_at | string | ISO timestamp |