限额

您的账户适用的单笔上限、按付款人 CPF 的上限，以及按提现收款人的上限。查询结果始终是当前生效的上限。在向您的客户承诺大额之前，请先查询。

GET /v2/ex/limites

权限范围：ex.limites.read。

GET /v2/ex/limites
→ 200
{
  "maxDeposito": "15000.00",
  "maxSaque": "15000.00",
  "diarioDepositoCpf": "50000.00",
  "diarioSaqueCpf": "50000.00",
  "mensalDepositoCpf": "500000.00",
  "mensalSaqueCpf": "500000.00",
  "impostoPelaIP": ["maxDeposito", "maxSaque", "diarioDepositoCpf", "diarioSaqueCpf", "mensalDepositoCpf", "mensalSaqueCpf"]
}

上限值为 0.00 表示不设上限。

修改 #

PUT /v2/ex/limites

权限范围：ex.limites.write。

正文是部分更新：省略的字段保持不变。降低立即生效。提高会变成一项请求，24 小时后生效，并显示在 pedidoPendente 中。设为 "0.00" 或 "" 会取消您自定义的上限。这属于提高：24 小时后适用机构的上限，该字段会出现在 impostoPelaIP 中。

PUT /v2/ex/limites
{
  "maxSaque": "1000.00"
}
→ 200
{
  "maxDeposito": "15000.00",
  "maxSaque": "1000.00",
  "diarioDepositoCpf": "50000.00",
  "diarioSaqueCpf": "50000.00",
  "mensalDepositoCpf": "500000.00",
  "mensalSaqueCpf": "500000.00",
  "impostoPelaIP": ["maxDeposito", "diarioDepositoCpf", "diarioSaqueCpf", "mensalDepositoCpf", "mensalSaqueCpf"]
}

提现超过上限时，返回 422 limite_excedido，violacoes 中包含 tipoLimite、limite 和 disponivel。收款的上限在 Pix 到达时生效：收款照常创建，超过上限的付款会被拒绝，并触发事件 cob.pagamento_rejeitado（原因为 LIMITE_EXCEDIDO）。在某些账户中，该款项还会通过 devolucao.criada 退还付款人。

部分账户对每笔提现 Pix 设有的最高金额不属于这些上限：它来自账户本身，无法在此修改，超过该金额的提现返回 422 valor_acima_do_maximo（见创建提现）。

错误 #