Skip to main content
POST
Abrir caso MED

Autorizações

Authorization
string
header
obrigatório

JWT bearer token issued by the identity provider.

Cabeçalhos

Idempotency-Key
string

Idempotency key, max 255 characters

Corpo

application/json
caseId
string
obrigatório

Caller-assigned business identifier for the MED dispute case.

Exemplo:

"MED-2025-001"

originalEndToEndId
string
obrigatório

PIX EndToEndID of the original disputed transaction, format E{ISPB}{YYYYMMDD}{uniqueID}.

Exemplo:

"E1234567820250307ABCDEFGHIJKLMNO"

reason
string
obrigatório

Motivation for the dispute: FRAUD (suspected fraud), OPERATIONAL_FLAW (operational error), or CANCELLED (payer cancellation).

Exemplo:

"FRAUD"

Resposta

Created

analysisDeadlineAt
string
obrigatório

UTC deadline for the initial analysis window (7 days), RFC 3339 format.

Exemplo:

"2025-03-17T14:30:00Z"

caseId
string
obrigatório

Caller-assigned business identifier for the MED dispute case.

Exemplo:

"MED-2025-001"

completionDeadlineAt
string
obrigatório

UTC deadline for full case completion (10 days), RFC 3339 format.

Exemplo:

"2025-04-06T14:30:00Z"

createdAt
string
obrigatório

UTC timestamp when the case was created, RFC 3339 format.

Exemplo:

"2025-03-07T14:30:00Z"

evidenceReferences
object[] | null
obrigatório

Evidence attachments supporting the dispute.

id
string
obrigatório

Server-assigned UUID of the MED case.

Exemplo:

"550e8400-e29b-41d4-a716-446655440000"

originalEndToEndId
string
obrigatório

PIX EndToEndID of the original disputed transaction, format E{ISPB}{YYYYMMDD}{uniqueID}.

Exemplo:

"E1234567820250307ABCDEFGHIJKLMNO"

reason
string
obrigatório

Motivation for the dispute: FRAUD, OPERATIONAL_FLAW, or CANCELLED.

Exemplo:

"FRAUD"

status
string
obrigatório

Lifecycle state: INITIATED, UNDER_ANALYSIS, AWAITING_RESPONSE, APPROVED, REJECTED, EXPIRED, or COMPLETED.

Exemplo:

"INITIATED"

updatedAt
string
obrigatório

UTC timestamp of the last update to the case, RFC 3339 format.

Exemplo:

"2025-03-07T14:30:00Z"

refundAmount
integer<int64>

Refund amount in centavos (BRL minor units); zero unless the case was resolved with a refund.

Exemplo:

0

resolution
string

Outcome once resolved: APPROVED, REJECTED, CANCELLED_BY_OPENER, DEADLINE_EXPIRED, or AUTO_APPROVED; empty while unresolved.

Exemplo:

""

resolvedAt
string

UTC timestamp when the case was resolved, RFC 3339 format; empty while unresolved.

Exemplo:

""