Aceitar boleto no WooCommerce exige um gateway brasileiro, credenciais de produção e SSL ativo antes da primeira venda. Segundo o Baymard Institute (2024), cerca de 70% dos carrinhos são abandonados antes do pagamento. O boleto compensa em até 3 dias úteis e exige controle de estoque. Configure em ambiente de teste antes de liberar a loja.

Aceitar boleto no WooCommerce significa conectar um gateway de pagamento brasileiro à sua loja para emitir boletos bancários direto no checkout, sem contrato avulso com um banco. O processo passa por instalar um gateway que suporte boleto, gerar as credenciais de produção, definir a data de vencimento e validar o fluxo com um boleto de teste. Antes de tudo, a loja precisa de um certificado SSL válido, porque a API do gateway recusa conexões sem HTTPS. Este guia cobre os 5 passos, o controle de estoque e os erros que travam o pedido em “aguardando pagamento”. Se a loja ainda não existe, comece pelo conteúdo de WooCommerce da FULL.

Primeiros passos: O que você precisa antes de aceitar boleto

Antes de ativar o boleto no WooCommerce, quatro pré-requisitos evitam a maioria dos chamados de suporte: conta verificada em um gateway que emita boleto, WooCommerce 8.x em WordPress 6.x, SSL ativo e PHP 8.0 ou maior. O WooCommerce nativo não gera boleto sozinho; o gateway é o que fala com o arranjo de pagamento e devolve o código de barras ao cliente.

Sem esses itens, o checkout carrega mas a emissão falha ao chamar a API. Se a loja ainda não está pronta, o guia de como configurar o WooCommerce cobre a base.

Legenda: a verificação de SSL e da versão do PHP evita os erros de conexão mais comuns na primeira emissão de boleto.

Passo a passo: Configurar o boleto no WooCommerce

O caminho completo do boleto no WooCommerce leva cerca de 15 minutos e tem 5 etapas: instalar o gateway, gerar as credenciais, conectá-las ao WooCommerce, definir o vencimento e rodar um teste. A ordem importa: colar credenciais de produção antes de validar em modo de teste é a causa número um de boletos que somem do painel.

Passo 1: Instale um gateway que emita boleto

Acesse Plugins > Adicionar novo no painel do WordPress e busque um gateway brasileiro que suporte boleto, como o plugin oficial do Mercado Pago ou do PagSeguro. Instale, ative e confirme que a versão é a mais recente, atualizada em 2026. Evite gateways não oficiais: eles costumam ficar sem manutenção e quebram a cada atualização do WooCommerce. O plugin oficial adiciona um menu próprio dentro de WooCommerce > Configurações.

Passo 2: Gere as credenciais de produção

No painel de desenvolvedores do gateway, crie uma aplicação e copie as credenciais: em geral um Access Token e uma chave pública. Cada uma tem versão de teste e de produção. Para vender de verdade, use as de produção; as de teste servem só para o passo 5. Guarde o Access Token como uma senha, porque ele autoriza a emissão de boleto na sua conta.

Passo 3: Conecte as credenciais ao WooCommerce

Em WooCommerce > Configurações > Pagamentos, abra o gateway e cole as credenciais nos campos correspondentes. Ative a opção de boleto na lista de métodos. O plugin valida a conexão na hora e mostra um aviso verde se as credenciais forem aceitas. Se aparecer erro de autenticação, confira se não misturou credencial de teste com produção, o engano mais frequente nos tickets da FULL.

Passo 4: Defina a data de vencimento e o estoque

No painel do gateway, defina em quantos dias o boleto vence, em geral entre 1 e 3 dias úteis. Esse prazo decide quanto tempo o pedido fica em aberto. Configure o WooCommerce para baixar o estoque só na compensação, e não na geração do boleto, para não reservar produto que pode nunca ser pago. Defina também a regra de cancelamento automático de boletos vencidos.

Passo 5: Rode um boleto de teste

Com as credenciais de teste e o modo sandbox ligado, finalize uma compra escolhendo boleto no checkout. Confirme que o código de barras é gerado, que o pedido entra como “aguardando pagamento” e que a confirmação simulada muda o status para “processando”. Só depois troque para as credenciais de produção e desligue o sandbox. Esse passo evita o cenário de boleto fantasma.

Legenda: a validação verde das credenciais confirma que o WooCommerce conversa com a API do gateway de boleto.

Vantagens e limites: Quando o boleto faz sentido na loja

O boleto no WooCommerce atende um público específico: quem não tem cartão de crédito ou prefere não usar dados de cartão online. A contrapartida é o prazo, já que o boleto compensa em até 3 dias úteis, contra os segundos do Pix. Para a loja, isso significa caixa mais lento e estoque parado enquanto o pagamento não cai.

Combinar boleto com Pix e cartão cobre quase todo comprador brasileiro. A tabela abaixo resume o trade-off de cada forma de pagamento.

O guia dos melhores plugins de gateway de pagamento WooCommerce mostra onde cada opção se encaixa. O Mercado Pago compete por aceitar boleto e Pix sem conta de adquirência separada; o PagSeguro, por marca no varejo; o Stripe, por cobertura internacional, mas não emite boleto no país.

Custo, taxa e estoque: Quanto o boleto consome da venda

O custo do boleto no WooCommerce não é mensalidade, e sim uma tarifa fixa por boleto emitido, em geral cobrada só na compensação. Diferente do cartão, não há percentual sobre o valor da venda na maioria dos gateways, o que torna o boleto barato em ticket alto e caro em ticket baixo. O gateway é gratuito; o gasto aparece a cada boleto pago.

O ponto que mais pesa não é a tarifa, e sim o estoque travado. Cada boleto em aberto reserva produto por dias, e parte nunca é paga. Configure o WooCommerce para baixar o estoque só na aprovação e cancelar boletos vencidos. Para medir o impacto, acompanhe a taxa de conversão.

Reduza o abandono ligando recuperação de carrinho

Aceitar boleto resolve metade do problema; a outra metade é trazer de volta quem gerou o boleto e não pagou. Conecte uma estratégia de recuperação de carrinho no WooCommerce com um lembrete antes do vencimento. Com cerca de 70% de carrinhos abandonados, segundo o Baymard, essa etapa converte boleto esquecido em venda.

Apoio especializado para sua loja WooCommerce

Aceitar boleto no WooCommerce, manter o SSL em dia, otimizar o schema de produto e ainda recuperar carrinho exige um conjunto de plugins premium. Comprar cada licença avulsa soma centenas de reais por ano, e é aí que a conta pesa para quem administra loja no WordPress.

O plano PRO da FULL reúne Rank Math PRO, temas prontos para WooCommerce e ferramentas de performance por R$849 ao ano. Como o plano cobre até 10 sites, o custo cai para cerca de R$85 por site. É o tipo de conta que a gente vê fechar a favor de quem administra mais de uma loja. Veja os detalhes em FULL.services/planos.

Erros comuns: Boleto que some e pedido preso

O erro que mais aparece nos tickets da FULL é o pedido travado em “aguardando pagamento” mesmo depois de o cliente pagar o boleto. A causa quase sempre é a URL de notificação (webhook IPN) do gateway batendo num endpoint bloqueado por firewall ou servido pelo cache de página. O aviso de compensação nunca chega ao WooCommerce e o pedido fica no limbo por dias.

A correção é excluir a rota /wc-api/ do cache e liberar o user-agent do gateway no endpoint da REST API. O segundo erro é o boleto fantasma: o pedido consta como pago, mas nada compensou. Isso ocorre quando credenciais de teste ficam ativas em produção. Nos testes que acompanhamos, resolve na maioria dos casos ao trocar as credenciais pelas versões de produção e desligar o sandbox. Quem aceita também Pix no WooCommerce ou Mercado Pago no WooCommerce enfrenta o mesmo webhook, então a regra de cache vale para todos.

Decisão rápida: Qual configuração de boleto escolher

• Se parte do seu público não usa cartão → mantenha o boleto no WooCommerce ativo, aceitando a compensação em até 3 dias úteis.
• Se a loja tem estoque baixo ou produto sazonal → baixe o estoque só na compensação e cancele boletos vencidos automaticamente.
• Se o caixa precisa girar rápido → priorize Pix e cartão e ofereça o boleto como terceira opção, não como principal.
• Se o pedido fica preso em aguardando pagamento → evite culpar o gateway, libere o webhook IPN no firewall e exclua /wc-api/ do cache.

Perguntas frequentes sobre o boleto no WooCommerce

Próximos passos para sua loja vender mais

Com o boleto no WooCommerce configurado e testado, sua loja aceita um método que amplia o público para além de quem tem cartão. O ganho real não está só em emitir o boleto, e sim em equilibrar a fricção menor para o cliente com o controle de estoque e caixa do lado da loja. A partir daqui, refine o fluxo: ative a recuperação de carrinho com lembrete de vencimento, melhore a velocidade da página com o guia de WooCommerce lento e ofereça também o checkout transparente no WooCommerce para reduzir desistência. Para aprofundar cada etapa, o FULL Academy reúne os tutoriais, guias e reviews de WooCommerce em um só lugar.