Skip to main content
A API pública da Bunni Pay aceita autenticação por chave de API no cabeçalho X-API-Key. A chave pertence a uma conta e so pode acessar os recursos dessa conta. Nao ha autenticação Bearer para a API publica.

Cabeçalho X-API-Key

Envie a chave em toda requisição a /v1/*:
Nunca envie a chave em URLs, páginas públicas ou código executado no navegador.

Escopos disponíveis

Cada chave pode ter um ou mais escopos. Selecione apenas os que sua aplicação precisa. A rota GET /v1/status exige autenticação, mas nenhum escopo adicional.

Gerenciamento de chaves no painel

As chaves sao gerenciadas na área API Keys do painel da Bunni Pay. No backend, as rotas de gerenciamento exigem sessão do painel e confirmacao adicional recente para criacao e revogacao.
A chave completa so é exibida no momento da criacao. O servidor armazena apenas o hash. Guarde a chave em um cofre seguro imediatamente.

Limite de chaves ativas

Cada conta pode manter ate 20 chaves ativas simultaneamente. Chaves revogadas deixam de autenticar imediatamente. Permissao de criacao nao substitui a habilitacao financeira da conta.

Erros de autenticação

Para mais detalhes sobre o envelope de erro, consulte Erros e envelope.