Asaas

Troubleshooting

Solução de problemas comuns na integração Asaas

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

1

Identifique o problema específico que está enfrentando

2

Consulte a seção relevante nesta página de troubleshooting

3

Siga os passos de verificação sugeridos

4

Se o problema for relacionado à API Key, verifique que copiou corretamente

5

Se o problema for relacionado à conta, verifique status no painel do Asaas

6

Se necessário, tente regenerar a API Key e reconfigurar

7

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.
Última atualização: Hoje