
Selling to Brazilian Customers on WooCommerce: CPF, CEP, and Pix Explained
Selling to Brazilian customers on WooCommerce? You need CPF and CNPJ fields with input masks, CEP auto-fill via ViaCEP, and Pix as a payment option. This guide explains exactly what to implement and why.
Why Brazilian E-commerce Has Its Own Requirements
Brazil is the largest e-commerce market in Latin America and one of the most mobile-first markets in the world. But selling to Brazilian customers on WooCommerce requires handling a few local requirements that are not part of the default WooCommerce setup: CPF and CNPJ tax document fields, CEP postal code auto-fill, and Pix as a payment method.
Get these right and you remove the friction that causes Brazilian customers to abandon checkout. Get them wrong and you lose customers who are ready to buy.
CPF and CNPJ: What They Are and Why They Matter
CPF (Cadastro de Pessoas Fisicas) is the Brazilian individual taxpayer identification number. CNPJ (Cadastro Nacional da Pessoa Juridica) is the company equivalent. Brazilian e-commerce stores are legally required to collect one of these on purchases, and Brazilian customers expect to see a field for it at checkout.
The input format matters. A CPF is formatted as 000.000.000-00 and a CNPJ as 00.000.000/0000-00. An unformatted plain text field technically accepts the number but feels wrong to Brazilian customers who are used to seeing the mask applied automatically as they type.
ChatCart Pro includes both CPF and CNPJ fields with automatic input masks in its custom checkout form manager. The mask applies as the customer types, validation runs before the form submits, and the document number is included in the WhatsApp order message automatically. Setup is in the Fields tab of the ChatCart Pro settings panel.
CEP: Address Auto-Fill with ViaCEP
CEP (Codigo de Enderecamento Postal) is the Brazilian postal code system. When a customer types their CEP, the expectation in Brazilian e-commerce is that the street, neighborhood, city, and state fields fill in automatically. This is not optional polish, it is an expected behavior that most Brazilian customers have internalized.
The ViaCEP API is a free public API that returns address data for any valid Brazilian CEP. ChatCart Pro integrates with ViaCEP directly. When a customer types their 8-digit CEP in the checkout form, the address fields populate automatically with no extra configuration needed.
Pix: Brazil's Instant Payment System
Pix was launched by the Banco Central do Brasil in November 2020 and achieved adoption faster than any payment system in Brazilian history. By 2024, Pix accounted for more than 50% of all payments by value among small and medium businesses. For e-commerce, that means offering Pix is no longer optional for stores selling to Brazilian customers.
For WooCommerce, Pix payment can be added through several plugins. Mercado Pago's official WooCommerce plugin includes Pix support alongside credit card and boleto options. PagSeguro and PicPay also have WooCommerce integrations with Pix. The implementation generates a QR code and a copy-paste Pix key at checkout, which the customer uses to transfer instantly from their banking app.
ChatCart Pro's payment methods tab lets you list Pix as an available payment option in the WhatsApp order message, so customers can indicate they want to pay via Pix before the conversation starts.
WhatsApp as the Sales Channel of Choice
In Brazil, WhatsApp is not one channel among many. It is the primary communication infrastructure. Over 95% of Brazilian smartphone users are on WhatsApp, and a significant portion of Brazilian e-commerce happens directly through WhatsApp conversations rather than through traditional checkout flows.
ChatCart Pro is purpose-built for the Brazilian market, with CPF and CNPJ fields with input masks, CEP auto-fill via the ViaCEP API, Pix in the payment methods list, and WhatsApp ordering built into the WooCommerce flow. Get ChatCart Pro for $69, one-time payment →
A WhatsApp order button on your WooCommerce product pages, combined with a checkout form that handles CPF, CEP, and Pix correctly, covers the full Brazilian customer experience. The customer can order through WhatsApp with a checkout form that feels native to their market, pay by Pix, and receive their order confirmation through the same channel where they placed the order.
Practical Setup Checklist for Brazilian WooCommerce Stores
Add a CPF or CNPJ field to your checkout form with proper input masking. Enable CEP auto-fill so the address fields populate automatically. Add Pix as a payment option through a payment gateway plugin. Install a WhatsApp order button that creates real WooCommerce orders and includes the document number and payment method in the order message. Test the full flow on a Brazilian mobile device or simulator before going live.
These five steps cover the core requirements that separate a WooCommerce store that works for Brazilian customers from one that feels foreign and loses them at checkout.