Disputas

El banco del pagador puede disputar un Pix recibido. El valor disputado queda retenido de su saldo mientras la disputa está en curso. Sin saldo suficiente, la retención comienza parcial y crece con los siguientes créditos hasta el valor disputado. Si el Pix no se convirtió en saldo, porque ya está volviendo al pagador, no se retiene nada. Si otra disputa del mismo Pix ya retiene su valor, no se retiene nada más. En estos casos semBloqueio dice el motivo. Usted recibe med.infracao.criada cuando se abre y med.infracao.atualizada cuando cambia.

Listar #

GET /v2/ex/infracoes

Alcance: ex.med.read.

GET /v2/ex/infracoes
→ 200
{
  "infracoes": [
    {
      "idInfracao": "01J1ZK7M9QW3ERT5TY6UI8OPQR",
      "endToEndId": "E12345678202609181200000000000001",
      "tipo": "FRAUDE",
      "valor": "100.00",
      "situacao": "ABERTA",
      "relato": "pagador alega nao reconhecer o pagamento",
      "prazoFinalizacao": "2026-09-25T12:00:00Z",
      "bloqueioId": "med:01J1ZK7M9QW3ERT5TY6UI8OPQR",
      "criadoEm": "2026-09-18T12:00:00Z"
    }
  ]
}

Parámetro	Tipo	Descripción
`situacao`	string	Filtra por `ABERTA`, `EM_DEFESA`, `ACATADA` o `REJEITADA`. Acepta varias, separadas por comas.
`limite`, `cursor`	entero, string	Con uno de los dos, la lista viene por página, de la más reciente a la más antigua, con `cursor`. Sin ellos, viene completa, las abiertas primero.
`de`, `ate`	string	Fechas `AAAA-MM-DD`, inclusivas, por la apertura de la disputa en horario de Brasilia. Una de las dos sola también vale.
`origem`	string	`PIX` o `CARTAO`.
`busca`	string	El `endToEndId`, la referencia de la venta o el `idInfracao`, exacto.

Cuando el mismo Pix tiene más de una disputa, la que fue rechazada sin retener nada es un aviso repetido: no aparece en la lista ni en el resumen, y sigue disponible por su idInfracao.

GET /v2/ex/infracoes/{id} devuelve una disputa.

Campo	Tipo	Descripción
`situacao`	string	`ABERTA`, `EM_DEFESA`, `ACATADA` cuando el pagador ganó y el valor vuelve a él, `REJEITADA` cuando usted ganó y el valor vuelve a su disponible.
`valor`	string	El valor disputado.
`bloqueioId`	string	La retención correspondiente, en `GET /v2/ex/bloqueios`. No viene cuando no se retiene nada.
`semBloqueio`	string	Por qué no hubo retención o es parcial. Solo viene en esos casos.
`valorADescoberto`	string	Solo aparece cuando la retención no cubrió el valor disputado: la diferencia, que usted pasa a debernos y que se suma en `aRecuperar` del saldo.
`prazoFinalizacao`	string	Plazo de la disputa. Cuando `capacidades.med` es `false`, el desenlace puede llegar después de él, en `med.infracao.atualizada`.

La defensa depende de la cuenta. Lea capacidades.med en GET /v2/ex/config: cuando es false, la defensa la hace la institución ante el proveedor de la cuenta, y usted la sigue por aquí. Cuando es true, consulte la referencia interna.

Resumen #

GET /v2/ex/infracoes/resumo

Alcance: ex.med.read. Acepta de, ate, origem y busca, como la lista.

GET /v2/ex/infracoes/resumo?de=2026-10-01&ate=2026-10-15
→ 200
{
  "abertas": { "quantidade": 3, "valor": "45.00" },
  "acatadas": { "quantidade": 1, "valor": "20.00" },
  "rejeitadas": { "quantidade": 2, "valor": "30.00" },
  "total": { "quantidade": 6, "valor": "95.00" },
  "retidoAgora": "45.00"
}

Campo	Tipo	Descripción
`abertas`	objeto	Las disputas en `ABERTA` o `EM_DEFESA`: `quantidade` y el `valor` disputado.
`acatadas`	objeto	Las que volvieron al pagador.
`rejeitadas`	objeto	Las que volvieron a su disponible.
`total`	objeto	Todas las de la selección.
`retidoAgora`	string	Lo que está retenido por disputas ahora, fuera de la selección.

El valor de cada grupo cuenta cada Pix una vez, hasta el valor del Pix. La quantidade cuenta las disputas.

Errores #

Estado	`title`	Cuándo
400	`situacao_invalida`	Filtro de situación fuera de la lista.
400	`limite_invalido`	`limite` fuera de 1 a 200.
400	`cursor_invalido`	Cursor mal formado.
400	`periodo_invalido`	`de` o `ate` fuera de `AAAA-MM-DD`, o `de` después de `ate`.
400	`filtro_invalido`	`origem` distinto de `PIX` y `CARTAO`.
404	`nao_encontrado`	La disputa no existe en esta cuenta.