OdooWiki OCA HUB

Account Banking PAIN Base Module

account_banking_pain_base folder_open OCA/bank-payment open_in_new
Hidden License: AGPL-3

This module contains fields and functions that are used by the module for SEPA Credit Transfer (account_banking_sepa_credit_transfer) and SEPA Direct Debit (account_banking_sepa_direct_debit). This module doesn't provide any functionality by itself.

This module was started during the Akretion-Noviat code sprint of November 21st 2013 in Epiais les Louvres (France).

auto_awesome What this module does

AI-generated from the code · Odoo 19.0

Technical base module that adds the SEPA/PAIN fields and XML generation logic used by the SEPA Credit Transfer and Direct Debit modules. It provides no standalone feature for end users.

This is a hidden technical module: it does not add a menu or a screen of its own, but it enriches existing payment screens with the extra information required to build SEPA/PAIN payment files.

  • On payment lines (account.payment.line) it adds Priority, Local Instrument, Category Purpose, Purpose and Communication fields, and these values are used when grouping lines into a payment file.
  • On payment methods (account.payment.method) it adds the PAIN version, a Convert to ASCII option, a Warn If Not SEPA option and an address mode for PAIN.001.001.09 files.
  • On payment modes (account.payment.mode) and companies (res.company) it adds Initiating Party Issuer, Identifier and Scheme, plus a default batch booking flag.
  • On payment orders (account.payment.order) it computes whether the order is SEPA, shows a warning when it is not, and adds a charge bearer and batch booking option.

It also validates that bank BIC codes follow the SEPA pattern, converts accented characters to ASCII in generated files, checks the generated XML against the official schema, and can pre-fill Belgian company identifiers at installation. A settings option allows several SEPA/PAIN identifiers, for countries such as Spain.

Depends on

account_payment_order

Required by other modules

account_banking_international_credit_transferaccount_banking_sepa_credit_transferaccount_banking_sepa_direct_debitl10n_ch_pain_basel10n_it_sct_cbil10n_it_sdd_cbi
Models and fields (7)
  • res.bank · extends an existing model
  • res.company · extends an existing modelinitiating_party_issuer, initiating_party_scheme, initiating_party_identifier
  • res.config.settings · extends an existing modelinitiating_party_issuer, initiating_party_scheme, initiating_party_identifier, group_pain_multiple_identifier (Multiple identifiers)
  • account.payment.line · extends an existing modelpurpose, priority, communication, category_purpose, local_instrument, communication_type
  • account.payment.mode · extends an existing modeldefault_batch_booking, initiating_party_issuer, initiating_party_scheme, initiating_party_identifier
  • account.payment.order · extends an existing modelsepa (SEPA Payment), batch_booking, charge_bearer, sepa_payment_method (SEPA Payment Method), show_warning_not_sepa
  • account.payment.method · extends an existing modelpain_version (PAIN Version), warn_not_sepa (Warn If Not SEPA), convert_to_ascii (Convert to ASCII), sepa_pain09_address_mode (PAIN.001.001.09 Address Mode)

Text generated by AI (DeepSeek) from reading the Odoo 19.0 code on GitHub; it may contain mistakes, so check the code before deciding. The module is very large and only part of the code was read. View the code on GitHub

Availability by version

Reviewed: 2026-11-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 8 confirmed, 1 with no information of 9 versions.

Sources · Odoo 16.0

Confirmed on 2026-11-03 in branch 16.0 of OCA/bank-payment.

terminal Installation and usage

OCA documentation · Odoo 19.0

Installation

Source · Odoo 19.0

This module depends on :

  • account_payment_order

This module is part of the OCA/bank-payment suite.

Configuration

Source · Odoo 19.0
  • Go to Invoicing/Accounting > Configuration > Settings.
  • On the fields "Initiating Party Issuer" and "Initiating Party Identifier", in the section SEPA/PAIN, you can fill the corresponding identifiers.

If your country requires several identifiers (like Spain), you must:

  • Go to Invoicing/Accounting > Configuration > Settings.
  • On the section SEPA/PAIN, check the mark "Multiple identifiers".
  • Now go to Invoicing/Accounting > Configuration > Management > Payment Modes.
  • Create a payment mode for your specific bank.
  • Fill the specific identifiers on the fields "Initiating Party Identifier" and "Initiating Party Issuer".
  • When configuring a SEPA Credit Transfer payment method, you can choose the PAIN format version to use. Starting from this version, PAIN.001.001.09 is available and is recommended for credit transfers, as it complies with the newer EPC requirements regarding postal address structure. During upgrade, existing SEPA Credit Transfer payment methods that still use an older pain.001.001.03 format are migrated automatically to PAIN.001.001.09 to avoid generating files that may be rejected by banks. You can still change the PAIN version afterwards if your bank requires a different one.

Usage

Source · Odoo 19.0

See 'readme' files of the OCA/bank-payment suite.

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.