Skip to navigation
API Internet BankingPix Med

Get a MED dispute

Everything from the list plus the timeline visible to the account holder (events), the messages exchanged with the review (messages), the attachments with signed downloadUrl (evidences), the steps CorpX already executed in the return (steps) and the can* flags saying what is enabled right now. In info_requested, infoRequest carries the review’s question and its deadline.

Authentication

AuthorizationBearer

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

Path parameters

accountIdstringRequired
Account identifier.
idstringRequired

The medId.

Headers

X-Tenant-IdstringRequired
Tenant context used for authorization and routing.
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.

Response

Dispute detail.
medIdstring

Infraction report id. Same value as data.medId in the webhooks.

accountIdstring
tenantIdstring
endToEndIdstring
E2E of the disputed PIX.
amountdouble

Disputed amount. Amount in BRL. Max 2 decimal places (e.g., 150.75 for R$150,75).

answeredboolean
Whether the holder's response was recorded for this dispute.
updatedAtdatetime
reviewStatusenum

Stage of CorpX's review. awaiting_defense → pending_review (→ info_requested → pending_review) → in_execution → refunded | awaiting_funds, or refused.

canUploadboolean
canAnswerboolean
canMessageboolean
canSubmitboolean
eventslist of objects

Timeline visible to the account holder; message texts are in Portuguese.

messageslist of objects
evidenceslist of objects
stepslist of objects

Return steps CorpX already executed, in text. Appears from in_execution on.

transactionIdstringOptional
Our statement entry for the disputed PIX, when it exists on the platform. Empty for credits that predate the account here.
reasonCodestringOptional
Reason reported by the scheme, passed through raw.
claimMessagestringOptional

Free-text details from the claimant, when present.

claimantBankstringOptional
Claimant's bank. The scheme does not disclose the claimant's name or tax id to the receiving party.
openedAtdatetimeOptional
clientAnswerDeadlinedatetimeOptional

openedAt + 48h. Nothing is auto-rejected on expiry: the dispute stays alive, the client just loses the chance to state their case.

answeredAtdatetimeOptional
answerResultenumOptional
Allowed values:
answerstringOptional
The justification sent with the response.
closedAtdatetimeOptional
Set when a webhook reported the dispute as closed.
infoDueAtdatetime or nullOptional

Deadline of the pending clarification, in info_requested.

lockStatusenumOptional
Balance hold for the dispute. Absent for disputes that predate the automatic hold.
Allowed values:
lockedAmountdoubleOptional

Amount currently held, in BRL. 0 when nothing is held.

refundedTotaldoubleOptional
Sum of completed returns, in BRL.
remainingdoubleOptional

Disputed amount minus refundedTotal.

refundPartialbooleanOptional

true when the dispute closed with a partial return.

infoRequestobject or nullOptional

The review's question, present in info_requested.

Errors

403
Forbidden Error
404
Not Found Error
500
Internal Server Error