# Infrações (MED) (/docs/pix-processamento/endpoints/infractions)



Quando um pagador contesta um Pix via **MED (Mecanismo Especial de Devolução)** do Bacen, uma **infração** é criada na sua conta. Use esses endpoints para listar, investigar e submeter defesa.

<QuickLinks>
  <QuickLink href="/docs/pix-processamento/endpoints/infractions/get_infractions" title="Listar infrações" method="GET" path="/user/infractions" />

  <QuickLink href="/docs/pix-processamento/endpoints/infractions/get_infractions_by_id" title="Detalhe da infração" method="GET" path="/user/infractions/{id}" />

  <QuickLink href="/docs/pix-processamento/endpoints/infractions/post_infractions_defense" title="Submeter defesa" method="POST" path="/user/infractions/{id}/defenses" />

  <QuickLink href="/docs/pix-processamento/endpoints/infractions/get_infractions_defenses" title="Listar defesas" method="GET" path="/user/infractions/{id}/defenses" />

  <QuickLink href="/docs/pix-processamento/endpoints/infractions/get_infractions_defense_by_id" title="Detalhe da defesa" method="GET" path="/user/infractions/{id}/defenses/{defenseId}" />
</QuickLinks>

## Quando usar cada um [#quando-usar-cada-um]

| Pergunta                                      | Endpoint                                                                                                         |
| --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| Quais infrações abertas estão na minha conta? | [`GET /user/infractions`](/docs/pix-processamento/endpoints/infractions/get_infractions)                         |
| Detalhe de uma infração específica            | [`GET /user/infractions/{id}`](/docs/pix-processamento/endpoints/infractions/get_infractions_by_id)              |
| Quero contestar a disputa                     | [`POST /user/infractions/{id}/defenses`](/docs/pix-processamento/endpoints/infractions/post_infractions_defense) |
| Quais defesas já submeti para essa infração?  | [`GET /user/infractions/{id}/defenses`](/docs/pix-processamento/endpoints/infractions/get_infractions_defenses)  |
| Detalhe de uma defesa específica              | [`GET .../defenses/{defenseId}`](/docs/pix-processamento/endpoints/infractions/get_infractions_defense_by_id)    |

<Callout type="warn">
  O prazo para responder a uma infração é definido pelo Bacen, geralmente **72h**. Sem defesa dentro do prazo, o valor pode ser devolvido automaticamente. Configure alerta interno ao receber a infração via callback.
</Callout>

## Exemplos [#exemplos]

<Accordions type="single">
  <Accordion title="GET /user/infractions, listar abertas">
    ```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"
    ```
  </Accordion>

  <Accordion title="POST /user/infractions/{id}/defenses, submeter defesa">
    ```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 '{}'
    ```
  </Accordion>
</Accordions>

## Fluxo da disputa [#fluxo-da-disputa]

<Mermaid
  chart="`
flowchart LR
  A[&#x22;Pagador abre disputa&#x22;] --> B[&#x22;Callback com infraction&#x22;]
  B --> C[&#x22;GET /user/infractions/{id}&#x22;]
  C --> D{&#x22;Decidir&#x22;}
  D -->|&#x22;Defender&#x22;| E[&#x22;POST .../defenses&#x22;]
  D -->|&#x22;Aguardar&#x22;| F[&#x22;Bacen analisa&#x22;]
  E --> F
  F --> G{&#x22;Decisão&#x22;}
  G -->|&#x22;AGREED&#x22;| H[&#x22;Transação REFUNDED&#x22;]
  G -->|&#x22;DISAGREED&#x22;| I[&#x22;Transação mantida&#x22;]

  click B &#x22;/docs/pix-processamento/webhooks&#x22; &#x22;Callback com objeto infraction&#x22;
  click C &#x22;/docs/pix-processamento/endpoints/infractions/get_infractions_by_id&#x22; &#x22;GET detalhe&#x22;
  click E &#x22;/docs/pix-processamento/endpoints/infractions/post_infractions_defense&#x22; &#x22;POST defesa&#x22;
  click H &#x22;/docs/pix-processamento/med&#x22; &#x22;MED&#x22;
  click I &#x22;/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
`"
/>

## Tutoriais e boas práticas [#tutoriais-e-boas-práticas]

<QuickLinks>
  <QuickLink href="/docs/pix-processamento/med" title="MED, visão completa" />

  <QuickLink href="/docs/pix-processamento/tutoriais/infractions" title="Tutorial: Infrações" />

  <QuickLink href="/docs/pix-processamento/best-practices/security" title="Anti-fraude (DICT)" />
</QuickLinks>