Skip to navigation

pix.med.updated

Atualização de MED

Enviado quando o status de uma disputa MED muda. É por aqui que você fica sabendo do desfecho, e é a única fonte de estado: o POST .../answer só registra a sua defesa (que segue para análise fora da API), e a disputa também se move por ação do BACEN e do banco do reclamante.

Reentrega do mesmo status não gera evento novo, e evento atrasado (carimbo do liquidante anterior ao que já registramos) é descartado — o status nunca regride.

Estrutura do data:

  • medId: Identificador da disputa (mesmo do pix.med.opened).
  • originalEndToEnd: endToEndId da transação PIX em disputa.
  • amount: Valor disputado.
  • reasonCode: Motivo reportado.
  • clientAnswerDeadlineIso: Prazo da sua resposta (o mesmo da abertura).
  • status: Status atual do MED — vocabulário próprio (OPEN, PENDING_DECISION, ACCEPTED, REJECTED, CANCELED; ver tabela de status acima).

Mapeamento do status do liquidante — o valor cru nunca sai no evento:

Status do liquidantedata.status
under-client-analysis, receivedOPEN
client-analysis-delayPENDING_DECISION
closed-full-refund, closed-partial-refundACCEPTED
closed-no-refundREJECTED
canceledCANCELED

Status desconhecido vira OPEN, não desfecho: perder a abertura de uma disputa custa o seu prazo de resposta, receber uma a mais só custa uma consulta.

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).