Payments Training Hub
FieldMeaningRequired
Remittance informationInformation that explains what a payment is for, such as invoice numbers, contract references or salary month.
Charge bearerA code that states who pays the charges for a payment. In ISO 20022 the values are DEBT for debtor, CRED for creditor, SHAR for shared and SLEV for service level.
Purpose codeA code that states the commercial reason for a payment, such as supplier payment, salary or goods. Purpose codes are taken from an ISO external code list and support regulatory reporting, screening...
0:00 / 4:35 Step 1 of 6

Mapping types, direct, split, derived and needs care

MT to MX Migration and CBPR+, Lesson 3 of 7, Narration 4:35, D04 Messaging and standards

Remittance informationCharge bearerPurpose code

What you will learn

Your objective. By the end of this lesson, you will be able to explain mapping types, direct, split, derived and needs care. SWIFT defines several mapping types to describe how MT and MX fields relate to each other, and understanding those types helps an analyst assess the risk of a given translation.

Why it matters. SWIFT defines several mapping types to describe how MT and MX fields relate to each other, and understanding those types helps an analyst assess the risk of a given translation.

Chapter objective: Learner plans an MT to MX migration, explains CBPR+ scope and timelines, and maps MT103, MT202, and MT202COV to pacs.008, pacs.009, and pacs.009 COV equivalents with data gaps noted. Learner demonstrates this skill using realistic banking examples, explaining each step clearly and using correct terminology throughout.

Key learning points

  • SWIFT defines several mapping types
  • Derived mapping
  • Analyst should be able
  • Currency code maps directly
  • Derived mappings
  • Mapping field 72 sender to receiver information

Key terms

Remittance information: Information that explains what a payment is for, such as invoice numbers, contract references or salary month.

Charge bearer: A code that states who pays the charges for a payment. In ISO 20022 the values are DEBT for debtor, CRED for creditor, SHAR for shared and SLEV for service level.

Purpose code: A code that states the commercial reason for a payment, such as supplier payment, salary or goods. Purpose codes are taken from an ISO external code list and support regulatory reporting, screening...

Data mapping view showing Mapping types, direct, split, derived and needs care.

Practise this lesson

Exercise

Find the field field 32A in the message described in this lesson and explain what it controls.

Use the field description and the example in this lesson.

  1. What to do. Write down what field 32A carries, what happens if it is wrong, and which system reads it.

Correct result. field 32A carries the value the lesson describes. If it is wrong, the payment is rejected, returned, or misrouted, and the exception must be investigated before the payment can proceed.

Why. Fields are the contract between systems. A wrong field is not a typo, it is a failed payment.

Check your understanding

Practice question

A tester claims the MT family has disappeared entirely and removes all MT statement checks from the test pack. Why is that wrong?

Takeaway and next step

What to remember

For each needs care mapping, the analyst should record the business decision, the fallback behaviour, and the manual review path, so that operations knows what to do when the mapping cannot be completed automatically.

Open the message type from this lesson and inspect its fields, then find the field that carries the amount.

Open the ISO 20022 Message Explorer →

Builds on "Translation rules, how MT becomes MX and back".

Transcript and full text

Show transcript

SWIFT defines several mapping types to describe how MT and MX fields relate to each other, and understanding those types helps an analyst assess the risk of a given translation. A direct mapping is one where a single MT field maps to a single MX element with no loss of data and no change in meaning, for example the amount in field 32A mapping to the Instructed Amount. Direct mappings are low risk, and they can be tested with simple cases. A split mapping is one where a single MT field is split across multiple MX elements, or where a single MX element is split across multiple MT fields. For example, an MT address field with four lines may be split into street name, town, and country elements in MX. Split mappings are medium risk, because the splitting logic must be correct. A derived mapping is one where the MX element is not directly present in the MT message, but can be derived from other data in the message or from reference data. For example, a purpose code in MX may be derived from the remittance information or from the customer type in MT, even though MT does not have a dedicated purpose code field. Derived mappings are higher risk, because the derivation logic may be wrong or may not apply to all cases. A needs care mapping is one where the mapping is complex, ambiguous, or lossy, and where manual review or additional data is needed. For example, mapping a free text field 70 in MT to structured remittance information in MX is a needs care mapping, because the free text may contain invoice numbers, dates, and other data in an unstructured form that cannot be parsed reliably. An analyst should be able to classify each mapping in a migration project by its type, and to prioritise testing and review accordingly. Direct mappings need basic testing, split mappings need testing with varied data, derived mappings need testing with edge cases, and needs care mappings need manual review and possibly a business decision about how to handle the data. A mapping document that lists every field, its type, its rule, and its test cases is a core deliverable of any migration project, and it is the document that operations teams will use when a translated payment fails. Direct mappings are the easy cases, and there are more of them than people expect. The amount in field 32A maps directly to the instructed amount in a pacs.008, with no loss and no change in meaning. The currency code maps directly to the currency element. Field 20 maps directly to the instruction identification. The value date maps directly to the interbank settlement date. Direct mappings are low risk, and they can be tested with simple cases, because the rule is one field to one element with the same value. Split mappings need more care, because one field becomes several elements or several fields become one element. An MT address in field 50K, with four lines of free text, splits into street name, building number, town name, postcode, and country in the structured postal address of a pacs.008. An MT field 70 with several invoice references splits into unstructured remittance information plus structured references. Going the other way, several MX elements combine into one MT field, which is where truncation happens. Derived mappings are higher risk, because the MX element does not exist in the MT message at all. A purpose code in a pacs.008 may be derived from the remittance information or from the customer type in the MT103, even though MT has no purpose code field. A charge bearer code may be derived from field 71A. A local instrument code may be derived from service level information. The derivation logic is a business rule, not a copy, and it can be wrong for edge cases. Needs care mappings are the ones where the translation is complex, ambiguous, or lossy, and where manual review may be needed. Mapping free text field 70 to structured remittance information is a needs care mapping, because the free text may contain invoice numbers, dates, and notes in an order that cannot be parsed reliably. Mapping field 72 sender to receiver information is needs care, because it often carries bank specific codes that have no MX equivalent. Mapping field 77B regulatory reporting is needs care for the same reason. For each needs care mapping, the analyst should record the business decision, the fallback behaviour, and the manual review path, so that operations knows what to do when the mapping cannot be completed automatically.

SWIFT defines several mapping types to describe how MT and MX fields relate to each other, and understanding those types helps an analyst assess the risk of a given translation. A direct mapping is one where a single MT field maps to a single MX element with no loss of data and no change in meaning, for example the amount in field 32A mapping to the Instructed Amount. Direct mappings are low risk, and they can be tested with simple cases. A split mapping is one where a single MT field is split across multiple MX elements, or where a single MX element is split across multiple MT fields. For example, an MT address field with four lines may be split into street name, town, and country elements in MX. Split mappings are medium risk, because the splitting logic must be correct.

A derived mapping is one where the MX element is not directly present in the MT message, but can be derived from other data in the message or from reference data. For example, a purpose code in MX may be derived from the remittance information or from the customer type in MT, even though MT does not have a dedicated purpose code field. Derived mappings are higher risk, because the derivation logic may be wrong or may not apply to all cases. A needs care mapping is one where the mapping is complex, ambiguous, or lossy, and where manual review or additional data is needed. For example, mapping a free text field 70 in MT to structured remittance information in MX is a needs care mapping, because the free text may contain invoice numbers, dates, and other data in an unstructured form that cannot be parsed reliably.

An analyst should be able to classify each mapping in a migration project by its type, and to prioritise testing and review accordingly. Direct mappings need basic testing, split mappings need testing with varied data, derived mappings need testing with edge cases, and needs care mappings need manual review and possibly a business decision about how to handle the data. A mapping document that lists every field, its type, its rule, and its test cases is a core deliverable of any migration project, and it is the document that operations teams will use when a translated payment fails.

Direct mappings are the easy cases, and there are more of them than people expect. The amount in field 32A maps directly to the instructed amount in a pacs.008, with no loss and no change in meaning. The currency code maps directly to the currency element. Field 20 maps directly to the instruction identification. The value date maps directly to the interbank settlement date. Direct mappings are low risk, and they can be tested with simple cases, because the rule is one field to one element with the same value.

Split mappings need more care, because one field becomes several elements or several fields become one element. An MT address in field 50K, with four lines of free text, splits into street name, building number, town name, postcode, and country in the structured postal address of a pacs.008. An MT field 70 with several invoice references splits into unstructured remittance information plus structured references. Going the other way, several MX elements combine into one MT field, which is where truncation happens.

Derived mappings are higher risk, because the MX element does not exist in the MT message at all. A purpose code in a pacs.008 may be derived from the remittance information or from the customer type in the MT103, even though MT has no purpose code field. A charge bearer code may be derived from field 71A. A local instrument code may be derived from service level information. The derivation logic is a business rule, not a copy, and it can be wrong for edge cases.

Needs care mappings are the ones where the translation is complex, ambiguous, or lossy, and where manual review may be needed. Mapping free text field 70 to structured remittance information is a needs care mapping, because the free text may contain invoice numbers, dates, and notes in an order that cannot be parsed reliably. Mapping field 72 sender to receiver information is needs care, because it often carries bank specific codes that have no MX equivalent. Mapping field 77B regulatory reporting is needs care for the same reason. For each needs care mapping, the analyst should record the business decision, the fallback behaviour, and the manual review path, so that operations knows what to do when the mapping cannot be completed automatically.

Full lesson text (all scenes)

Completing a lesson updates your progress dashboard on the homepage.

Scene timestamps are estimated by allocating the narration text proportionally across the real audio length. The audio playback position is the source of truth: pause freezes the visual, seeking restores the correct scene, replay restarts the scene animation.