Infrações (MED)

Quando um pagador aciona o Mecanismo Especial de Devolução por fraude ou erro, você é avisado na hora e tem um prazo curto pra defender a transação ou aceitar a devolução antes do Banco Central bater o martelo.

MED, visão completa GETGET /user/infractions/user/infractions POSTPOST defesa/defenses Webhooks

Quando uma cobrança recebida vira disputa MED, a PayZu cria uma infração e você pode submeter defesa via API. O que é o MED, prazos e ciclo de vida completos em MED, visão completa.

O prazo para responder é definido pelo Bacen, geralmente 72h. Sem defesa dentro do prazo, o valor pode ser devolvido automaticamente. Configure alerta interno ao receber o callback com infraction.

Listar infrações

curl "https://api.payzu.processamento.com/v1/user/infractions?status=OPEN&page=1&limit=50" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json"

Schema em GET /user/infractions.

Detalhe da infração

Retorna motivo, valor contestado, prazo e a transação relacionada.

curl "https://api.payzu.processamento.com/v1/user/infractions/INFRACTION_ID" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json"

Schema em GET /user/infractions/{id}.

Submeter defesa

curl -X POST "https://api.payzu.processamento.com/v1/user/infractions/INFRACTION_ID/defenses" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Schema em POST .../defenses.

O schema do body desta operação não está publicado no spec público. Para enviar defesa com justificativa e anexos, contate o suporte para confirmar os campos.

Acompanhar defesas

Listar todas as defesas submetidas:

curl "https://api.payzu.processamento.com/v1/user/infractions/INFRACTION_ID/defenses" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json"

Schema em GET .../defenses e GET .../defenses/{defenseId}.

Boas práticas

Alerta automático ao receber infraction no callback, o prazo é curto.
Persista o expiresAt da infração e crie task agendada.
Guarde evidências (logs de DICT antes do pagamento, comprovante, conversa com cliente), facilita defesa.
Aceite ou conteste rapidamente, silêncio costuma ser interpretado como aceitação.

Os valores de status, type, reportedBy e resultado da análise estão no Glossário.

Próximos passos

Receber Pix Webhooks

Precisa de ajuda?

Abrir chamado