pain.001.001.12 was the newest version until ISO published pain.001.001.13 on 19 March 2026. It is fully supported: generated, migrated, and validated against the official ISO schema.
New to the format? What is pain.001? explains the message, its structure and every version.
What to know about this version#
- Ideal for future-proofing internal formats: generate
.12internally, down-convert per bank withmigrate_records. - As with every version, the official XSD is the acceptance gate, so nothing unvalidated is written.
Element structure (all versions share this skeleton)#
<GrpHdr>Group Header: message id, creation timestamp,NbOfTxs,CtrlSum, initiating party. Pain001 recomputes the control totals from validated records.<PmtInf>Payment Information: debtor, debtor account and agent, requested execution date, payment method, charge bearer; one block can carry many transactions.<CdtTrfTxInf>Credit Transfer Transaction: amount and currency, creditor, creditor account and agent, remittance information, end-to-end reference.
XSD, element reference and examples#
- Official XSD: ISO publishes the
pain.001.001.12schema in its message catalogue. The open-source pain001 library ships the same XSD and validates every file it generates against it. - Element reference: every path, type, cardinality and code list, generated from that XSD: pain.001.001.12 element reference.
- Example files: XSD-valid files covering this version's elements, in the example corpus.
Generate and inspect#
Records can be reshaped between supported versions. The mapper renames and defaults fields to match the target version; elements the target does not model are not carried over, so re-validate after migrating:
=
See the full version catalogue, or the glossary for the vocabulary used here.
