Skip to navigation

Answer a MED dispute

Records the account holder’s response to the report: AGREE acknowledges the fraud, DISAGREE contests it.

The answer and the attached evidence enter CorpX’s review: reviewStatus moves from awaiting_defense to pending_review and a pix.med.review.updated webhook with reason: submitted is sent. Answering records the account holder’s side of the case; the decision comes later, through the webhook.

Attach evidence before answering: after the answer the dispute only accepts attachments again if the review asks for clarification (info_requested); otherwise evidence/* answers 409 med_not_writable.

The answer is sent once; a second call fails with 409 conflict.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

accountIdstringRequired
Account identifier.
idstringRequired

The medId (infraction report id).

Headers

X-Tenant-IdstringRequired
Tenant context used for authorization and routing.
Idempotency-KeystringOptional

Optional client-generated idempotency token (recommended for safe retries).

X-Request-TimestampstringRequired

Unix seconds. Required on the signed host; tolerance is 300s either way (403 request_timestamp_skew).

X-Content-SHA256stringRequired

Lowercase hex SHA-256 of the body. An empty body hashes the empty string, so the header is always present. Mismatch returns 400 body_hash_mismatch.

X-Request-SignaturestringRequired

Detached JWS (<protected>..<signature>, ES256 or PS256) over METHOD\nPATH?QUERY\nTIMESTAMP\nIDEMPOTENCY_KEY_OR_EMPTY\nX_CONTENT_SHA256.

Request

This endpoint expects an object.
resultenumRequired

AGREE acknowledges the fraud; DISAGREE contests the report.

Allowed values:
reasonstringOptional

Your defense, free text. Required on DISAGREE: a contestation with no justification supports nothing in the analysis. Files go through the evidence routes, before this call.

Response

Answer recorded and forwarded for analysis.
medIdstring
resultenum
Allowed values:
answeredboolean
answeredAtdatetimeOptional
reviewStatusenumOptional

Stage of CorpX’s review. awaiting_defense → pending_review (→ info_requested → pending_review) → in_execution → refunded | awaiting_funds, or refused. awaiting_result is the dispute CorpX opened on the holder’s behalf (direction: opened): outside the review, waiting for the settlement bank.

messagestringOptional

Errors

400
Bad Request Error
404
Not Found Error
409
Conflict Error
422
Unprocessable Entity Error
500
Internal Server Error