A API Key é uma chave secreta que permite que a plataforma se comunique com sua conta Asaas de forma segura. Você precisa configurá-la para que a integração funcione corretamente.
O que é uma API Key?#
A API Key é uma chave secreta única que identifica sua conta Asaas e permite comunicação segura entre a plataforma e o Asaas. Ela funciona como uma senha especial que dá permissão para a plataforma acessar sua conta Asaas e processar pagamentos. É muito importante manter sua API Key segura e nunca compartilhá-la com terceiros. Se você suspeitar que sua API Key foi comprometida, regenere-a imediatamente no painel do Asaas e atualize na plataforma.
Como Obter sua API Key#
Para obter sua API Key: 1. Acesse o painel do Asaas (use o link no email de ativação ou vá para asaas.com e faça login) 2. No painel, navegue até **Integrações > API** 3. Você verá sua API Key exibida na tela 4. Clique no ícone de copiar ou selecione o texto completo 5. Copie a chave completa A API Key geralmente tem um formato longo de caracteres alfanuméricos. Certifique-se de copiar a chave completa, incluindo todos os caracteres.
Configurando na Plataforma#
Após copiar sua API Key do painel do Asaas: 1. Volte para a plataforma 2. Acesse Configurações > Integração 3. Localize a seção "Asaas" 4. Vá até a aba "Chave API" 5. Cole a API Key no campo apropriado 6. Clique em "Salvar API Key" 7. Aguarde a validação da chave O sistema validará a chave automaticamente. Se estiver correta, a integração estará ativa e você poderá receber pagamentos. Se houver algum erro, verifique que você copiou a chave corretamente.
Reconexão de Conta Existente#
Se você já possui uma conta Asaas, você pode reconectá-la usando sua API Key ao invés de criar uma nova conta através da plataforma. A aba "Chave API" está sempre visível, mesmo se você ainda não tem uma conta Asaas criada através da plataforma. Isso permite que você reconecte contas existentes a qualquer momento. Quando você tenta criar uma conta e recebe a mensagem de que o email já está em uso, um modal aparecerá explicando que você pode reconectar usando sua API Key. Você será direcionado automaticamente para a aba "Chave API".
Atualizando a API Key#
Se você regenerou sua API Key no painel do Asaas (por exemplo, por questões de segurança), você precisará atualizar a chave na plataforma. A chave antiga deixará de funcionar assim que você gerar uma nova, então é importante atualizar imediatamente na plataforma: 1. Acesse a aba "Chave API" na seção de integração Asaas 2. Cole a nova API Key 3. Clique em "Salvar API Key" 4. Aguarde a validação Se você não atualizar, os pagamentos podem parar de funcionar até que você configure a nova chave.
Troubleshooting#
Se a validação da API Key falhar, verifique: **Cópia Completa:** Certifique-se de copiar a chave completa, incluindo todos os caracteres do início ao fim **Sem Espaços:** Não adicione espaços extras no início ou fim da chave ao colar **Maiúsculas/Minúsculas:** A API Key é sensível a maiúsculas e minúsculas, então copie exatamente como aparece no painel do Asaas **Conta Ativa:** Certifique-se de que sua conta Asaas está ativa e não há problemas com a conta Se o problema persistir após verificar esses pontos, entre em contato com o suporte.
Passo a Passo
Acesse o painel do Asaas e faça login
Navegue até Integrações > API
Localize sua API Key na tela
Copie a API Key completa (todos os caracteres)
Volte para a plataforma
Acesse Configurações > Integração > Asaas
Vá até a aba "Chave API"
Cole a API Key no campo apropriado
Clique em "Salvar API Key"
Aguarde a validação da chave
Confirme que a integração está ativa
Dicas Pro
- Trate sua API Key como uma senha - mantenha-a segura e não compartilhe com ninguém.
- A API Key é sensível a maiúsculas e minúsculas, então copie exatamente como aparece no painel do Asaas.
- Certifique-se de copiar a chave completa, sem espaços extras no início ou fim.
- Se você regenerar sua API Key no Asaas, atualize imediatamente na plataforma para evitar interrupção nos pagamentos.
- A aba "Chave API" está sempre disponível, permitindo reconectar contas existentes ou atualizar chaves.