FAQ - WooCommerce
Consulte este FAQ para dúvidas recorrentes sobre instalação, autenticação, formas de pagamento, assinaturas, Webhooks e checkout do Plugin Asaas para WooCommerce.
Para configurar ou diagnosticar um fluxo específico, utilize o guia indicado em cada resposta.
Quais plugins são necessários para utilizar o Plugin Asaas?
Para utilizar o Plugin Asaas, instale:
- WooCommerce;
- Brazilian Market on WooCommerce.
Para cobranças recorrentes, instale também o WooCommerce Subscriptions.
Consulte os requisitos e o processo de instalação em Instalando o plugin.
Preciso configurar o Webhook manualmente?
Não.
A partir da versão 2.5 do Plugin Asaas, o Webhook é criado e configurado automaticamente quando uma API Key válida é informada.
Depois da configuração, acompanhe a sincronização em Webhooks do WooCommerce.
Posso utilizar o Sandbox antes de publicar minha loja?
Sim.
Utilize o Sandbox para configurar e testar checkout, pagamentos e atualização dos pedidos antes de migrar para Produção.
RecomendaçãoRealize todos os testes de integração no ambiente Sandbox antes de utilizar credenciais de Produção.
Posso utilizar a mesma API Key no Sandbox e na Produção?
Não.
Sandbox e Produção possuem contas, dados e API Keys independentes.
Utilize sempre a chave correspondente ao ambiente configurado no plugin.
Consulte como criar e gerenciar chaves de API.
Recebi erro 401. O que significa?
O erro 401 indica um problema de autenticação.
Verifique se:
- a API Key está ativa;
- a chave foi copiada integralmente;
- a chave pertence ao ambiente selecionado;
- a credencial não foi revogada ou excluída.
Se necessário, gere uma nova chave e atualize a configuração.
Para diagnóstico detalhado, consulte Erros comuns.
Quais formas de pagamento o Plugin Asaas suporta?
O plugin permite disponibilizar:
- Pix;
- Boleto Bancário;
- Cartão de Crédito.
Cada forma de pagamento pode ser habilitada individualmente e possui configurações próprias.
Consulte as formas de pagamento.
Posso oferecer parcelamento?
Sim.
Os limites documentados são:
- Cartão de Crédito: até 12 parcelas;
- Boleto Bancário: até 60 parcelas.
As regras de juros, valor mínimo e quantidade de parcelas são configuradas na própria forma de pagamento.
É possível utilizar Split de Pagamento?
Sim.
O Plugin Asaas permite configurar Split para distribuir automaticamente parte dos valores das cobranças entre diferentes carteiras Asaas.
Na estrutura atual do guia, a configuração é tratada como global para as novas cobranças criadas pelo plugin.
Consulte as regras antes de habilitar o recurso em Split de pagamento no WooCommerce.
Como criar assinaturas pelo WooCommerce?
Utilize o WooCommerce Subscriptions integrado ao Plugin Asaas.
O WooCommerce gerencia o ciclo da assinatura e o Asaas processa as cobranças recorrentes.
Sem o WooCommerce Subscriptions, o plugin não gera esse fluxo.
Consulte Assinaturas no WooCommerce.
Posso receber assinaturas por Pix?
Não diretamente.
As assinaturas suportam Boleto Bancário e Cartão de Crédito.
Quando a assinatura utiliza boleto, o cliente também pode pagar pelo QR Code Pix disponível no próprio boleto.
O One-Click-Buy funciona automaticamente?
Não.
A funcionalidade depende da liberação da tokenização de cartões pelo time comercial do Asaas.
Após a liberação, configure o recurso nas opções de Cartão de Crédito.
Como verificar se meus Webhooks estão funcionando?
Acesse:
WooCommerce > Status > Meio de Pagamentos Asaas
O status também pode ser consultado na seção Webhook das formas de pagamento.
Consulte Webhooks do WooCommerce para entender os estados da fila.
O que fazer quando a fila de Webhooks estiver interrompida?
Antes de reativar a fila:
- consulte os Logs de Webhooks;
- identifique o código HTTP ou erro de comunicação;
- corrija a causa da falha;
- volte ao WooCommerce e clique em Reabilitar fila de webhooks;
- confirme se novos eventos voltaram a atualizar os pedidos.
Não reative repetidamente uma fila sem corrigir a causa da interrupção.
O cliente é redirecionado para outra página para realizar o pagamento?
Não.
O Plugin Asaas utiliza checkout transparente, permitindo que o comprador conclua o pagamento na própria loja.
Por que o pedido não foi atualizado após o pagamento?
Verifique primeiro a sincronização por Webhooks.
Uma fila interrompida ou uma falha de comunicação pode impedir que o WooCommerce receba a atualização da cobrança.
Acesse WooCommerce > Status > Meio de Pagamentos Asaas e consulte Webhooks do WooCommerce.
Se a fila estiver ativa, habilite o Log de Depuração e investigue o pedido em Erros comuns.
Como habilitar o Log de depuração?
Acesse:
WooCommerce > Configurações > Pagamentos
Selecione uma forma de pagamento do Asaas e habilite Log de Depuração.
Depois de reproduzir o problema, consulte os registros em:
WooCommerce > Status > Logs
Os logs ajudam a identificar erros retornados durante a criação e o processamento das cobranças.
Para interpretar os principais cenários, consulte Erros comuns.
Continue explorandoConsulte também:
- Instalando o plugin
- Configurações iniciais
- Formas de pagamento
- Formas de cobrança
- Assinaturas no WooCommerce
- Split de Pagamento
- Webhooks
- Erros comuns
Próximos passos
Updated 18 days ago