A chave de API é a senha que o seu sistema usa para falar com o Asaas: criar cobranças, consultar pagamentos e emitir notas. Quem tem a chave consegue movimentar a conta pela integração, por isso ela deve ser tratada como uma senha.
Gerar a chave
Passo 1: Entre como administrador
Acesse o Asaas pelo navegador, com um usuário administrador. O menu Integrações só aparece para administradores.
Passo 2: Abra as chaves de API
Clique no ícone de usuário, no canto superior direito, depois em Integrações, e abra a aba Chaves API.
Passo 3: Crie a chave
Clique em Gerar chave de API. Dê um nome que identifique o uso (por exemplo, Sistema de vendas) e, se quiser, uma data de expiração. Se o Asaas pedir um código de segurança, confirme com o código enviado para o seu celular ou app autenticador.
Passo 4: Copie e envie com segurança
A chave aparece uma única vez. Copie na hora e envie para a equipe que integra o seu sistema por um canal seguro, como um gerenciador de senhas ou mensagem direta. Nunca por e-mail aberto ou grupo. Se perder, é preciso gerar outra.
Não compartilhe a chave em print, e-mail ou grupo de WhatsApp. Se suspeitar que ela vazou, desabilite a chave em Integrações, Chaves de API, e gere uma nova.
Sandbox e produção
O Asaas tem dois ambientes separados. O sandbox serve para testes, com dinheiro fictício. A produção é a conta real. Cada ambiente tem a sua própria chave, e uma não funciona no outro.
Onde gerar cada chave
- Sandbox (testes)
- https://sandbox.asaas.com
- Produção (conta real)
- https://www.asaas.com
Fontes
- Asaas. Chaves de API