Payment Acquirer: PIX with Bacen
This module extends the payment module to add a new payment method: Pix Bacen.
auto_awesome What this module does
AI-generated from the code · Odoo 14.0Adds a PIX payment provider (Bacen/Banco do Brasil) to Odoo, so customers can pay with PIX QR codes and payments are confirmed automatically through the bank's webhook.
This module adds a new payment provider called "Bacen (PIX)" to the Payment Acquirers list. Once configured with the bank credentials (Email, Client ID, Client Secret, Basic, PIX Key, Dev APP KEY and an expiration time in seconds), users can enable it and offer PIX as a payment option to customers.
When a customer pays, Odoo creates a PIX charge at the bank and shows a QR code on the payment page. The transaction stays in draft until the customer pays; while waiting it shows a pending confirmation message. A "Check Status" button on the payment transaction form lets users manually refresh the status from the bank.
Statuses are updated automatically: created becomes pending, paid becomes done, rejected becomes error, and expired cancels the transaction and resets and cancels the related invoices. A public webhook receives the bank's notifications and validates them with a secure signature before updating the transaction.
The module also computes payment fees based on the acquirer's fee settings, and adds PIX-specific fields (QR code, amount, currency, expiration, transaction id, PIX key, status) to payment transactions. It touches payment.acquirer and payment.transaction.
Depends on
Models and fields (2)
- payment.acquirer · extends an existing modelprovider, bacen_pix_key (PIX Key), bacen_pix_basic (Basic), bacenpix_api_key (API KEY), bacenpix_client_id (Client ID), bacen_pix_expiration (Bacen PIX Expiration), bacenpix_dev_app_key (Dev APP KEY), bacenpix_client_secret (Client Secret), bacenpix_email_account (Email)
- payment.transaction · extends an existing modelbacenpix_txid, bacenpix_chave, bacenpix_state, bacenpix_amount, bacenpix_qrcode, bacenpix_criacao, bacenpix_currency, bacenpix_date_due, bacenpix_location, textoImagemQRcode, bacenpix_expiracao, bacenpix_state_message
Text generated by AI (DeepSeek) from reading the Odoo 14.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub
Availability by version
Reviewed: 2026-11-03Confirmation status: 1 confirmed, 8 with no information of 9 versions.
Sources · Odoo 14.0
Confirmed on 2026-11-03 in branch 14.0 of OCA/l10n-brazil.
terminal Installation and usage
OCA documentation · Odoo 14.0Installation
Source · Odoo 14.0This module depends on:
- account_payment
No verified information in OCA: Configuration, Usage.
Installation instructions, the distribution package, dependencies and configuration steps are not shown because they have not yet been verified in the module documentation for any version.
Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.