Infractions (MED)

When a payer opens a Special Return Mechanism claim for fraud or error, you get notified right away and have a short window to defend the transaction or accept the refund before the Central Bank makes the call.

MED, full overview GETGET /user/infractions/user/infractions POSTPOST defense/defenses Webhooks

When a received charge becomes a MED dispute, PayZu creates an infraction and you can submit a defense via API. What the MED is, deadlines and full lifecycle in MED, full overview.

The response deadline is set by Bacen, usually 72h. Without a defense within the deadline, the amount may be refunded automatically. Configure an internal alert when receiving the callback with infraction.

List infractions

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 at GET /user/infractions.

Infraction detail

Returns reason, contested amount, deadline and the related transaction.

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

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

Submit defense

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 at POST .../defenses.

The body schema for this operation is not published in the public spec. To submit a defense with justification and attachments, contact support to confirm the fields.

Track defenses

List all submitted defenses:

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

Schema at GET .../defenses and GET .../defenses/{defenseId}.

Best practices

Automatic alert when receiving infraction in the callback, the deadline is short.
Persist the infraction's expiresAt and create a scheduled task.
Keep evidence (DICT logs before the payment, receipt, conversation with customer), it makes the defense easier.
Accept or contest quickly, silence is usually interpreted as acceptance.

The values for status, type, reportedBy and analysis result are in the Glossary.

Next steps

Receive Pix Webhooks

Need help?

Open ticket