Límites

Los topes por transacción, por CPF del pagador y por beneficiario del retiro que valen en su cuenta. La consulta muestra siempre el tope vigente hoy. Consulte antes de prometer un valor alto a su cliente.

GET /v2/ex/limites

Alcance: 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"]
}

Campo	Tipo	Descripción
`maxDeposito`	string	Tope por cobro.
`maxSaque`	string	Tope por retiro.
`diarioDepositoCpf`, `diarioSaqueCpf`	string	Tope por día contable: en el depósito, por CPF del pagador; en el retiro, por beneficiario, CPF o CNPJ.
`mensalDepositoCpf`, `mensalSaqueCpf`	string	Tope por mes calendario, con la misma regla del diario.
`impostoPelaIP`	lista	Los campos cuyo tope es el de la institución. Usted no los aumenta por la API.
`pedidoPendente`	objeto	Solo aparece cuando hay un aumento esperando las 24 horas. Trae `campos`, `valores` y `efetivaEm`.

Un tope con el valor 0.00 significa sin tope.

Modificar #

PUT /v2/ex/limites

Alcance: ex.limites.write.

El cuerpo es parcial: el campo omitido queda como está. Reducir vale en el acto. Aumentar se convierte en una solicitud que se hace efectiva en 24 horas y aparece en pedidoPendente. Pasar a "0.00" o "" quita su tope propio. Es un aumento: después de las 24 horas vale el de la institución, y el campo aparece en 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"]
}

En el retiro, por encima de un tope la respuesta es 422 limite_excedido, con tipoLimite, limite y disponivel en violacoes. En el cobro el tope vale cuando llega el Pix: el cobro se crea, y el pago por encima del tope se rechaza con el evento cob.pagamento_rejeitado (motivo LIMITE_EXCEDIDO). En algunas cuentas también vuelve al pagador, con devolucao.criada.

El máximo por Pix de retiro de algunas cuentas no es uno de estos topes: viene de la cuenta, no cambia aquí, y por encima de él el retiro responde 422 valor_acima_do_maximo (vea Crear retiro).

Errores #

Estado	`title`	Cuándo
400	`valor_invalido`	Valor fuera del formato `"0.00"`.
400	`campo_desconhecido`	El cuerpo no es un JSON válido, trajo un campo que no es uno de los seis topes o un valor que no es texto, como `1000` en lugar de `"1000.00"`.