# Consultar contestação MED (/docs/conta-digital/endpoints/infractions/get_infraction)

## GET /transactions/infractions/{protocol}

`GET https://api.hub.payzu.com.br/api/v1/transactions/infractions/{protocol}`

Escopo: `INFRACTION_READ`. Devolve uma contestação MED, com a etapa, o valor bloqueado e o resultado. Use o `protocol` que vem no webhook `INFRACTION_OPENED`.

### Path params

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `protocol` | string | yes | Protocolo da contestação. |

### Responses

**200** Contestação.

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `id` | string | yes | Identificador da contestação na PayZu. |
| `protocol` | string | yes | Protocolo da contestação. É o identificador usado na consulta e nos webhooks. |
| `type` | string | yes | Motivo alegado. — `REFUND_REQUEST`, `FRAUD`, `REFUND_CANCELLED` |
| `status` | string | yes | Etapa da contestação. `OPEN`, `CLOSED` e `CANCELLED` movem dinheiro; as demais são etapas entre os bancos. A cancelada devolve o valor bloqueado inteiro, sem taxa de análise. — `OPEN`, `ACKNOWLEDGED`, `DEFENDED`, `ANSWERED`, `WAITING_PSP`, `WAITING_ADJUSTMENTS`, `CANCELLED`, `CLOSED` |
| `reportedBy` | string | yes | Ponta que abriu a contestação. — `DEBITED_PARTICIPANT`, `CREDITED_PARTICIPANT` |
| `reportDetails` | string | yes | Relato de quem abriu. |
| `analysisResult` | string | null | yes | Resultado, quando `CLOSED`. `AGREED`: procedente, o valor volta ao pagador. `DISAGREED`: improcedente, o valor volta ao saldo disponível, menos a taxa de análise. — `AGREED`, `DISAGREED` |
| `analysisDetails` | string | null | yes | Justificativa do resultado. |
| `endToEndId` | string | yes | End-to-end do Pix contestado. |
| `blockedAmount` | integer | yes | Valor separado do saldo disponível enquanto a análise corre. Em centavos. |
| `feeCharged` | integer | yes | Taxa de análise cobrada. `0` até o encerramento. Em centavos. |
| `settledAmount` | integer | yes | Quanto voltou ao pagador. `0` até o encerramento. Em centavos. |
| `reportedAt` | string | yes | Quando foi aberta. — format: date-time |
| `dueAt` | string | null | yes | Prazo para responder. `null` quando não há. — format: date-time |
| `closedAt` | string | null | yes | Quando foi encerrada. — format: date-time |
| `origin` | object | yes | Operação contestada. |
| `origin.kind` | string | yes | `PAYMENT`: cobrança. `DEPOSIT`: Pix recebido sem cobrança. — `PAYMENT`, `DEPOSIT` |
| `origin.id` | string | yes | Identificador da cobrança ou do depósito como vem nos webhooks. |
| `origin.amount` | integer | yes | Valor recebido. Em centavos. |
| `origin.paidAt` | string | null | yes | Quando foi recebido. — format: date-time |
| `origin.payerName` | string | null | yes | Numa cobrança, o cliente informado; num depósito, o pagador informado pelo banco. |
| `origin.payerDocument` | string | null | yes | CPF mascarado ou CNPJ formatado. |

**401** Credencial ausente, inválida ou expirada.

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `message` | string | yes | Descrição em português, pronta para exibir. Pode mudar a qualquer momento. |
| `code` | string | yes | Código estável do erro. É por ele que o seu sistema decide o que fazer. |
| `details` | object | no | Contexto estruturado do erro, quando existe. |

**403** Sem permissão: escopo, IP ou operação desabilitada.

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `message` | string | yes | Descrição em português, pronta para exibir. Pode mudar a qualquer momento. |
| `code` | string | yes | Código estável do erro. É por ele que o seu sistema decide o que fazer. |
| `details` | object | no | Contexto estruturado do erro, quando existe. |

**404** Não encontrado, ou de outra conta.

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `message` | string | yes | Descrição em português, pronta para exibir. Pode mudar a qualquer momento. |
| `code` | string | yes | Código estável do erro. É por ele que o seu sistema decide o que fazer. |
| `details` | object | no | Contexto estruturado do erro, quando existe. |