Antes de configurar qualquer forma de pagamento, certifique-se de que sua loja já está conectada à sua conta Asaas conforme descrito em Configurações iniciais.

Cada método de pagamento possui configurações específicas, porém algumas opções são compartilhadas entre todos eles, como autenticação da API, Webhook, notificações e logs.

📘
Antes de começar
Recomendamos 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 comuns

As configurações abaixo estão presentes em todas ou na maioria das formas de pagamento disponibilizadas pelo Plugin Asaas.

Use esta sequência para validar qualquer forma de pagamento antes de disponibilizá-la aos clientes:

Acesse as configurações da forma de pagamento no WooCommerce.
Habilite a forma de pagamento que deseja testar.
Confirme que o ambiente selecionado é Sandbox.
Verifique se a API Key já foi informada nas configurações da API.
Salve as alterações.
Faça uma compra de teste usando essa forma de pagamento.
Confirme se o pedido recebeu o status configurado para pagamentos em aberto.
Aguarde a confirmação do pagamento pelo Asaas ou simule o fluxo aplicável no ambiente de teste.
Verifique se o pedido foi atualizado após o retorno do Webhook.
Consulte o Log de depuração caso o pedido não seja atualizado como esperado.

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.

Configurando Boleto Bancário

O método de pagamento por boleto permite configurar parcelamento, validade da cobrança e regras de divisão dos recebimentos.

💡
Quando utilizar
Utilize 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.

Configurando Pix

O método Pix possui configurações relacionadas ao tempo de expiração da cobrança e à experiência de pagamento do cliente.

⚡
Quando utilizar
O 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.

Configurando Cartão de Crédito

O Cartão de Crédito oferece recursos para parcelamento, antecipação de recebíveis e tokenização.

💳
Quando utilizar
Utilize 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.

Fluxo de validação no checkout

Depois de configurar uma forma de pagamento, execute um teste completo no checkout para validar a experiência do cliente e a atualização do pedido no WooCommerce.

Resultado esperado por forma de pagamento

Forma de pagamento	Durante o checkout	Após a geração da cobrança	Após a confirmação do pagamento
Boleto Bancário	O cliente seleciona o boleto e finaliza o pedido.	O pedido fica com o status configurado para pagamentos em aberto.	O Webhook atualiza o pedido quando o pagamento for confirmado.
Pix	O cliente visualiza o QR Code e, se habilitado, o Pix Copia e Cola.	A cobrança permanece disponível até o fim do período de expiração configurado.	O Webhook atualiza o pedido após a liquidação do Pix.
Cartão de Crédito	O cliente informa os dados do cartão e finaliza o pedido.	O pedido segue o resultado retornado pelo processamento do pagamento.	O pedido é atualizado conforme a confirmação recebida pelo plugin.

Cenários que você deve testar

Gere um pedido em Sandbox para cada forma de pagamento habilitada.
Confirme se o título e a descrição exibidos no checkout correspondem às configurações da forma de pagamento.
Valide se o status inicial do pedido corresponde à opção escolhida em Status do pedido para pagamentos em aberto.
Para boleto, teste o vencimento configurado em Dias de validade e confira se o período de validade atende à sua operação.
Para Pix, confira se o QR Code expira conforme o Período de expiração configurado.
Para Cartão de Crédito, teste o valor mínimo do pedido e as opções de parcelamento configuradas.
Se usar Split de pagamento, valide se a divisão dos valores ocorre antes de liberar a forma de pagamento em Produção.
Consulte o Log de depuração quando o pedido não avançar para o status esperado.

✅
Critério para migrar para Produção
Migre 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ção
Apó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.