Disputes

Handle payment disputes, chargebacks, and evidence submission.

Authentication Collections Payouts Customers Balances Webhooks Products Disputes FX Rates

GET/v1/disputes

List disputes

Parameters

Name	Type	In	Required	Description
`status`	`string`	query	Optional	Filter: needs_response, under_review, won, lost
`limit`	`integer`	query	Optional	Number of results

Response Codes

200Disputes listed

1{
2  "object": "list",
3  "data": [
4    {
5      "id": "disp_abc123",
6      "object": "dispute",
7      "collection_id": "col_a1b2c3d4",
8      "amount": 5000,
9      "currency": "USD",
10      "reason": "fraudulent",
11      "status": "needs_response",
12      "due_date": "2026-05-15T23:59:59Z",
13      "created_at": "2026-05-01T08:00:00Z"
14    }
15  ]
16}

POST/v1/disputes/{id}/evidence

Submit evidence for a dispute

Parameters

Name	Type	In	Required	Description
`id`	`string`	path	Required	Dispute ID
`evidence_type`	`string`	body	Required	Type of evidence being submitted
`content`	`string`	body	Required	Evidence content or file URL

Response Codes

200Evidence submitted400Invalid evidence or dispute closed404Dispute not found

1{
2  "id": "disp_abc123",
3  "status": "under_review",
4  "evidence": [
5    {
6      "type": "receipt",
7      "submitted_at": "2026-05-02T10:00:00Z"
8    }
9  ]
10}

POST/v1/disputes/{id}/accept

Accept a dispute (concede the chargeback)

Parameters

Name	Type	In	Required	Description
`id`	`string`	path	Required	Dispute ID

Response Codes

200Dispute accepted400Dispute already resolved

1{
2  "id": "disp_abc123",
3  "status": "lost",
4  "accepted_at": "2026-05-02T10:30:00Z"
5}