Accept Dispute

Accept (concede) a dispute when you don't intend to contest it — for example when the charge was already refunded outside Truemed, or when contesting a low-value chargeback isn't worth the effort. Accepting concedes the disputed amount to the cardholder and closes the dispute with the processor. This is **terminal**: the dispute moves to the `accepted` state and cannot be reopened. Only disputes in `needs_response` (an open chargeback awaiting evidence) can be accepted. Inquiries are warnings rather than chargebacks, and disputes already in a terminal state are immutable — accepting either returns `400`. The call is idempotent: accepting a dispute that's already `accepted` returns its current state instead of erroring, so a retried request is safe.

Authentication

x-truemed-api-keystring

Sales channel API key for merchant server-to-server authentication

Path parameters

business_idstringRequired

The Truemed dispute ID (UUID).

Response

Successful response
amountinteger
The original disputed amount in cents, independent of resolution.
created_atdatetime
When the dispute was created.
currencystring
ISO currency code of the disputed amount.
dispute_idstring

Stable Truemed dispute ID (UUID). Use this as the dispute’s identifier.

processorenum
Payment processor the dispute originated from.
processor_dispute_idstring

Raw payment-processor dispute ID (e.g. Stripe du_…), for reconciliation.

reasonenum
Canonical reason the dispute was filed.
stateenum
Canonical dispute state.
counterslist of objectsDefaults to []

Evidence counters for this dispute (the full chain across phases).

due_bydatetime or null
Evidence submission deadline, if the dispute is challengeable.
metadatamap from strings to anyDefaults to {}

Arbitrary merchant-set metadata.

network_reason_codestring or null

Raw card-network reason code behind the dispute (e.g. Visa 10.4), if provided.

outcomeenum or null

Terminal outcome; null until the dispute resolves.

phaseenum or null

Which round of the dispute (inquiry, dispute, pre-arbitration, arbitration).

prior_dispute_idstring or null

Truemed dispute ID (UUID) of the prior round in a pre-arbitration/re-filing chain, if any.

resolved_atdatetime or null
When the dispute reached a terminal state.

Errors

400
Bad Request Error
404
Not Found Error
405
Method Not Allowed Error
500
Internal Server Error
501
Not Implemented Error