Habilitando os Logs

Para analisar detalhadamente qualquer problema encontrado durante a utilização do Plugin Asaas, é imprescindível que os Logs estejam habilitados.

Para isso, acesse WooCommerce > Configurações > Pagamentos, selecione qualquer uma das formas de pagamento disponibilizadas pelo Plugin Asaas e localize a opção Habilitar Log na seção Log de Depuração.

Após habilitar a opção, salve as alterações.

Problemas com o WooCommerce

Depois que atualizei o plugin ele parou de funcionar. Posso baixar uma versão antiga?

Caso seja realmente necessário, na página do plugin no WordPress, clique em Panorama avançado e role até o final da página para localizar a seção de download de versões anteriores.

Ocorreu um erro ao processar seu pedido. Contate-nos.

Esse é o erro mais comum e normalmente indica alguma falha na comunicação entre sua loja e o Asaas durante a criação da cobrança.

Antes de iniciar a análise, certifique-se de que o Log de Depuração está habilitado.

Depois de reproduzir o erro, acesse WooCommerce > Status > Logs.

Nessa tela serão exibidos todos os Logs registrados pela loja.

Os registros do Plugin Asaas possuem o prefixo asaas, seguido da forma de pagamento utilizada:

• credit-card para Cartão de Crédito;
• ticket para Boleto Bancário;
• pix para Pix.

Abra o Log mais recente correspondente à forma de pagamento que apresentou o erro.

Caso realmente tenha ocorrido uma falha, ao final do arquivo será exibida uma entrada contendo EMERGENCY seguida do código retornado pela API do Asaas.

Esse código ajudará a identificar a causa do problema utilizando as orientações apresentadas nas próximas seções.

Erro "Não há métodos de pagamento disponíveis" no checkout

Desde a versão 8.3 do WooCommerce, foi introduzido um novo sistema de blocos para o checkout.

Alguns plugins ainda não possuem compatibilidade com essa estrutura, incluindo determinadas versões do Plugin Asaas.

Como alternativa, utilize o shortcode abaixo na página de checkout utilizando o editor Gutenberg:

[woocommerce_checkout]

Isso fará com que o WooCommerce utilize o modelo clássico de checkout.

Erro 401

Esse erro indica que a API Key informada é inválida.

Verifique se:

• a API Key foi gerada corretamente;
• o ambiente selecionado corresponde à chave utilizada (Sandbox ou Produção).

Caso necessário, gere uma nova API Key e atualize sua configuração.

Após atualizar a chave, realize um novo teste criando um pedido.

Erro 403

Esse erro normalmente indica alguma restrição de acesso à API.

No WooCommerce, o motivo mais comum está relacionado ao país de origem do servidor.

Alguns países possuem restrições devido às políticas de segurança do Asaas.

Caso necessário, altere o país de origem das requisições para um país permitido ou entre em contato com nossa equipe de Sucesso de Integrações.

Erro 404

Esse erro costuma ocorrer quando a mesma loja é utilizada em mais de uma conta Asaas ou quando houve migração entre Sandbox e Produção.

Como o WooCommerce armazena internamente o identificador do cliente criado no Asaas, será necessário remover esses metadados.

Execute a consulta abaixo no banco de dados:

DELETE FROM wp_usermeta
WHERE meta_value LIKE '%cus_000%';

A assinatura cria apenas o pedido

Caso utilize o WooCommerce Subscriptions e perceba que apenas o pedido é criado, será necessário utilizar o armazenamento legado do WooCommerce.

Acesse:

WooCommerce > Configurações > Avançado > Recursos

Em seguida:

• habilite Armazenamento de postagens do WordPress (legado); ou
• clique em Ativar modo de compatibilidade, sincronize as assinaturas e tente novamente.

O pedido não é marcado como concluído

Pedidos físicos dependem de conclusão manual no WooCommerce.

Caso deseje conclusão automática, marque o produto como:

• Virtual
• Baixável

Problemas com Webhooks

Pedido pago não atualizou o status

Se os pedidos não estiverem sendo atualizados automaticamente, verifique primeiro o status da fila de Webhooks.

Acesse WooCommerce > Status e localize a seção Meio de Pagamentos Asaas.

Caso a fila esteja interrompida, clique em Reabilitar fila de webhooks.

Após a reativação, o status será atualizado e o botão ficará indisponível.

Se a fila continuar interrompida, consulte os Logs de Webhooks da sua conta Asaas.

Veja também:

Como visualizar Logs de Webhooks

Erro 403 nos Webhooks

Verifique se o firewall do servidor não está bloqueando os IPs ou cabeçalhos enviados pelo Asaas.

Erro 500 nos Webhooks

Esse erro indica que o servidor respondeu com erro interno.

Verifique:

• se está utilizando a versão mais recente do Plugin Asaas;
• se o servidor está funcionando corretamente;
• se não existem múltiplos Webhooks configurados para a mesma loja.

Erro 408 nos Webhooks

O servidor demorou mais de 10 segundos para responder ao Asaas.

Verifique a disponibilidade do servidor e reabilite a fila de Webhooks.

Incompatibilidade com plugins

Caso o Plugin Asaas apresente comportamentos inesperados, como:

• QR Code não exibido;
• clientes criados sem geração de cobranças;
• falhas inesperadas nos Webhooks;

verifique se outro plugin está sobrescrevendo funcionalidades do checkout.

Os conflitos mais comuns ocorrem com plugins de personalização de checkout.

Outros problemas

Caso continue enfrentando dificuldades, entre em contato com nossa equipe de suporte.