违规处理 (MED)

当付款人以欺诈或错误为由发起特别退款机制（MED）申诉时，你会立即收到通知，并有一小段时间为该笔交易申辩或接受退款，最终由巴西央行裁定。

MED 完整概览 GETGET /user/infractions/user/infractions POSTPOST 答辩/defenses Webhooks

当收到的收款变成 MED 争议时，PayZu 会创建违规记录（infraction），您可以通过 API 提交答辩。MED 是什么、期限和完整生命周期见 MED 完整概览。

答辩期限由 Bacen 规定，通常为 72 小时。若未在期限内提交答辩，款项可能被自动退回。在收到带 infraction 的 callback 时，请配置内部告警。

列出违规记录

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 见 GET /user/infractions。

违规详情

返回原因、争议金额、期限以及关联交易。

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

Schema 见 GET /user/infractions/{id}。

提交答辩

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

该操作的 body schema 未在公开 spec 中发布。如需提交带理由和附件的答辩，请联系支持团队以确认字段。

跟踪答辩

列出所有已提交的答辩：

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

Schema 见 GET .../defenses 和 GET .../defenses/{defenseId}。

最佳实践

收到 callback 中的 infraction 时自动告警，期限很短。
持久化违规的 expiresAt 并创建定时任务。
保留证据（付款前的 DICT 日志、付款凭证、与客户的对话记录），便于答辩。
快速接受或反驳，沉默通常被视为接受。

status、type、reportedBy 和分析结果的取值见术语表。

下一步

接收 Pix Webhooks

需要帮助？

提交工单