Limites
Os tetos por transação e por CPF que valem na sua conta. "0.00" significa sem limite. Consulte antes de prometer um valor alto ao seu cliente.
GET /v2/ex/limites
Escopo: 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 | Descrição |
|---|---|---|
maxDeposito |
string | Teto por cobrança. |
maxSaque |
string | Teto por saque. |
diarioDepositoCpf, diarioSaqueCpf |
string | Teto por CPF por dia contábil. |
mensalDepositoCpf, mensalSaqueCpf |
string | Teto por CPF por mês civil. |
impostoPelaIP |
lista | Os campos cujo teto é o da instituição. Você não sobe esses pela API. |
pedidoPendente |
objeto | Só aparece quando há um aumento aguardando as 24 horas. Traz campos, valores e efetivaEm. |
Alterar #
PUT /v2/ex/limites
Escopo: ex.limites.write.
O corpo é parcial: campo omitido fica como está. Reduzir vale na hora. Aumentar vira pedido que efetiva em 24 horas e aparece em pedidoPendente. Passar para "0.00" é aumento.
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"]
}
Uma operação acima de um teto responde 422 limite_excedido, com o teto e o valor em violacoes.
Erros #
| Status | title |
Quando |
|---|---|---|
| 400 | valor_invalido |
Valor fora do formato "0.00". |
| 400 | campo_desconhecido |
O corpo trouxe um campo que não é um dos seis tetos. |