MED
Acompanhe pela API as infrações do MED (Mecanismo Especial de Devolução) abertas contra Pix que você recebeu e responda a cada uma com a sua defesa.
Operações
Leia o motivo, o Pix contestado e o prazo, ou liste o que vence primeiro.
2. Responder uma infração MEDEnvie a defesa com texto e anexos enquanto a infração está OPEN.
Veja o status de cada defesa enviada e baixe os anexos.
Origem e tipo
| Campo | O que traz |
|---|---|
reportedBy | Quem abriu: DEBITED_PARTICIPANT, a instituição da conta debitada, ou CREDITED_PARTICIPANT, a instituição da conta creditada. |
type | O tipo informado: REFUND_REQUEST, FRAUD ou REFUND_CANCELLED. |
reportDetails | O motivo, no texto enviado pela instituição parceira. |
protocol | O código da infração no Bacen. As rotas usam o id da PayZu. |
Ciclo de vida
Os status vêm da instituição parceira, e a PayZu repassa cada mudança. Enviar uma defesa muda o status da defesa, não o da infração.
| Status | O que muda para você |
|---|---|
OPEN | A infração aceita defesa. |
ACKNOWLEDGED, DEFENDED, ANSWERED, WAITING_PSP, WAITING_ADJUSTMENTS | Etapas informadas pela instituição parceira; a API não aceita defesa nelas. |
CLOSED | Fim da análise. analysisResult traz AGREED ou DISAGREED, e analysisDetails, o texto da decisão quando a instituição envia. |
CANCELLED | Infração cancelada; não aceita defesa. |
Prazos
expiresAt, quando presente, é o prazo final para a defesa. Filtre a listagem por expiresAtFrom e expiresAtTo para ver o que vence antes.
Efeito no saldo
| Momento | O que acontece |
|---|---|
| A infração chega | Conforme a configuração da conta e o valor do Pix, a PayZu bloqueia o valor contestado: ele sai de balanceAvailable e passa a balanceBlocked. |
Fechamento com AGREED | O valor do Pix é devolvido ao pagador, e a transação registra refundReason: "INFRACTION". |
Fechamento com DISAGREED ou infração cancelada | O bloqueio é desfeito e o valor volta ao saldo disponível. |
Cada mudança na infração gera um aviso.
O evento INFRACTION_CHANGED vai aos webhooks da conta, e a callbackUrl do Pix contestado recebe um aviso com o objeto infraction no corpo, também no encerramento automático. O corpo está em Infração MED atualizada.