争议

付款人的银行可以对收到的 Pix 提出争议。争议进行期间，争议金额会从您的余额中冻结。余额不足时，冻结先部分进行，并随后续入账逐步增加，直到达到争议金额。如果该 Pix 没有计入余额（因为它已在退还付款人的途中），则不冻结任何金额。如果同一笔 Pix 的另一项争议已经冻结了其金额，则不再额外冻结。这些情况下，semBloqueio 都会说明原因。争议开启时您会收到 med.infracao.criada，发生变化时会收到 med.infracao.atualizada。

列出 #

GET /v2/ex/infracoes

权限范围：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"
    }
  ]
}

同一笔 Pix 有多个争议时，被驳回且未冻结任何金额的那一个是重复通知：它不出现在列表和汇总中，但仍可通过 idInfracao 查询。

GET /v2/ex/infracoes/{id} 返回单个争议。

申辩方式取决于账户。请读取 GET /v2/ex/config 中的 capacidades.med：为 false 时，由机构向账户的服务提供方提出申辩，您在这里跟进；为 true 时，请参阅内部参考文档。

汇总 #

GET /v2/ex/infracoes/resumo

权限范围：ex.med.read。与列表一样接受 de、ate、origem 和 busca。

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"
}

每组的 valor 对每笔 Pix 只计算一次，最多为该 Pix 的金额。quantidade 统计争议的数量。

争议对余额的影响 #

可用余额只在冻结时扣减一次。结果只决定冻结的金额去向。为避免重复扣减，请按以下方式跟踪冻结总额：

争议的 devolucao.concluida 带有 id（冻结的 id，与 saldo.bloqueado 中的相同）、tipo、valor、desfecho、被争议 Pix 的 endToEndId 以及 idInfracao。它不带 natureza：请通过 tipo MED、冻结的 id 或 idInfracao 识别争议。

请按总额跟踪冻结金额，而不是逐笔冻结跟踪：同一笔 Pix 有多个争议时，冻结金额会在争议之间转移，不影响您的可用余额。对账单把每次冻结显示为 BLOQUEIO，把每次回到可用余额显示为 DESBLOQUEIO，GET /v2/ex/bloqueios 显示每笔冻结目前的金额。

如果付款人收回的金额多于冻结金额，差额会计入余额中的 aRecuperar，不会自行从可用余额中扣除。

对您的一笔提现发起争议 #

如果您的一笔提现因诈骗、账户被盗、胁迫或欺诈性访问而转给了诈骗者，请为其申请争议。由机构在 Pix 转出的机构发起。该申请不会移动资金：退回的款项作为提现的退回到账，通过 payout.devolucao_recebida 通知。

PUT /v2/ex/pedidos-de-med/{id}

权限范围：ex.med.write。id 由您指定，为 26 至 35 位字母或数字。

PUT /v2/ex/pedidos-de-med/MED01J1ZK7M9QW3ERT5TY6UI8O
{
  "idEnvio": "SAQ04J1ZK7M9QW3ERT5TY6UI8O",
  "motivo": "GOLPE",
  "descricao": "Ligaram dizendo ser do banco e pediram a transferência."
}
→ 201
{
  "id": "MED01J1ZK7M9QW3ERT5TY6UI8O",
  "idEnvio": "SAQ04J1ZK7M9QW3ERT5TY6UI8O",
  "endToEndId": "E12345678202609181200000000000004",
  "motivo": "GOLPE",
  "descricao": "Ligaram dizendo ser do banco e pediram a transferência.",
  "situacao": "PEDIDO",
  "valor": "30.00",
  "valorRecuperado": "0.00",
  "prazoEm": "2026-12-07T12:00:00Z",
  "criadoEm": "2026-09-18T12:00:00Z"
}

商业纠纷（例如商品未送达或不满意）以及输错的密钥都不属于争议的情形，机构会拒绝该申请。以相同请求体重复提交返回 200。每笔提现同一时间只能有一个进行中的申请。

GET /v2/ex/pedidos-de-med/{id} 返回一个申请，GET /v2/ex/pedidos-de-med 按页从最新开始列出，可用 idEnvio、situacao、limite 和 cursor。权限范围：ex.med.read。您会收到 payout.med_pedido、payout.med_aberto、payout.med_recusado 和 payout.med_encerrado，包含申请的字段。

错误 #