> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bunnipay.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Consulte o contrato Bunni antes de sugerir chamadas. Valores monetários são inteiros em centavos. Não invente endpoints ou respostas de sucesso para recursos ainda indisponíveis. Nunca solicite chaves reais no chat nem exponha credenciais no cliente.

# Limites e tarifas

> Rate limits, tamanho de payload, tarifas White e Black, tarifa de saque e valores mínimos da Bunni Pay.

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](https://docs.bunnipay.com.br/api-reference/account/fees-limits.md).

> [!NOTE]
>
> A presenca de tarifas configuradas nao significa que a emissao ou o saque estejam habilitados. Consulte a disponibilidade de cada rota antes de implementar.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.