API Internet BankingPix Med

Answer a MED dispute

Records the account holder's response to the report: `AGREE` acknowledges the fraud, `DISAGREE` contests it. The answer is **not** sent to the settlement bank. It is stored and forwarded, together with the evidence files attached to the dispute, to the team that conducts the dispute in the scheme. Nothing about the dispute state changes here — answering records your side of the case, it does not close it. Attach evidence **before** answering: the answer is what closes the package, and files added afterwards are refused with `409 conflict`. The answer is sent once; a second call fails with `409 conflict`. If the answer was recorded but the forwarding has not gone out yet, repeating the call returns `202` and retries it without overwriting what was stored.

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.

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
answeredboolean
answeredAtdatetimeOptional
messagestringOptional

Errors

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