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

Interface da plataforma AbacatePay mostrando o botão de criação de chave

Clique no botão 'Criar Chave'

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

Adicione uma Descrição

Formulário de criação de chave com campo de descrição

Identifique sua chave

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

Copie sua Chave

Lista de chaves com opção para copiar

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.