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



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

  <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 defesa" method="POST" path="/defenses" />

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

<Mermaid
  chart="`
flowchart LR
  A[&#x22;Pagador contesta&#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 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
`"
/>

Quando uma cobrança recebida vira disputa MED, a PayZu cria uma **infração** e você pode submeter defesa via API. O que é o MED, prazos e ciclo de vida completos em [MED, visão completa](/docs/pix-processamento/med).

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

## Listar infrações [#listar-infrações]

```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 em [`GET /user/infractions`](/docs/pix-processamento/endpoints/infractions/get_infractions).

## Detalhe da infração [#detalhe-da-infração]

Retorna motivo, valor contestado, prazo e a transação relacionada.

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

Schema em [`GET /user/infractions/{id}`](/docs/pix-processamento/endpoints/infractions/get_infractions_by_id).

## Submeter defesa [#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 '{}'
```

Schema em [`POST .../defenses`](/docs/pix-processamento/endpoints/infractions/post_infractions_defense).

<Callout type="info">
  O schema do body desta operação não está publicado no spec público. Para enviar defesa com justificativa e anexos, contate o suporte para confirmar os campos.
</Callout>

## Acompanhar defesas [#acompanhar-defesas]

Listar todas as defesas submetidas:

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

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

## Boas práticas [#boas-práticas]

* **Alerta automático ao receber `infraction` no callback**, o prazo é curto.
* **Persista o `expiresAt`** da infração e crie task agendada.
* **Guarde evidências** (logs de DICT antes do pagamento, comprovante, conversa com cliente), facilita defesa.
* **Aceite ou conteste rapidamente**, silêncio costuma ser interpretado como aceitação.

Os valores de `status`, `type`, `reportedBy` e resultado da análise estão no [Glossário](/docs/pix-processamento/glossary).

## Próximos passos [#próximos-passos]

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

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

## Precisa de ajuda? [#precisa-de-ajuda]

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