Chave de API: Sua credencial de acesso à API da AbacatePay. Esta chave identifica sua conta e autoriza suas requisições. IMPORTANTE: Sem a chave de API, as requisições serão recusadas.

​
Gerenciando chaves de API

Gerencie suas chaves de API diretamente em nossa plataforma. Você pode:

  • Listar todas as chaves ativas
  • Criar novas chaves
  • Revogar chaves existentes

Ambientes e Chaves de API

Todas as requisições são enviadas para o mesmo endpoint (https://api.abacatepay.com), mas o ambiente é determinado pela chave de API utilizada:

  • Chaves criadas em dev mode processam transações no ambiente de testes
  • Chaves criadas em produção processam transações reais

Saiba mais sobre o ambiente de desenvolvimento aqui.

Erro de Autenticação

A API retornará o código HTTP 401 quando:

  • A chave de API não for fornecida no header
  • A chave for inválida
  • A chave tiver sido revogada

​
Criando chaves de API

Boas Práticas de Segurança

  • Armazene suas chaves em variáveis de ambiente ou gerenciadores de segredos
  • Nunca compartilhe suas chaves de API
  • A AbacatePay nunca solicitará suas chaves
  • Revogue imediatamente qualquer chave comprometida

​
Como criar sua chave de API

Siga estes passos no dashboard da AbacatePay:

1

Acesse a Seção de Integração

Clique no botão 'Criar Chave'

Inicie o processo de criação de uma nova chave de API

2

Adicione uma Descrição

Identifique sua chave

Adicione uma descrição clara para identificar o propósito desta chave

3

Copie sua Chave

Armazene sua chave com segurança

Copie a chave gerada e armazene-a em um local seguro

Após criar sua chave, você pode começar a integrar com nossa API. Lembre-se de incluir a chave em todas as requisições no header Authorization:

curl -X POST https://api.abacatepay.com/v1/payments \
  -H "Authorization: Bearer sua_chave_api" \
  -H "Content-Type: application/json" \
  -d '{"amount": 1000}'

Nota Importante

O mesmo endpoint (https://api.abacatepay.com) é usado tanto para o ambiente de desenvolvimento quanto para produção. O ambiente é determinado automaticamente pela chave de API utilizada na requisição.