For AI agents: a documentation index is available at the root level at /llms.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
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.
Allowed values:
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 objectsOptionalDefaults to []
Evidence counters for this dispute (the full chain across phases).
due_bydatetime or nullOptional
Evidence submission deadline, if the dispute is challengeable.
metadatamap from strings to anyOptionalDefaults to {}
Arbitrary merchant-set metadata.
network_reason_codestring or nullOptional
Raw card-network reason code behind the dispute (e.g. Visa 10.4), if provided.
outcomeenum or nullOptional
Terminal outcome; null until the dispute resolves.
Allowed values:
payment_session_idstring or nullOptional
The Truemed payment session this dispute belongs to. Null for disputes on non-payment-session charges.
phaseenum or nullOptional
Which round of the dispute (inquiry, dispute, pre-arbitration, arbitration).
Allowed values:
prior_dispute_idstring or nullOptional
Truemed dispute ID (UUID) of the prior round in a pre-arbitration/re-filing chain, if any.
resolved_atdatetime or nullOptional
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
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.