Skip to navigation

pix.med.opened

MED aberto contra uma transação

Enviado quando uma nova disputa MED (Mecanismo Especial de Devolução) é aberta contra uma transação creditada em uma das suas contas. A partir dele começa a correr o prazo de 48h para a sua resposta — ver Guia de Disputas.

Estrutura do data:

  • medId: Identificador da disputa (infraction report). É o {medId} das rotas REST.
  • originalEndToEnd: endToEndId da transação PIX em disputa.
  • amount: Valor disputado.
  • reasonCode: Motivo reportado pelo arranjo, cru (ex.: scam-or-fraud, unauthorized-transaction).
  • claimMessage: Detalhes textuais informados pelo reclamante (quando presente).
  • openedAtIso: Data de abertura do MED (ISO 8601).
  • clientAnswerDeadlineIso: Prazo da sua resposta — openedAtIso + 48h.
  • status: OPEN na abertura.

Headers

X-SignaturestringOptional

Present when the subscription uses authType: HMAC: base64(HMAC_SHA256(secret, raw_request_body)) (standard Base64, with padding). Compare in constant time against your own computation over the raw body.

Payload

The payload of this webhook request is an object.
idstringRequired

Deterministic event id. Same id means the same event, possibly redelivered — deduplicate on it.

typeenumRequired

Event type. Full list at GET /v1/webhooks/events.

Allowed values:
occurredAtdatetimeRequired

RFC 3339, UTC with Z.

schemaVersionstringRequired

1.0 today; bumped only on breaking payload changes.

environmentenumRequired
Environment that emitted the event.
Allowed values:
tenantIdstringRequired
Tenant the event belongs to.
dataobjectRequired

Event-specific payload. See each webhook.

accountIdstringOptional

CorpX account where the event happened. Empty on cross-account events.

Response

2XX

Acknowledged. Any 2xx within 10 seconds stops retries; anything else is retried with backoff (see the Webhooks guide).