Pain001 logo Pain001
Get started ›

Message reference

pain.001.001.10 Reference: Generate and Validate

pain.001.001.10 — a post-2019 refinement. Element structure, version notes, and lossless migration.

1 min read Last reviewed

pain.001.001.10 carries the 2019 rework forward with incremental maintenance. Market infrastructures largely standardised on version 9, so version 10 is generated mainly where a specific platform or bank profile requests it.

What to know about this version#

  • Same modern element names (, structured addresses) as version 9.
  • Version switches within the post-2019 family are low-risk parameter changes.

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.10 -o work/         # scaffold a starter CSV
pain001 inspect pain.001.001.10               # list required + optional fields
pain001 -t pain.001.001.10 -d payments.csv -o out/ --dry-run

Records migrate losslessly between supported versions:

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

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