Formas de pagamentos
Configure e valide Boleto Bancário, Pix e Cartão de Crédito no Plugin Asaas para WooCommerce.
Configure as formas de pagamento no WooCommerce
Configure Boleto Bancário, Pix e Cartão de Crédito no Plugin Asaas para WooCommerce.
Antes de continuar, conecte sua loja ao Asaas conforme o guia de Configurações iniciais.
Antes de começarRecomendamos realizar toda a configuração inicialmente no ambiente Sandbox. Após validar o funcionamento do checkout e dos pagamentos, altere a configuração para o ambiente de Produção.
Configurações compartilhadas
Acesse:
WooCommerce > Configurações > Pagamentos
Selecione uma forma de pagamento do Asaas e configure as opções necessárias.
Ver configurações compartilhadas
Habilitar / Desabilitar
Define se a forma de pagamento ficará disponível no checkout da loja.
Título
Nome exibido ao cliente durante o checkout.
Descrição
Texto apresentado abaixo do título da forma de pagamento.
Status do pedido para pagamentos em aberto
Define qual status será atribuído ao pedido quando o pagamento ainda não tiver sido confirmado.
As opções disponíveis são:
- Aguardando: reduz o estoque e envia e-mails ao cliente e ao lojista.
- Pagamento pendente: mantém o pedido pendente sem reduzir estoque ou enviar notificações.
API
Permite selecionar o ambiente (Sandbox ou Produção) e informar a API Key.
Caso essa configuração já tenha sido realizada conforme a página Configurações iniciais, não será necessário repeti-la.
Webhook
O Plugin Asaas configura automaticamente o Webhook após a validação da API Key.
Também é necessário informar um e-mail de contato para receber notificações caso a fila de Webhooks seja interrompida.
Notificações entre Asaas e o cliente
Permite que o Asaas envie notificações por e-mail e SMS ao cliente durante todo o ciclo da cobrança.
Log de depuração
Mantém registros das operações executadas pelo plugin, facilitando a identificação de erros e o suporte técnico.
Recomendamos manter essa opção habilitada.
Fluxo de validação
%%{init: {"flowchart": {"nodeSpacing": 18,"rankSpacing": 24,"diagramPadding": 4,"padding": 7}}}%%
flowchart TD
A["Habilitar a forma de pagamento"] --> B["Configurar no Sandbox"]
B --> C["Salvar as configurações"]
C --> D["Realizar uma compra de teste"]
D --> E["Validar a cobrança no Asaas"]
E --> F["Receber a atualização via Webhook"]
F --> G["Confirmar o pedido no WooCommerce"]
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 validacao
class G sucesso
linkStyle default stroke:#94A3B8,stroke-width:2px
Se o pedido não for atualizado após uma mudança na cobrança, consulte o Log de depuração e o status da fila em Webhooks do WooCommerce.
Configure o Boleto Bancário
O boleto permite cobranças à vista ou parceladas, além de configurações de vencimento e validade.
Quando utilizarUtilize o boleto quando desejar oferecer pagamentos à vista ou parcelados em até 60 parcelas.
Ver configurações do Boleto Bancário
Parcelas
Permite configurar entre 0 e 60 parcelas.
Juros por parcela
Define os juros aplicados para cada quantidade de parcelas.
Valor mínimo por parcela
Define o menor valor permitido para cada parcela.
Dias de validade
Quantidade de dias até o vencimento do boleto após a compra.
Período de validade
Quantidade de dias que o boleto permanecerá disponível após o vencimento.
Caso o campo permaneça vazio, o boleto não será removido automaticamente.
Split de pagamento
Permite dividir automaticamente o valor recebido entre diferentes carteiras Asaas.
Essa funcionalidade está disponível a partir da versão 2.2.0 do Plugin Asaas.
Configure o Pix
O Pix permite definir a expiração da cobrança e a exibição do Pix Copia e Cola.
Quando utilizarO Pix é indicado para pagamentos imediatos, oferecendo confirmação automática após a liquidação.
Ver configurações do Pix
Período de expiração
Define por quantos dias o QR Code ficará disponível para pagamento.
Após esse período, a cobrança será removida.
Pix Copia e Cola
Quando habilitado, além do QR Code será exibido também o código Pix Copia e Cola para facilitar o pagamento.
Split de pagamento
Permite dividir automaticamente os valores recebidos entre diferentes carteiras Asaas.
Essa funcionalidade está disponível a partir da versão 2.2.0 do Plugin Asaas.
Configure o Cartão de Crédito
O Cartão de Crédito permite configurar parcelamento, valor mínimo do pedido, antecipação e Compra com um clique.
Quando utilizarUtilize o Cartão de Crédito quando desejar oferecer pagamento à vista, parcelado ou recursos como Compra com um clique.
Ver configurações do Cartão de Crédito
Valor mínimo do pedido
Define o valor mínimo para que essa forma de pagamento seja exibida.
Informando 0, o Cartão de Crédito ficará disponível para todos os pedidos.
Parcelas
Permite configurar entre 0 e 12 parcelas.
Juros por parcela
Define os juros aplicados para cada quantidade de parcelas.
Valor mínimo por parcela
Define o menor valor permitido para cada parcela.
Antecipação de recebíveis
Solicita automaticamente a antecipação das cobranças pagas em Cartão de Crédito, respeitando as regras da conta Asaas.
Split de pagamento
Permite dividir automaticamente os valores recebidos entre diferentes carteiras Asaas.
Compra com um clique
Permite armazenar o cartão do cliente para compras futuras.
Essa funcionalidade depende da liberação da tokenização de cartões pelo time comercial do Asaas.
Sobre o Split de pagamento
A opção de Split aparece nas configurações das formas de pagamento, mas a regra atualmente documentada para o Plugin Asaas é global.
Isso significa que todas as novas cobranças criadas pelo plugin utilizam a configuração de Split definida. Alterações não modificam cobranças já existentes.
Antes de habilitar o recurso, consulte Split de pagamento no WooCommerce.
Valide o checkout
Após configurar cada forma de pagamento, valide o comportamento no Sandbox.
| Forma de pagamento | Durante o checkout | Após a geração da cobrança | Após a confirmação |
|---|---|---|---|
| Boleto Bancário | O cliente seleciona boleto e finaliza o pedido. | O pedido recebe o status configurado para pagamentos em aberto. | O Webhook atualiza o pedido após a confirmação do pagamento. |
| Pix | O cliente visualiza o QR Code e, quando habilitado, o Pix Copia e Cola. | A cobrança permanece disponível até o fim do período de expiração. | O Webhook atualiza o pedido após a liquidação. |
| Cartão de Crédito | O cliente informa os dados do cartão e finaliza o pedido. | O pedido segue o resultado do processamento do pagamento. | O pedido é atualizado conforme a confirmação recebida pelo plugin. |
Durante o teste:
- Gere um pedido em Sandbox para cada forma de pagamento habilitada.
- Confirme o título e a descrição apresentados no checkout.
- Valide o Status do pedido para pagamentos em aberto.
- No boleto, valide Dias de validade e Período de validade.
- No Pix, valide o Período de expiração e a exibição do Pix Copia e Cola, quando habilitado.
- No Cartão de Crédito, valide o valor mínimo do pedido e as opções de parcelamento.
- Se utilizar Split, confirme a distribuição dos valores.
- Se o pedido não for atualizado, consulte o Log de depuração e a fila de Webhooks.
Critério para migrar para ProduçãoMigre para Produção somente depois que cada forma de pagamento habilitada gerar a cobrança corretamente, exibir as informações esperadas no checkout e atualizar o pedido após a confirmação do pagamento.
Boas práticas
- Configure inicialmente o plugin utilizando o ambiente Sandbox.
- Valide todas as formas de pagamento antes de migrar para Produção.
- Mantenha o Log de depuração habilitado durante a implantação.
- Utilize apenas as formas de pagamento necessárias para sua operação.
- Caso utilize Split de pagamento, valide a distribuição dos valores antes de disponibilizar a loja aos clientes.
- Após qualquer alteração importante na configuração, realize uma compra de teste para confirmar o funcionamento do checkout.
Continue a configuraçãoApós configurar as formas de pagamento, consulte também:
- Configurações iniciais — conexão da loja com o Asaas.
- Formas de cobrança — diferenças entre cobrança avulsa, parcelada e recorrente.
- Webhooks — sincronização automática entre WooCommerce e Asaas.
- Erros comuns — resolução dos principais problemas de integração.
Próximos passos
Updated 20 days ago