About this plugin
Brazilian stores need a few extra checkout fields to be compliant, avoid delivery issues, and reduce payment gateway errors.
), improves the customer experience with input masks, and works with both:
- Classic (shortcode) WooCommerce checkout
- WooCommerce Checkout Block (Cart & Checkout Blocks)
It also mirrors field values into the legacy _billing_* meta keys used by many themes, integrations and gateways.
Mission
Make the WooCommerce checkout truly Brazil-friendly — with the right fields, the right validation, and a smooth UX.
Why this plugin
Unlike older solutions that only work on the classic checkout, this plugin is built for modern WooCommerce stores:
- Checkout Block compatible (WooCommerce 9.0+ Additional Checkout Fields API)
- Backwards compatible with classic checkout and existing integrations
- Lightweight, settings-driven (enable only what your store needs)
Key features
- Person type (Individual / Company)
- CPF / CNPJ fields with optional validation (settings)
- Optional fields (settings): RG, State Registration (IE), Birthdate, Gender
- Street number and Neighborhood fields (Neighborhood can be optional/required)
- Cell phone options (optional field, required field, or replace WooCommerce phone)
- Input masks / formatting for CPF, CNPJ, phone and more (settings)
- Email typo suggestion (Mailcheck) to help reduce checkout failures
- Brazilian address formatting in orders and “My account” addresses
- REST API enhancements: exposes the extra fields on WooCommerce REST responses
- HPOS compatible (WooCommerce High-Performance Order Storage)
Where to find the settings
WooCommerce > Settings > Shipping > Brazilian Checkout Fields
Compatibility & requirements
- Requires WooCommerce
- WordPress 6.0+ (tested up to 7.0)
- PHP 7.4+
- WooCommerce 9.0+ recommended for Checkout Block support (the plugin auto-detects the Blocks API)
Integrations
This plugin includes compatibility layers / data mapping for:
- Flux Checkout for WooCommerce
- Bcash (adds number and CPF/CNPJ data)
- Moip / Moip Transparent Checkout (adds number, neighborhood, CPF and birthdate when available)
Credits
This plugin is based on the original Brazilian checkout fields work by Claudio Sanches and contributors, and has been significantly refactored/modernized.
Third-party libraries included:
com/Kicksend/mailcheck)
com/igorescobar/jQuery-Mask-Plugin)