Current (2025-04-01)Platforms (Connect) API
Merchants Disputes
Merchants disputes management endpoints
Was this page helpful?
Merchants disputes management endpoints
apiKey Your Chargeflow API key, sent on every request. Generate one in the Chargeflow App, or see API keys.
In: header
application/json
TypeScript Definitions
Use the request body type in TypeScript.
The unique dispute identifier appears on the source (processor) from which the dispute originated.
length <= 128The unique Chargeflow account identifier to which the dispute belongs. (Platforms only)
^[0-9a-fA-F]{24}$The time at which the dispute was created at the processor in ISO 8601 format.
date-timeThe reason the cardholder has disputed the transaction.
Value in
The deadline to submit evidence to challenge the dispute in ISO 8601 format.
date-timeDisputed amount. Equal to or less than the disputed transaction amount.
0 <= valueThree-letter ISO 4217 currency code in uppercase.
^[A-Z]{3}$3 <= length <= 3The current status of the dispute.
Value in
The stage of the dispute. Default is chargeback.
"Chargeback"Value in
Creates a new Chargeflow transaction.
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/public/2025-04-01/platform/disputes" \ -H "Content-Type: application/json" \ -d '{ "source_id": "du_123456789", "account_id": "66e6ea9ecd94925a9f8060d9", "created_at": "2024-02-10T12:00:00Z", "reason": "fraud", "due_by": "2024-02-20T12:00:00Z", "amount": 100, "currency": "USD", "status": "needs_response" }'{ "id": "66e6ea9ecd94925a9f8060d9", "source": "stripe", "source_id": "du_123456789", "account_id": "66e6ea9ecd94925a9f8060d9", "ext_account_id": "acc_123456", "created_at": "2024-02-10T12:00:00Z", "reason": "fraud", "due_by": "2024-02-20T12:00:00Z", "amount": 100, "currency": "USD", "status": "needs_response", "stage": "Chargeback", "closed_at": "2025-01-27T10:00:00Z", "transaction": "66e6ea9ecd94925a9f8060d9", "subscription": "66e6ea9ecd94925a9f8060d9", "order": "ord_1234567890"}