Message reference

pain.001.001.12: XSD, Example and Format Reference

pain.001.001.12 is the newest version Pain001 supports. Element structure, version notes, and version migration.

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 .12 internally, down-convert per bank with migrate_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.12 schema 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#

pain001 init pain.001.001.12 -o payments.csv  # write a starter CSV
pain001 inspect pain.001.001.12               # template, schema, input formats
pain001 -t pain.001.001.12 -d payments.csv -o out/ --dry-run

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:

from pain001.migration import VersionMapper
rows = VersionMapper().migrate_rows(
    rows, "pain.001.001.12", "pain.001.001.09"
)

See the full version catalogue, or the glossary for the vocabulary used here.