Disputes
Get Dispute
Changed onRetrieves one payment dispute with its timeline. Requires the Scale plan.
get/v1/shops/{shopId}/disputes/{disputeId}
Request
- Base URLhttps://api.sellauth.com
- AuthHTTP bearer
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Response
Example response
{
"dispute": {
"id": 1,
"shop_id": 1,
"invoice_id": 1,
"payment_id": null,
"payment_method_id": null,
"gateway": "STRIPE",
"gateway_dispute_id": "du_1QExampleDispute",
"gateway_payment_ref": "pi_3QExamplePaymentIntent",
"stage": "chargeback",
"status": "needs_response",
"is_final": false,
"funds_status": "withdrawn",
"reason": "fraudulent",
"contestable": true,
"gateway_status": "needs_response",
"gateway_substatus": null,
"gateway_reason": "fraudulent",
"network_reason_code": "10.4",
"card_brand": "visa",
"amount": "14.99",
"currency": "USD",
"amount_usd": "14.99",
"fee": "15.00",
"fee_currency": "USD",
"fee_usd": "15.00",
"is_partial": false,
"evidence_due_at": "2026-11-03T20:00:52.000000Z",
"opened_at": "2026-11-01T20:00:52.000000Z",
"responded_at": null,
"closed_at": null,
"gateway_updated_at": "2026-11-01T20:00:52.000000Z",
"gateway_version": null,
"fetched": true,
"invoice_status_before": null,
"invoice_flipped_at": null,
"livemode": true,
"created_at": "2026-11-01T20:00:52.000000Z",
"updated_at": "2026-11-01T20:00:52.000000Z",
"invoice": {
"id": 1,
"salt": "667e99ffee7e5",
"shop_id": 1,
"email": "customer@sellauth.test",
"price": "14.99",
"currency": "USD",
"status": "completed",
"gateway": "STRIPE",
"ip": "127.0.0.1",
"country_code": null,
"created_at": "2026-11-01T20:00:51.000000Z",
"completed_at": "2026-11-01T20:00:51.000000Z",
"unique_id": "667e99ffee7e5-0000000000001"
},
"payment_method": null
},
"timeline": [
{
"id": 1,
"type": "dispute_opened",
"actor": "gateway",
"data": {
"stage": "chargeback",
"amount": "14.99",
"reason": "fraudulent",
"status": "needs_response",
"gateway": "STRIPE",
"currency": "USD",
"dispute_id": 1,
"evidence_due_at": "2026-11-03T20:00:52+00:00"
},
"created_at": "2026-11-01T20:00:52.000000Z"
}
],
"actions": {
"cashback_usd": 0,
"affiliate_commission_usd": 0,
"is_topup": false,
"can_reclassify": false,
"buyer": {
"email": "customer@sellauth.test",
"ip": "127.0.0.1"
},
"blacklisted": {
"email": false,
"ip": false
},
"subscription": null
}
}Changes
- breaking
the response property
/became nullable for the status - breaking
the response property
/became nullable for the status - breaking
the response property
/became nullable for the status - breaking
the response property
/became nullable for the status - breaking
the response property
//became nullable for the status - breaking
the response property
/became nullable for the status - breaking
the response property
/became nullable for the status - breaking
the response property
/became nullable for the status - breaking
the response property
/became nullable for the status - breaking
the response property
/became nullable for the status - breaking
the response property
/became nullable for the status
- breaking
- info
endpoint added
- info