Ir para o conteúdo
P Prontopag API PixPáginas

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.