Pain001 logo Pain001
Get started ›

Message reference

pain.001.001.09 Reference: Generate and Validate

pain.001.001.09 — the CBPR+ version for cross-border payments. Element structure, version notes, and lossless migration.

1 min read Last reviewed

pain.001.001.09 (2019) is the version CBPR+ selected for customer credit transfer initiation on the SWIFT network, and the mandated replacement for the interbank MT101 relay from 14 November 2026. It is Pain001's default recommendation for any new cross-border integration, and the target shape of the MT101 loader.

What to know about this version#

  • Financial institutions are identified with (renamed from v03's ).
  • The 2019 party and account structures add richer identification — including LEI — and proxy account support.
  • Structured and hybrid postal addresses meet the 14 November 2026 CBPR+ address requirement; Pain001 emits both.
  • UETR carriage supports end-to-end tracking through the correspondent chain.

Element structure (all versions share this skeleton)#

  • Group Header — message id, creation timestamp, NbOfTxs, CtrlSum, initiating party. Pain001 recomputes the control totals from validated records.
  • Payment Information — debtor, debtor account and agent, requested execution date, payment method, charge bearer; one block can carry many transactions.
  • Credit Transfer Transaction — amount and currency, creditor, creditor account and agent, remittance information, end-to-end reference.

Generate and inspect#

pain001 init pain.001.001.09 -o work/         # scaffold a starter CSV
pain001 inspect pain.001.001.09               # list required + optional fields
pain001 -t pain.001.001.09 -d payments.csv -o out/ --dry-run

Records migrate losslessly between supported versions:

from pain001.migration import VersionMapper
records_v9 = VersionMapper("pain.001.001.09", "pain.001.001.09").migrate(records)

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