违规处理 (MED)

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

MED（特别退款机制） 是 Bacen 针对欺诈、付款人错误或合理怀疑情形下对 Pix 进行争议处理的流程。当收到的收款变成争议时，PayZu 会创建违规记录（infraction），您可以通过 API 提交答辩。

答辩期限由 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 日志、付款凭证、与客户的对话记录），便于答辩。
快速接受或反驳，沉默通常被视为接受。

MED 的完整细节、状态和生命周期见 MED 完整概览。

需要帮助？

提交工单知识库支持门户