WooCommerce
Entenda quando usar o plugin Asaas para WooCommerce, quais fluxos ele atende e quais páginas consultar para instalar, configurar e solucionar problemas.
Use o Plugin Asaas para WooCommerce para receber pagamentos por Pix, boleto e cartão de crédito diretamente no checkout da sua loja WordPress.
A integração também permite configurar parcelamento, assinaturas, Split de pagamento, One-Click-Buy e antecipação automática, conforme o fluxo utilizado.
Escolha o que configurar
| Necessidade | Consulte |
|---|---|
| Instalar o Plugin Asaas no WordPress | Instalando o plugin |
| Conectar a loja à conta Asaas e configurar Sandbox ou Produção | Configurações iniciais |
| Configurar Pix, boleto ou cartão de crédito | Formas de pagamentos |
| Escolher entre cobrança avulsa, parcelamento ou recorrência | Formas de cobrança |
| Criar cobranças recorrentes com WooCommerce Subscriptions | Assinaturas no WooCommerce |
| Dividir os valores das vendas entre carteiras Asaas | Split de pagamento no WooCommerce |
| Entender a sincronização dos pedidos | Webhooks do WooCommerce |
| Investigar falhas do plugin | Erros comuns |
| Consultar dúvidas frequentes | FAQ - WooCommerce |
Recursos disponíveis
| Recurso | Como utilizar |
|---|---|
| Checkout transparente | O comprador conclui o pagamento no próprio site. |
| Pix, boleto e cartão de crédito | Habilite somente as formas de pagamento necessárias para sua operação. |
| Parcelamento e juros | Configure quantidade de parcelas, valor mínimo e juros conforme a forma de pagamento. |
| Split de pagamento | Distribua automaticamente parte do valor das cobranças entre outras carteiras Asaas. |
| Assinaturas | Utilize o WooCommerce Subscriptions para cobranças recorrentes por boleto ou cartão de crédito. |
| One-Click-Buy | Permita compras futuras com cartão armazenado após a liberação da tokenização pelo time comercial do Asaas. |
| Antecipação automática | Solicite automaticamente a antecipação das cobranças de cartão de crédito, conforme as regras da conta Asaas. |
Antes de começar
Para utilizar o plugin, sua loja precisa ter:
- WordPress;
- WooCommerce;
- Brazilian Market on WooCommerce;
- uma conta Asaas;
- acesso administrativo ao WordPress.
Para cobranças recorrentes, instale também o WooCommerce Subscriptions.
Se sua operação utilizar One-Click-Buy, solicite previamente a liberação da tokenização de cartões com o time comercial do Asaas.
Os requisitos técnicos de versão e o processo de instalação estão detalhados em Instalando o plugin.
Fluxo de configuração
%%{init: {"flowchart": {"nodeSpacing": 18,"rankSpacing": 24,"diagramPadding": 4,"padding": 7}}}%%
flowchart TD
A["Instalar o plugin"] --> B["Conectar a conta Asaas"]
B --> C["Escolher as formas de pagamento"]
C --> D["Configurar as regras da operação"]
D --> E["Realizar uma compra no Sandbox"]
E --> F["Validar a criação da cobrança"]
F --> G["Receber a atualização via Webhook"]
G --> H["Publicar em Produção"]
classDef inicio fill:#DBEAFE,stroke:#2563EB,color:#1E3A8A,stroke-width:3px
classDef validacao fill:#E0F2FE,stroke:#0284C7,color:#0C4A6E,stroke-width:2px
classDef sucesso fill:#DCFCE7,stroke:#16A34A,color:#14532D,stroke-width:3px
class A inicio
class B,C,D,E,F,G validacao
class H sucesso
linkStyle default stroke:#94A3B8,stroke-width:2px
Configure inicialmente a loja no Sandbox. Após validar o checkout, as cobranças e a atualização dos pedidos, altere a integração para Produção.
Webhooks
O Plugin Asaas utiliza Webhooks para sincronizar os pedidos do WooCommerce com as alterações das cobranças no Asaas.
A partir da versão 2.5 do plugin, o Webhook é criado automaticamente quando uma API Key válida é configurada. Não implemente polling para acompanhar o status dos pedidos.
Se um pedido pago não for atualizado, consulte o status da fila e os procedimentos de recuperação em Webhooks do WooCommerce.
Próximos passos
Updated 20 days ago