Description
PagoExpress Gateway for WooCommerce connects your store directly to the PagoExpress financial processing engine, allowing merchants to accept the three most popular payment methods in Brazil: PIX, Boleto Bancário, and Credit Card (Cartão de Crédito V2).
The extension is engineered for high conversion, complete privacy, and enterprise stability, supporting both the modern Gutenberg Checkout Blocks (woocommerce/checkout) and the Classic Checkout shortcode ([woocommerce_checkout]).
Key Features
-
Instant PIX Payments:
- Dynamic QR Code generation and one-click “PIX Copia e Cola” code.
- Real-time confirmation via Webhook notifications.
- Automatic remote charge cancellation upon local order cancellation.
- Native full and partial refunds from the WooCommerce Order Management screen.
-
Boleto Bancario:
- Registered bank slip issuance with digitable line and direct printable PDF view.
- Configurable expiration window and custom banking instructions.
- Automated status updates upon bank settlement via Webhooks.
-
Credit Card V2 (Cartao de Credito):
- Synchronous credit card authorization via PagoExpress API V2.
- Flexible installment options from single payment (1x) up to 12x.
- Configurable minimum installment thresholds.
- Native full and partial refunds via
/card/reversal. - Zero storage of cardholder data (PAN or CVV) on your WordPress database.
-
Autonomous Brazilian Fiscal Fields:
- Native collection, formatting, and validation for CPF/CNPJ, Street Number, Neighborhood, and Phone Number.
- Operates autonomously on both Classic and Blocks Checkouts without requiring third-party helper plugins.
-
Architecture & Standards:
- 100% compatible with High-Performance Order Storage (HPOS /
custom_order_tables). - Anti-duplicate concurrency locks preventing double-charges.
- Strict numeric status normalization ensuring deterministic order lifecycle.
- Complete security masking in diagnostic logs.
- 100% compatible with High-Performance Order Storage (HPOS /
Third-Party Service Disclosure
This plugin connects your WooCommerce store to the external PagoExpress Payment Gateway API (operated by PagoExpress: https://pagoexpress.com.br) to process financial transactions.
What service is used?
The PagoExpress REST API (https://pagoexpress.com.br) is utilized for merchant authentication, transaction authorization, dynamic QR Code generation, bank slip issuance, credit card processing, payment cancellation, and refunds.
What data is transmitted to the external service?
Only data strictly necessary to process payments and comply with Brazilian fiscal and banking requirements is transmitted over an encrypted TLS 1.2+ HTTPS connection:
* Customer Identification: Full Name, CPF or CNPJ (Tax ID).
* Contact Details: Email address, Phone / Cellphone number.
* Billing Address: Street address, Number, Neighborhood, City, State, Postcode, Country.
* Order Details: Order items, total order value, currency (BRL), order ID.
* For Credit Card payments: Cardholder Name, Card Number, Expiration Month/Year, and CVV (processed synchronously in memory; never saved to the local WordPress database or log files).
Under what circumstances is data transmitted?
Data transmission occurs strictly when:
1. The customer places an order at checkout.
2. The merchant issues a refund or cancels a pending order in the WooCommerce admin.
3. The PagoExpress webhook delivers an asynchronous Cash-In payment notification.
Service Agreements & Policies
- Terms of Service: https://pagoexpress.com.br/termos-de-uso
- Privacy Policy: https://pagoexpress.com.br/politica-de-privacidade
- Commercial Account: To accept live payments, merchants must have an active merchant account with PagoExpress.
Installation
- Upload the plugin files to the
/wp-content/plugins/pagoexpress-gateway-for-woocommercedirectory, or install the plugin through the WordPress plugins screen directly. - Activate the plugin through the ‘Plugins’ screen in WordPress.
- Ensure WooCommerce is active and store currency is set to Brazilian Real (BRL).
- Navigate to WooCommerce > Settings > Payments > PagoExpress — Configuracoes Gerais.
- Enter your PagoExpress Client ID, Client Secret, and Merchant ID.
- Configure the Webhook User and Password for Basic Authentication, and register the endpoint (
https://yourstore.com.br/wc-api/pagoexpress_webhook) in your PagoExpress dashboard. - Enable the desired payment methods (PIX, Boleto, Cartao de Credito) under WooCommerce > Settings > Payments.
FAQ
-
Does this plugin require WooCommerce?
-
Yes. This extension requires WooCommerce 6.0 or higher to be active.
-
Is High-Performance Order Storage (HPOS) supported?
-
Yes. The extension is 100% compatible with HPOS (
custom_order_tables). -
Does it support WooCommerce Blocks?
-
Yes. Native React components are provided for Gutenberg Cart and Checkout Blocks (
woocommerce/checkout), alongside Classic Checkout ([woocommerce_checkout]). -
Are credit card numbers stored on my server?
-
No. Credit card numbers (PAN) and security codes (CVV) are never stored in the database, cookies, sessions, or logs.
-
How do refunds work?
-
PIX and Credit Card refunds can be initiated directly from the WooCommerce Order Edit screen by clicking “Refund via PagoExpress”. Due to Brazilian banking limitations, Boleto refunds must be handled manually by bank transfer and recorded as a manual refund in WooCommerce.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“PagoExpress Gateway for WooCommerce” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “PagoExpress Gateway for WooCommerce” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.0
- Initial public release.
- Added PIX payment gateway with dynamic QR Code, copy-paste key, webhook confirmation, and native reversal.
- Added Boleto Bancario gateway with digitable line, direct PDF slip, and webhook reconciliation.
- Added Credit Card V2 gateway with 1x to 12x installment plans and native reversal.
- Added 100% compatibility with High-Performance Order Storage (HPOS).
- Added native support for Cart and Checkout Blocks.
- Added autonomous Brazilian fiscal fields (CPF/CNPJ, Number, Neighborhood, Phone) for Classic and Blocks checkout.
- Added centralized credential management and Basic Auth webhook security.
- Added concurrency locking and anti-duplicate guards preventing double-charges.
