WooCommerce

Use o plugin Asaas para WooCommerce para receber pagamentos da sua loja WordPress pelo gateway de pagamentos do Asaas.

O WooCommerce é um plugin de e-commerce de código aberto para WordPress. Ele transforma um site WordPress em uma loja online, com produtos, carrinho, checkout e pedidos.

O plugin Asaas para WooCommerce conecta essa loja ao Asaas, permitindo que o Asaas seja o operador dos pagamentos feitos no checkout. Use esta página como ponto de partida para entender quando usar o plugin, quais fluxos ele atende e para onde seguir na configuração.

Quando usar o plugin

Use o plugin Asaas para WooCommerce quando você precisa:

Oferecer checkout transparente, em que o cliente paga sem sair do seu site.
Receber cobranças à vista no cartão de crédito.
Receber cobranças parceladas no boleto e no cartão de crédito.
Personalizar juros conforme o número de parcelas.
Configurar split de pagamento (divisão automática do valor recebido entre carteiras selecionadas).
Gerar assinaturas pelo WooCommerce Subscriptions no boleto ou no cartão de crédito.
Oferecer One-Click-Buy para que o cliente armazene dados do cartão de crédito para pagamentos futuros, quando a tokenização estiver liberada pelo time comercial.
Habilitar antecipação automática em cobranças de cartão de crédito.

Pré-requisitos

Antes de configurar a integração:

Tenha uma loja WordPress com WooCommerce instalada.
Instale o plugin Asaas para WooCommerce seguindo o guia Instalando o plugin.
Configure as informações iniciais do plugin em Configurações iniciais.
Solicite a liberação de tokenização com o time comercial se você for usar One-Click-Buy.
Ative o WooCommerce Subscriptions se você for gerar assinaturas pelo plugin.

Fluxo de integração

O fluxo principal da integração segue esta ordem:

Instale o plugin. Adicione o plugin Asaas à sua loja WooCommerce para disponibilizar as configurações de pagamento.
Configure a conta Asaas. Informe as credenciais e preferências necessárias para conectar a loja ao Asaas.
Escolha as formas de cobrança. Defina quais meios de pagamento serão oferecidos no checkout, como cartão de crédito e boleto.
Configure regras de parcelamento. Defina quando oferecer parcelas e quais juros aplicar por número de parcelas.
Opcional: configure split de pagamento. Aplique uma regra global para enviar um percentual das vendas às carteiras selecionadas.
Opcional: configure assinaturas. Use o WooCommerce Subscriptions para gerar cobranças recorrentes no boleto ou no cartão de crédito.
Teste o checkout. Valide se o cliente consegue concluir a compra sem sair do site e se o pedido segue o comportamento esperado no WooCommerce.

Principais configurações

Configuração	Quando usar	Impacto operacional
Formas de cobrança	Quando você quer escolher quais meios de pagamento aparecem no checkout.	Define as opções que o cliente vê ao finalizar a compra.
Parcelamento e juros	Quando você vende no boleto ou cartão de crédito parcelado.	Altera o valor final conforme o número de parcelas configurado.
Split de pagamento	Quando parte do valor da venda deve ser enviada automaticamente a parceiros ou outras carteiras.	Divide os valores das vendas conforme a regra global configurada.
WooCommerce Subscriptions	Quando você vende assinaturas recorrentes.	Permite gerar assinaturas no boleto ou no cartão de crédito pelo plugin.
One-Click-Buy	Quando você quer facilitar compras futuras com cartão de crédito salvo.	Requer liberação prévia da tokenização com o time comercial.
Antecipação automática	Quando você quer antecipar cobranças de cartão de crédito.	Aplica a antecipação automática nas cobranças de cartão de crédito configuradas.

Comportamentos importantes

Checkout transparente: o cliente conclui o pagamento no seu site, sem redirecionamento para uma página externa.
Validação de CPF/CNPJ: o plugin valida se o documento informado pelo cliente é válido antes de seguir com o pagamento.
Split de pagamento: a configuração é global; toda venda feita no e-commerce envia um percentual para as carteiras selecionadas.
Tokenização: o armazenamento de dados de cartão para One-Click-Buy depende de liberação prévia com o time comercial.
Assinaturas: a geração de assinaturas pelo plugin depende do WooCommerce Subscriptions.

Solução de problemas

Se a integração não funcionar como esperado:

Revise as configurações iniciais do plugin em Configurações iniciais.
Verifique os problemas conhecidos em Erros comuns.
Consulte Forma de pagamento e Formas de cobrança para revisar a configuração dos meios de pagamento.
Se o problema envolver eventos ou atualizações assíncronas, consulte a documentação de Webhooks.