OdooWiki OCA HUB

Payment Bacen PIX

payment_bacen_pix folder_open OCA/l10n-brazil open_in_new
Uncategorised License: AGPL-3

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.0

Adds 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

account_payment
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-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation 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.0

This module depends on:

  • account_payment

No verified information in OCA: Configuration, Usage.

info

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.