# 违规处理 (MED) (/zh/docs/pix-processamento/tutoriais/infractions)

<QuickLinks>
  <QuickLink href="/docs/pix-processamento/med" title="MED 完整概览" />

  <QuickLink href="/docs/pix-processamento/endpoints/infractions/get_infractions" title="GET /user/infractions" method="GET" path="/user/infractions" />

  <QuickLink href="/docs/pix-processamento/endpoints/infractions/post_infractions_defense" title="POST 答辩" method="POST" path="/defenses" />

  <QuickLink href="/docs/pix-processamento/webhooks" title="Webhooks" />
</QuickLinks>

<Mermaid
  chart="`
flowchart LR
  A[&#x22;付款人提出争议&#x22;] --> B[&#x22;callback 携带 infraction&#x22;]
  B --> C[&#x22;GET /user/infractions/{id}&#x22;]
  C --> D{&#x22;决策&#x22;}
  D -->|&#x22;答辩&#x22;| E[&#x22;POST .../defenses&#x22;]
  D -->|&#x22;等待&#x22;| F[&#x22;Bacen 分析&#x22;]
  E --> F
  F --> G{&#x22;裁决&#x22;}
  G -->|&#x22;AGREED&#x22;| H[&#x22;交易 REFUNDED&#x22;]
  G -->|&#x22;DISAGREED&#x22;| I[&#x22;交易保持&#x22;]

  click B &#x22;/zh/docs/pix-processamento/webhooks&#x22; &#x22;callback 携带 infraction&#x22;
  click C &#x22;/zh/docs/pix-processamento/endpoints/infractions/get_infractions_by_id&#x22; &#x22;GET 详情&#x22;
  click E &#x22;/zh/docs/pix-processamento/endpoints/infractions/post_infractions_defense&#x22; &#x22;POST 答辩&#x22;
  click H &#x22;/zh/docs/pix-processamento/med&#x22; &#x22;MED&#x22;
  click I &#x22;/zh/docs/pix-processamento/med&#x22; &#x22;MED&#x22;

  style A fill:#f59e0b,stroke:#d97706,color:#ffffff
  style H fill:#ef4444,stroke:#dc2626,color:#ffffff
  style I fill:#14ce71,stroke:#0eb464,color:#ffffff
`"
/>

当收到的收款变成 MED 争议时，PayZu 会创建&#x2A;*违规记录（infraction）**，您可以通过 API 提交答辩。MED 是什么、期限和完整生命周期见 [MED 完整概览](/docs/pix-processamento/med)。

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

## 列出违规记录 [#列出违规记录]

```bash
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`](/docs/pix-processamento/endpoints/infractions/get_infractions)。

## 违规详情 [#违规详情]

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

```bash
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}`](/docs/pix-processamento/endpoints/infractions/get_infractions_by_id)。

## 提交答辩 [#提交答辩]

```bash
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`](/docs/pix-processamento/endpoints/infractions/post_infractions_defense)。

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

## 跟踪答辩 [#跟踪答辩]

列出所有已提交的答辩：

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

Schema 见 [`GET .../defenses`](/docs/pix-processamento/endpoints/infractions/get_infractions_defenses) 和 [`GET .../defenses/{defenseId}`](/docs/pix-processamento/endpoints/infractions/get_infractions_defense_by_id)。

## 最佳实践 [#最佳实践]

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

`status`、`type`、`reportedBy` 和分析结果的取值见 [术语表](/docs/pix-processamento/glossary)。

## 下一步 [#下一步]

<QuickLinks>
  <QuickLink href="/docs/pix-processamento/tutoriais/receive-pix" title="接收 Pix" />

  <QuickLink href="/docs/pix-processamento/webhooks" title="Webhooks" />
</QuickLinks>

## 需要帮助？ [#需要帮助]

<QuickLinks>
  <QuickLink href="https://suporte.payzu.com.br/portal/pt-br/newticket?departmentId=1103699000000006907&layoutId=1103699000000074011" title="提交工单" />
</QuickLinks>