xpay✦ Commerce
Directory
WooCommerce plugins
Campos Checkout Brasileiro para WooCommerce
Campos Checkout Brasileiro para WooCommerce
Brazilian checkout fields: CPF/CNPJ, address number, neighborhood and phone, with automatic CEP address pre-filling and much more for WooCommerce.
4.9
(45 ratings)Will this break my store?
What the WordPress.org registry says about keeping Campos Checkout Brasileiro para WooCommerce running.
Tested to 7.1.3
Tested against the WordPress branch in use today.today
At least 10.0 releases a year since launch. WordPress.org only lists versions still available for download, so the real number may be higher.8.2
Your host must be running at least this version.5.0
woocommerce
These must be installed and active first.78% of 9 recent threads resolved
From the plugin's WordPress.org support forum.2
Maintenance & trust
Scored on how Campos Checkout Brasileiro para WooCommerce is looked after — not on how many stores run it.
99
out of 100Maintenance
35 / 35WordPress compatibility
20 / 20Support responsiveness
20 / 20Merchant satisfaction
14 / 15Listing transparency
10 / 10Ratings
4.9
45 ratingsComplete Brazilian checkout fields designed specifically for Brazilian Market on WooCommerce stores in Brazil, making it easier and significantly improving the data entry flow on the checkout pages.
This version includes full compatibility with Shortcodes and Gutenberg themes, allowing you to use the Brazilian checkout fields anywhere on your site with maximum flexibility.
This WordPress plugin ensures faster address verification and cleaner form management, leading to a better user experience and fewer abandoned carts.
Note: The shipping calculator features have moved to a dedicated plugin: Shipping Simulator for WooCommerce.
🚀 Full and Free Brazilian Checkout
We have expanded the plugin capabilities to offer a full checkout solution for the Brazilian Market on WooCommerce, managing Custom Checkout Fields essential for Brazilian logistics and fiscal invoicing. Every field is listed — with its meta key and what it does — in the Checkout fields section below.
✅ ERP & “Brazilian Market” Compatibility
This is a major update for store owners who need to issue invoices (Nota Fiscal). The plugin is now fully compatible with other payment’s plugin for the data standards used by the Brazilian Market on WooCommerce plugin by Claudio Sanches.
Why is this important?
1. Bling & ERP Integration: CPF, CNPJ and address data are saved with the standard meta keys (the same ones listed below), so this plugin is fully compatible with Bling, Tiny and other ERPs that integrate with WooCommerce. You can issue invoices (NFe) without data errors.
2. No double data entry: the same value feeds the checkout, the order, the customer profile and the invoice app.
Key Features & Improvements:
On the Checkout Page:
- Automatic Address Lookup: Fills in street, neighborhood, city and state as soon as the customer enters a valid CEP.
- Input Validation: Checks CPF/CNPJ digits and applies input masks, so a wrong number is caught before the order is placed.
- Dynamic Field Hiding: Hides the fields that do not apply to the customer — company data for individuals, CPF and RG for companies — and gives the typed value back when the field returns.
- Person Type Selector: In the block checkout the customer can switch between “Person” (Pessoa Física) and “Company” (Pessoa Jurídica); in the classic checkout the type follows the document that was typed.
Additional Features:
- The plugin is fully customizable via action and filter hooks for advanced users.
More details can be found in the Frequently Asked Questions (FAQ).
Checkout fields
Below is every field the plugin adds or manages, on the billing and shipping address forms (classic checkout, block checkout, the account’s edit-address page and the order admin screen):
- CPF/CNPJ (
billing_document): a single document field with mask and validation. It reads the number of digits to tell individuals (CPF, 11 digits) from companies (CNPJ, 14 digits) — and that choice drives the rest of the form. - Person type (
billing_persontype): hidden field that stores the type worked out from the document, so other plugins and ERPs read “individual” or “company” the way they expect. - CPF (
billing_cpf) and CNPJ (billing_cnpj): hidden companions that receive the same value as the document, for invoice (NF-e) plugins and ERPs that look for these keys. - Company (
billing_company): shown for companies. Its behavior is configurable — Dynamic, Optional, Required or Disabled. - State registration / Inscrição Estadual (
billing_ie): shown for companies, with an “Isento” (exempt) checkbox. Required when enabled. - Municipal registration / Inscrição Municipal (
billing_im): shown for companies and required for them. No “Isento” option, because the municipal registration is what identifies the business for service invoices. - RG (
billing_rg): shown for individuals only, next to the CPF, and hidden for companies. Optional by default. Saved with the same key used by invoice apps, so the value is already there when you issue the nota fiscal. - Number (
billing_number): the street number, mandatory and usually missing from standard WooCommerce forms. It comes with a “Sem Número” (no number) checkbox that fills the field for addresses without a number. - Neighborhood / Bairro (
billing_neighborhood): mandatory neighborhood field, placed right after the address. - Complement (
billing_address_2): the native WooCommerce complement, renamed and repositioned. - Phone (
billing_phone): phone field with mask and country code (DDI). Four modes: full phone, cellphone only, landline only or disabled. Optional validation of the number (including the area code). - Cellphone (
billing_cellphone): optional separate cellphone field, filled in alongside the phone, and a hidden mirror for gateways that expect it. - Birthdate (
billing_birthdate): optional date field, with an option to make it required. - Gender (
billing_gender): optional dropdown (Male, Female, Non-binary, Other, Prefer not to say). - Postcode / CEP (
billing_postcode): can be highlighted at the top of the form, with a confirmation checkbox and automatic address lookup. - Country, State and City (
billing_country,billing_state,billing_city): the native WooCommerce fields, kept in place and repositioned so the Brazilian order of the address makes sense.
Every field above can be turned on or off in WooCommerce > Settings > Campos Brasileiros, together with its required/optional rule.
Help and Support
When you need help, please create a topic in the Plugin Support Forum.
** Recommended Plugins **
* Shipping Simulator for WooCommerce – Shipping calculator for the product and cart pages, free shipping rules and more.
* Link Invoice Payment for WooCommerce – Integrate custom payment methods and offer invoice-based payments in your WooCommerce store.
* Pix For WooCommerce – Integrate Pix, Brazil’s revolutionary instant payment system, into your WooCommerce store
* AntiFraude – Fraud and Scam Detection For WooCommerce
* Authentification and OTP for WooCommerce – OTP and Force customer to log in or register before checkout to increase your conversion rate.
Does this plugin replace “Brazilian Market on WooCommerce”?
Yes, this plugin acts as an updated solution for Brazilian Market on WooCommerce. It maintains full compatibility with existing data but offers improved features. Note: To use it, you must disable the Brazilian Market on WooCommerce plugin (by Claudio Sanches) to avoid field conflicts.
Why is the Phone field now mandatory and asking for a Country Code (DDI)?
This feature was added to ensure all essential customer contact data is complete and correctly formatted. The DDI (Dialing Code International) ensures the phone number is standardized for both national and international calls, which is crucial for logistics and customer service. You can disable this feature in the plugin settings under the Checkout tab.
How does the automatic address lookup by CEP work?
When the customer enters a valid 8-digit CEP (Brazilian postcode) on the checkout page, the plugin uses public APIs (like VIACEP and Brasil API) to automatically retrieve and fill in the Street, City, State, and Neighborhood fields, speeding up the checkout process.
Contributions
If you find any errors or have suggestions, please open an issue in our GitHub repository.
- Brasil API – ZIP code lookup and CNPJ validation.
- ReceitaWS – CNPJ validation (fallback).
- VIACEP – ZIP code field.
- International Telephone Input – Phone number field with country code.
Categories
Plugin details
Tags on WordPress.org
