Skip to main content
A API Bunni Pay possui limites de requisicao, tamanho de payload e tarifas configuradas por conta. Consulte /v1/account/fees-limits para obter os valores vigentes da sua conta.

Rate limits

  • 60 requisicoes por minuto por chave de API, em janela de 60 segundos.
  • 120 requisicoes por minuto por IP quando a infraestrutura esta configurada, exceto para /health/live.
  • HTTP 429 inclui o cabeçalho Retry-After: 60.

Tamanho de payload

O corpo JSON geral é limitado a 64 KiB. O envio de KYC pelo painel possui limite próprio de 4,5 MB.

Tarifas de recebimento Pix

As tarifas dependem do perfil da operacao da conta.

Perfil White

  • Tarifa fixa: 40 centavos por recebimento Pix.
  • Representado em paymentFees.fixedCents: 40 e paymentFees.basisPoints: 0.

Perfil Black

  • Tarifa percentual: 3,99% do valor recebido.
  • Tarifa fixa adicional: 70 centavos por recebimento Pix.
  • Representado em paymentFees.fixedCents: 70 e paymentFees.basisPoints: 399.

Tarifa de saque Pix

  • Tarifa fixa: 45 centavos por saque.
  • Representado em payoutFixedFeeCents: 45.

Valor mínimo de saque

O destinatário deve receber pelo menos 1000 centavos (R$ 10,00). Representado em payoutMinimumCents: 1000.

Exemplo de saque

Com deductFee=false:
  • amountCents=1000: debita 1045 centavos do saldo, entrega 1000 centavos ao destinatário.
Com deductFee=true:
  • amountCents=1045: debita 1045 centavos do saldo, entrega 1000 centavos ao destinatário.
  • amountCents=1000 com desconto é inválido porque entregaria apenas 955 centavos, abaixo do mínimo.

Limite por cobrança

O teto por pagamento Pix é retornado em pixPerPaymentCents. O limite efetivo depende da conta e pode ser consultado em GET /v1/account/fees-limits.
A presenca de tarifas configuradas nao significa que a emissao ou o saque estejam habilitados. Consulte a disponibilidade de cada rota antes de implementar.