FAQ - WooCommerce

Esta página reúne as dúvidas mais frequentes sobre o Plugin Asaas para WooCommerce.

Caso sua dúvida não esteja respondida aqui, consulte as páginas relacionadas ao final deste guia.

---

Quais plugins são necessários para utilizar o Plugin Asaas?

Para utilizar o Plugin Asaas é necessário instalar:

• WooCommerce;
• Brazilian Market on WooCommerce.

Caso sua loja trabalhe com cobranças recorrentes, também será necessário instalar o WooCommerce Subscriptions.

---

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 nas configurações do plugin.

---

Posso utilizar o Sandbox antes de publicar minha loja?

Sim.

Recomendamos realizar toda a configuração e os testes iniciais utilizando o ambiente Sandbox antes de conectar a loja ao ambiente de Produção.

---

Posso utilizar a mesma API Key no Sandbox e na Produção?

Não.

Cada ambiente possui sua própria API Key.

Uma chave gerada no Sandbox funciona apenas no Sandbox, enquanto uma chave gerada em Produção funciona apenas no ambiente de Produção.

---

Recebi erro 401. O que significa?

Esse erro normalmente indica que:

• a API Key é inválida;
• a API Key pertence a outro ambiente;
• a chave foi revogada.

Nesses casos, gere uma nova API Key e confirme se o ambiente configurado está correto.

---

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 possui configurações próprias e pode ser habilitada ou desabilitada individualmente.

---

Posso oferecer parcelamento?

Sim.

Os limites suportados são:

• Cartão de Crédito: até 12 parcelas;
• Boleto Bancário: até 60 parcelas.

---

É possível utilizar Split de Pagamento?

Sim.

O Plugin permite configurar uma regra global de Split para dividir automaticamente os valores recebidos entre diferentes carteiras Asaas.

---

Como criar assinaturas pelo WooCommerce?

As assinaturas são criadas utilizando o WooCommerce Subscriptions integrado ao Plugin Asaas.

Sem essa extensão instalada, não é possível gerar cobranças recorrentes pelo plugin.

Posso receber assinaturas por Pix?

Não diretamente.

As assinaturas suportam boleto e cartão de crédito.

Quando o cliente utiliza boleto, ele pode efetuar o pagamento utilizando o 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.

---

Como verificar se meus Webhooks estão funcionando?

Você pode acompanhar o status da sincronização em:

WooCommerce > Status > Meio de Pagamentos Asaas

As mesmas informações também estão disponíveis nas configurações das formas de pagamento do Plugin Asaas.

O que fazer quando a fila de Webhooks estiver interrompida?

Clique em Reabilitar fila de webhooks.

Caso a fila permaneça interrompida, consulte os Logs de Webhooks da sua conta Asaas para identificar a causa da interrupção antes de entrar em contato com o suporte.

---

O cliente é redirecionado para outra página para realizar o pagamento?

Não.

O Plugin Asaas utiliza checkout transparente, permitindo que o pagamento seja realizado diretamente na sua loja.

Por que o pedido não foi atualizado após o pagamento?

Na maioria dos casos, isso indica que a fila de Webhooks está interrompida ou que ocorreu alguma falha de comunicação entre o WooCommerce e o Asaas.

Verifique o status da fila na página Webhooks.

---

Como habilitar o Log de depuração?

Acesse:

WooCommerce > Configurações > Pagamentos

Selecione qualquer forma de pagamento do Asaas e habilite a opção Log de depuração.

Essa configuração facilita a identificação de problemas durante a integração.

---

---