Guide · Ctry

Ctry ISO 20022: the country-code issue that blocks files fast

In payment addresses, country data looks simple. It is still a common issue: writing France, FRA or Germany where the file expects a two-letter country code.

What the field expects

In an ISO 20022 postal address block, Ctry must contain an ISO 3166-1 alpha-2 country code. This format uses two letters: FR, DE, CH, GB, ES, IT or NL for example.

A country name may be readable for humans, but it does not replace the code expected by the payment message.

Common issues

Files often contain country names, three-letter codes, multilingual labels or values mixed with town data.

These issues are easy to underestimate because they look minor in a spreadsheet. In a bank file, they can make a row unusable.

The useful check

An effective check does not only look for empty cells. It also spots countries in the wrong format and values that combine several pieces of information.

This is a strong first filter because it quickly reveals where source data needs cleanup before the deadline.

Ctry checklist

  1. 1Check that every country is two letters.
  2. 2Replace labels such as France or Germany with the expected code.
  3. 3Remove three-letter codes such as FRA or DEU.
  4. 4Separate country from town or full-address columns.
  5. 5Review unknown values before submission.

FAQ

GB or UK for the United Kingdom?

The expected format is an ISO 3166-1 alpha-2 code. In that standard, the United Kingdom code is GB.

Is country mandatory?

When an address is transmitted in the relevant flows, country is one of the critical elements to provide correctly.

Check country values before fixing the whole file

Struct20022 spots risky rows and helps finance teams prioritize useful corrections.