Resource center · Structured Data & Messaging

ISO 20022 migration: what changes in a payment message.

The migration is usually described as a format change. It is a data change wearing a format change’s clothing, and the parts that break are the ones where legacy free text carried meaning nobody wrote down.

Guide ISO 20022 · Multi-jurisdiction · payment messaging

What the standard actually is

ISO 20022 is a standard for financial messaging. It provides a shared data dictionary and a method for defining messages, and market infrastructures, schemes and communities then publish their own usage guidelines that constrain it. That layering matters more than anything else in a migration: the standard says what may be sent, and the scheme says what must be, so a message can be valid against the standard and rejected by the scheme.

The standard itself imposes no obligation on anyone. What obliges a firm is a scheme rulebook, a market infrastructure mandate or a counterparty requirement. Establish which of those applies before scoping anything, because each has its own variant, its own timetable and its own validation.

Structured data replaces free text

Legacy payment formats carried a great deal of meaning in fixed-length free-text lines. Operations teams learned local conventions for what went where, and those conventions were rarely documented. The new messages replace most of that with named, typed elements.

The migration difficulty follows directly. Populating a structured element requires knowing which piece of the old free text meant what — and for a long tail of payments, nobody does. Discovering that is the first substantive workstream, and it is an analysis task rather than an engineering one.

Do the archaeology before the mapping. Sample real historic messages across corridors and payment types, and classify what the free-text fields actually contained. Teams that map from the specification alone find the exceptions in production.

Parties and addresses

Parties — debtor, creditor, their agents, ultimate parties and any intermediaries — each have their own structured blocks, with identification separated from name and address. Addresses move from unstructured lines to named components: street, building, postcode, town, country subdivision, country.

Two consequences recur. Existing customer records frequently cannot be decomposed into structured components reliably, particularly where they were captured as a single block. And schemes increasingly expect structured or hybrid addresses rather than unstructured ones, so the decomposition is not optional indefinitely. This is customer data remediation, and it belongs on the critical path rather than in the backlog.

Remittance information

Remittance information can be structured — referenced documents, amounts, creditor reference — or unstructured, and the value of the migration to a corporate is almost entirely in the structured form, because it is what allows automatic reconciliation of a receipt against an invoice.

The trap is that structured remittance is optional under the standard and constrained differently by each scheme. A migration that maps everything into the unstructured element passes validation, satisfies the mandate, and delivers none of the benefit that justified the programme.

References that must survive

  • End-to-end identifier — assigned by the originating party and intended to travel unchanged the whole way to the account statement.
  • Transaction identifier — assigned by the sending institution for the interbank leg.
  • Message identifier — identifies the message itself rather than the payment.
  • Unique end-to-end reference — used in cross-border messaging to track a payment across institutions.

Each has to survive every internal system boundary and every format transformation. The commonest defect in a migration is a reference regenerated at an internal hop, which silently breaks the tracking the standard exists to provide. Test this explicitly, end to end, rather than assuming it.

Coexistence and truncation

Migrations run with legacy and new formats in parallel, which means messages are translated between them. Translation from a richer format to a poorer one truncates: a structured address becomes lines, extended remittance data is dropped, and characters outside the legacy set are substituted. Translation back does not restore what was lost.

Three rules keep this survivable. Know which of your flows are translated and which are native, because the risk lives entirely in the first group. Never treat a round trip as lossless. And log what was truncated, so a payment investigation can reconstruct what the originator actually sent.

Official sources

Primary instruments only. Each is named in full so the reference remains traceable even if a link moves.

  1. ISO 20022 — the standard, its message definitions and the published usage guidelines maintained by the registration authorityISO · the message definitions themselves · consult the version your scheme mandates
  2. Regulation (EU) No 260/2012 establishing technical and business requirements for credit transfers and direct debits in euroEUR-Lex · Regulation · the requirement to use the standard for euro credit transfers and direct debits
  3. The applicable scheme rulebook and its implementation guidelinesScheme · the binding constraint on message content · differs per scheme and per corridor

REGREP is an independent software provider. This record explains a reporting framework in plain language and is not legal, tax or regulatory advice. Confirm scope, thresholds and submission dates with your competent authority before you file.

Keep reading

More on this framework, and the module that produces the filing.

All structured data & messaging resources

The mapping is the project.

Tell us which schemes you send to and which flows are translated, and we will scope the migration around the parts that actually break.