Esta página lista os problemas mais comuns ao configurar ou usar a integração Asaas, com soluções práticas para cada situação.
Não Consigo Criar a Conta#
Se você está tendo problemas para criar a conta Asaas, verifique: **Plano Pago:** A criação de conta através da plataforma requer um plano pago ativo. Se você está no plano gratuito, precisará fazer upgrade primeiro antes de poder criar a conta. **Email Correto:** Certifique-se de que o email cadastrado na plataforma está correto e acessível, pois o Asaas enviará um email de ativação. **Email Não Recebido:** Se você não recebeu o email de ativação, verifique a pasta de spam e aguarde alguns minutos. O email pode levar alguns minutos para chegar.
Email Já Está em Uso#
Se você recebe uma mensagem informando que o email já está cadastrado no Asaas, isso significa que você já possui uma conta Asaas com aquele email. Nesse caso, você não precisa criar uma nova conta. Em vez disso: 1. Um modal aparecerá explicando que você pode reconectar usando sua API Key 2. Você será direcionado para a aba "Chave API" 3. Acesse o painel do Asaas e obtenha sua API Key 4. Cole a API Key na plataforma 5. A integração estará conectada A aba "Chave API" está sempre visível, permitindo reconectar contas existentes a qualquer momento.
Validação da API Key Falha#
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. Não corte nenhuma parte da chave. **Sem Espaços:** Não adicione espaços extras no início ou fim da chave ao colar. A API Key deve ser colada exatamente como aparece no painel do Asaas. **Maiúsculas e Minúsculas:** A API Key é sensível a maiúsculas e minúsculas. Copie exatamente como aparece, sem alterar nenhum caractere. **Conta Ativa:** Certifique-se de que sua conta Asaas está ativa e não há problemas ou pendências com a conta. Se o problema persistir após verificar esses pontos, tente regenerar a API Key no painel do Asaas e configure a nova chave na plataforma.
Pagamentos Não Estão Funcionando#
Se os pagamentos não estão sendo processados corretamente: **Integração Ativa:** Verifique se a integração está ativa na plataforma. A API Key deve estar configurada e válida. **API Key Válida:** Se você regenerou sua API Key no Asaas, certifique-se de atualizar a chave na plataforma. A chave antiga deixará de funcionar. **Métodos Ativados:** Verifique se você ativou pelo menos um método de pagamento na aba "Métodos aceitos". **Conta Asaas:** Confirme que sua conta Asaas está ativa e não há pendências ou problemas com a conta. **Webhooks:** Os pagamentos são sincronizados através de webhooks. Se um pagamento foi confirmado no Asaas mas não aparece na plataforma, pode haver um problema com os webhooks. Entre em contato com o suporte nesses casos.
Problemas com Split Automático#
O split automático é processado automaticamente pelo Asaas. Se você está tendo problemas: **Confirmação do Pagamento:** O split só é processado após a confirmação do pagamento no Asaas. Aguarde a confirmação antes de verificar o valor recebido. **Valor Recebido:** O valor que você recebe já tem a comissão da plataforma deduzida. Isso é normal - você recebe o valor líquido diretamente na sua conta Asaas. **Verificação:** Verifique o valor no painel do Asaas. O valor recebido deve ser o valor total menos a comissão da plataforma. Se o split não estiver funcionando corretamente, entre em contato com o suporte, pois pode haver questões técnicas que precisam ser investigadas.
Quando Contatar o Suporte#
Entre em contato com o suporte se: - Você verificou todos os pontos de troubleshooting e o problema persiste - Há problemas técnicos que você não consegue resolver - A integração parou de funcionar sem motivo aparente - Há discrepâncias nos valores recebidos que não podem ser explicadas - Você precisa de assistência com configurações avançadas Forneça o máximo de informações possível ao contatar o suporte, incluindo screenshots se relevante, e descreva os passos que você já tentou para resolver o problema.
Passo a Passo
Identifique o problema específico que está enfrentando
Consulte a seção relevante nesta página de troubleshooting
Siga os passos de verificação sugeridos
Se o problema for relacionado à API Key, verifique que copiou corretamente
Se o problema for relacionado à conta, verifique status no painel do Asaas
Se necessário, tente regenerar a API Key e reconfigurar
Se o problema persistir, entre em contato com o suporte
Dicas Pro
- Sempre verifique primeiro os pontos mais comuns: plano pago, API Key correta, métodos ativados.
- A API Key é sensível a maiúsculas e minúsculas - copie exatamente como aparece.
- Se você regenerar sua API Key, atualize imediatamente na plataforma.
- Aguarde alguns minutos para sincronização antes de verificar se problemas foram resolvidos.
- Mantenha suas credenciais do Asaas seguras e atualizadas.