disputes

Submit a draft evidence counter to the processor (one-shot)

Submit a draft counter's evidence to the payment processor. This is one-shot and terminal for this round: the evidence is sent to the processor as your final response, the counter moves to submitted, and it can no longer be edited.

Only a draft counter on a dispute that is currently awaiting a response (e.g. Stripe needs_response) can be submitted — otherwise the call returns 400. Every attached file must both belong to you and have passed a malware scan (clean); otherwise the submission is rejected with 422 and nothing is sent. The dispute itself transitions (e.g. to under_review) when the processor's webhook confirms receipt, not synchronously here.

post/api/v1/disputes/{business_id}/counters/{counter_id}/submit

Request

  • Base URL: https://dev-api.truemed.com
  • URL: https://dev-api.truemed.com/api/v1/disputes/{business_id}/counters/{counter_id}/submit
  • Auth: API key in header x-truemed-api-key

Path parameters

business_idstring required

The Truemed dispute ID (UUID).

counter_idstring required

The Truemed counter ID (UUID).

Response

Successful response

counter_idstring required

Stable Truemed counter ID (UUID).

created_atstring date-time required

When this counter was created.

phase'inquiry' | 'dispute' | 'pre_arbitration' | 'arbitration' required

Which round of a dispute this is — orthogonal to DisputeState (comparison doc §4.3/§5).

revisioninteger required

Optimistic-lock revision; echo it back on the next draft save to detect conflicts.

state'draft' | 'submitted' | 'withdrawn' | 'superseded' required

Lifecycle of a dispute-evidence response (a "counter").

draft autosaves; submitted is terminal-for-this-round (one-shot to the processor); withdrawn is a discarded draft; superseded is a prior round's submission once a new phase opens. Only draft is mutable.

submitted_atstring date-time nullable

When this counter was submitted to the processor.

submitted_bystring nullable

Email of the dashboard user who submitted this counter; null for drafts or API-key submissions.

updated_atstring date-time required

When this counter was last updated.

Changes

No recorded changes to this operation across all 1 revision of this API.