New Chargeflow docs. Everything for merchants, platforms, and the API in one place.
Log in
Current (2025-04-01)Merchants APIDisputes

Enrich Dispute

Enriches a dispute with additional data (transaction, order, subscription, and more) to improve your chances of winning. Array properties are overwritten in full, so send every item you want to keep.

PATCH
/public/2025-04-01/disputes/{disputeId}
x-api-key<token>

Your Chargeflow API key, sent on every request. Generate one in the Chargeflow App, or see API keys.

In: header

Path Parameters

disputeId*string

The unique Chargeflow object identifier of the dispute.

Match^[0-9a-fA-F]{24}$

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://example.com/public/2025-04-01/disputes/66e6ea9ecd94925a9f8060d9" \  -H "Content-Type: application/json" \  -d '{    "transaction": {      "source_id": "tx_1234567890",      "created_at": "2024-02-10T12:00:00Z",      "type": "paid",      "amount": 100,      "currency": "USD",      "payment_method": {        "type": "card",        "name": "John Doe",        "last4": "1234",        "expiry_month": 1,        "expiry_year": 2025,        "brand": "visa"      }    }  }'
{  "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"}
Was this page helpful?