Guia grátis para lojas WooCommerce

CPF não aparece no checkout do WooCommerce? A causa é o checkout em blocos.

O Brazilian Market 4.0.2 não põe os campos no checkout em blocos, e o pior é que a venda continua: o pedido entra sem CPF, sem número e sem bairro, e ninguém é avisado. Veja como conferir na sua loja e as duas saídas, as duas grátis.

Checkout em blocos com Brazilian Market: sem campo de CPF e o endereço mostrando os textos number e neighborhood entre chaves
Tela real, com o Brazilian Market 4.0.2 ativo: sem CPF, e o cartão de endereço mostra {number} e {neighborhood}.

CP.S1 — Confira a sua loja

Três sinais, sem mexer em nada.

1. Compre como cliente

Numa aba anônima, ponha um produto no carrinho e vá ao checkout. Se não há campo de CPF, ou o endereço mostra {number} e {neighborhood}, a loja está nesse caso.

2. Abra a página do checkout

No painel, em Páginas, edite a página de checkout da loja. Se ela mostra o bloco de checkout e não o texto [woocommerce_checkout], ela usa o checkout em blocos.

3. Olhe os últimos pedidos

Abra um pedido recente. Sem CPF nos dados de cobrança e com o endereço sem número, o problema já chegou à nota fiscal e à etiqueta de envio.

CP.S2 — O que medimos

Fizemos a compra de verdade antes de escrever.

O ambiente

Loja de teste com WordPress 7.1.4, WooCommerce 11.2.1 e Brazilian Market 4.0.2, a versão atual no WordPress.org, em 2 de novembro de 2026. Compra pelo celular, em checkout em blocos.

O que o comprador vê

Nenhum campo de CPF ou CNPJ, nenhum campo de número ou bairro. O cartão de endereço mostra o texto "Avenida Paulista, {number}, {neighborhood}" exatamente assim.

O que entra na loja

O botão Finalizar pedido funciona. O pedido entrou em processamento com CPF, CNPJ, número e bairro em branco, e o endereço salvo foi só "Avenida Paulista", sem número.

Por que acontece

Os campos do plugin entram por um filtro do checkout clássico, que o checkout em blocos não usa. A versão 4.0.2 é de fevereiro de 2024 e declara teste até o WooCommerce 8.6. Quem usa relata o mesmo no fórum de suporte do plugin.

CP.S3 — As duas saídas

Volte ao checkout antigo ou mantenha os blocos.

Saída 1: checkout antigo, com o Brazilian Market

Na página de checkout, troque o bloco por um bloco de shortcode com [woocommerce_checkout]. Na nossa loja de teste, Tipo de Pessoa, CPF, número e bairro voltaram.

O que fica para trás: a loja volta ao visual do checkout antigo, com os dois tipos de pessoa, e o plugin segue sem aceitar o CNPJ com letras, que a Receita emite desde julho de 2026.

Checkout clássico por shortcode com os campos Tipo de Pessoa e CPF do Brazilian Market
Tela real: o mesmo plugin, no checkout por shortcode.

Saída 2: mantenha os blocos, com o Checkout Brasil

  1. Instale o Checkout Brasil, plugin grátis com licença GPL. Não há nada para configurar.
  2. Desative o Brazilian Market para o checkout não pedir o mesmo dado duas vezes.
  3. Faça uma compra de teste. Na nossa, o pedido saiu com CPF 123.456.789-09, número 1578 e bairro Bela Vista, nas mesmas chaves do Brazilian Market.
Checkout em blocos com o campo CPF ou CNPJ preenchido e o endereço completo com número e bairro
Tela real: a mesma loja, em blocos, com um campo só para CPF ou CNPJ.

CP.S4 — Perguntas

O que perguntam sobre o CPF no checkout.

Por que o CPF não aparece se o Brazilian Market está ativo?

Porque o plugin adiciona os campos por um filtro do checkout clássico, e o checkout em blocos não usa esse filtro. A versão 4.0.2, a última publicada no WordPress.org até 2 de novembro de 2026, é de fevereiro de 2024 e declara teste até o WooCommerce 8.6.

A loja recusa o pedido quando falta o CPF?

Não. Na nossa compra de teste com o Brazilian Market 4.0.2 no checkout em blocos, o pedido entrou como em processamento, com CPF, número e bairro em branco. Ninguém é avisado.

Posso continuar com o Brazilian Market?

Pode, trocando o bloco pelo shortcode [woocommerce_checkout]. O CPF volta, mas a loja fica com o checkout antigo e continua sem aceitar o CNPJ com letras.

Preciso desativar o Brazilian Market para usar o Checkout Brasil?

Sim. Os dois pedem o mesmo dado, e o Checkout Brasil substitui os campos de CPF, CNPJ, número e bairro. Com o Brazilian Market desativado, o cartão de endereço também deixa de mostrar {number} e {neighborhood}.

O que acontece com os pedidos antigos?

Continuam com o documento e o endereço. O Checkout Brasil lê e grava as mesmas chaves do Brazilian Market (_billing_cpf, _billing_cnpj, _billing_persontype, _billing_number e _billing_neighborhood), e o cliente que volta encontra os campos preenchidos.

E os pedidos que já entraram sem CPF?

Nenhum plugin recupera um dado que o comprador não digitou. Procure esses pedidos na lista do WooCommerce e peça o CPF ao cliente antes de emitir a nota.

O meu gateway ou emissor de nota vai receber o CPF?

Quem lê as chaves do Brazilian Market recebe. Medimos o Checkout Brasil ao lado de 16 plugins brasileiros de frete, pagamento e nota, e fechamos pedidos com o Melhor Envio e o PagBank ativos. Não rodamos pagamento real, que depende da conta de cada loja: faça um pedido de teste e confira antes de vender.

O Checkout Brasil é pago?

O plugin que resolve os campos no checkout em blocos é grátis, com licença GPL, e não manda dados do comprador para fora da loja. O Pro, por R$ 197 por ano por loja, acrescenta a razão social pelo CNPJ, o endereço pelo CEP e a inscrição estadual.

E o comprador de fora do Brasil?

Quando o país do endereço não é o Brasil, os campos de CPF ou CNPJ, número e bairro somem e o pedido fecha sem eles. No checkout em blocos isso exige o WooCommerce 9.9 ou mais novo; antes dele, os campos continuam obrigatórios para todos.

CP.S5 — Suporte

O CPF continua sem aparecer na sua loja?

Chame no WhatsApp com o link da loja e o que aconteceu. Você fala com quem escreveu o plugin.