> ## 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.

# Erros

> Entenda o envelope JSON success/data/error/requestId e os códigos HTTP da API Bunni Pay.

Toda resposta da API Bunni Pay segue um envelope padrao com `success`, `data` ou `error`, e `requestId`. Use o `requestId` para diagnosticar falhas ao pedir ajuda.

## Envelope de sucesso

```json theme={"theme":"github-dark-default"}
{
  "success": true,
  "data": {
    "authenticated": true
  },
  "requestId": "00000000-0000-4000-8000-000000000001"
}
```

## Envelope de erro

```json theme={"theme":"github-dark-default"}
{
  "success": false,
  "error": {
    "code": "SCOPE_REQUIRED",
    "message": "Permissao insuficiente."
  },
  "requestId": "00000000-0000-4000-8000-000000000001"
}
```

## Tabela de status HTTP

| HTTP | Significado |
| - | - |
| 400 | Campos, parametros ou cabeçalhos inválidos. |
| 401 | Chave ausente, inválida ou revogada. |
| 403 | Permissao insuficiente ou operacao nao habilitada para a conta. |
| 404 | Recurso nao encontrado na conta. |
| 409 | Conflito de idempotência ou nome duplicado. |
| 422 | Valor, período ou outra regra da operacao inválida. |
| 428 | Precondicao nao atendida, como versao desatualizada de link. |
| 429 | Limite de requisicoes excedido. Aguarde o intervalo indicado em `Retry-After`. |
| 502 | Provedora indisponível, recusa ou resultado incerto. |
| 503 | Servico temporariamente indisponível ou conexao ainda nao configurada. |

## Códigos de erro citados

| Código | Quando ocorre |
| - | - |
| `SCOPE_REQUIRED` | A chave nao possui o escopo necessário para a rota solicitada. |
| `ACCOUNT_NOT_ENABLED` | Conta sem habilitacao financeira. Retornado em operacoes que exigem conta ativa. |
| `PAYMENTS_NOT_ENABLED` | Emissao de cobranças ainda indisponível no servidor. |
| `LINK_CHANGED` | A versao do link de pagamento mudou desde a ultima consulta. Envie o valor atual em `If-Match`. |

## Cabeçalhos de resposta

As respostas incluem `Cache-Control: no-store` e `X-Content-Type-Options: nosniff`.

> [!NOTE]
>
> Guarde o `requestId` de toda resposta de erro para diagnóstico. Nao registre chaves de API, documentos completos ou códigos de autenticacao em logs.


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