Payments Training Hub
FieldMeaningRequired
Sanctions screeningChecking payment parties, countries and references against sanctions lists published by governments and international bodies.
ReconciliationThe process of comparing records from two sources, such as a bank statement and an internal ledger, to confirm they agree.
SettlementThe final movement of funds between banks to discharge obligations created by cleared payments. Settlement is usually made in central bank money or through correspondent accounts.
0:00 / 3:20 Step 1 of 6

Why Banks Need a Canonical Payment Model

Payment Data Model and Mapping, Lesson 1 of 7, Narration 3:20, D09 Payment architecture and technology

Sanctions screeningReconciliationSettlement

What you will learn

Your objective. By the end of this lesson, you will be able to explain banks need a canonical payment model. A large bank receives payment instructions from many different places, and each place speaks its own dialect.

Why it matters. When each channel connects directly to each payment system, the bank must build and maintain a separate translation for every pair, and a small change in one system can break several others without warning.

Chapter objective: Learner designs a payment data model, including parties, accounts, instructions, transactions, and statuses, and maps fields between a core banking system and ISO 20022 messages. Learner demonstrates this skill using realistic banking examples, explaining each step clearly and using correct terminology throughout.

Key learning points

  • Large bank receives payment instructions
  • Concrete example
  • Work grows quickly
  • Canonical model
  • Single view
  • Canonical model removes these surprises

Key terms

Sanctions screening: Checking payment parties, countries and references against sanctions lists published by governments and international bodies.

Reconciliation: The process of comparing records from two sources, such as a bank statement and an internal ledger, to confirm they agree.

Settlement: The final movement of funds between banks to discharge obligations created by cleared payments. Settlement is usually made in central bank money or through correspondent accounts.

Data mapping view showing Why Banks Need a Canonical Payment Model.

Insights and practice scenarios

Worked insights and practice scenarios for this lesson. Each one is a reusable PaymentForge case, so the same case may appear in more than one lesson.

Practise this lesson

Exercise

Work out what the beneficiary receives for a EUR 250,000 payment under OUR, SHA and BEN.

Use the charge arrangement rules in this lesson and the correspondent and beneficiary bank fees named in the lesson.

  1. What to do. Calculate the amount credited under each of the three arrangements and state who pays each fee.

Correct result. Under OUR the sender pays all charges and the beneficiary receives the full amount. Under SHA the sender pays the sending charges and the beneficiary pays the receiving charges. Under BEN the beneficiary pays all charges and receives the amount less all fees.

Why. The charge arrangement decides who pays and how much arrives. A customer who was promised the full amount and receives less will complain, and the complaint lands on the analyst.

Check your understanding

Practice question

Why does a payment data model need a single canonical payment record?

Takeaway and next step

What to remember

The canonical model removes these surprises by fixing the meaning of each field once, for the whole bank.

Send a payment through the hub and watch it pass each component named in this lesson.

Open the Payment Hub Architecture Simulator →

Builds on "More Banks and What to Learn from Them".

Transcript and full text

Show transcript

A large bank receives payment instructions from many different places, and each place speaks its own dialect. Mobile banking sends a compact JSON message, internet banking sends a web form, a branch system sends a legacy screen record, and a corporate customer sends a bulk file with thousands of rows. One channel may call the sender the debtor, another may call the same person the remitter, and a third may store the name in three separate fields. When each channel connects directly to each payment system, the bank must build and maintain a separate translation for every pair, and a small change in one system can break several others without warning. Consider a concrete example that shows the scale of the problem. A bank has six channels and five payment systems, including SWIFT, the local clearing house, an instant payment system, an internal book transfer engine, and a cross border correspondent service. With direct point to point links, that bank needs thirty separate mappings, and each mapping must handle names, addresses, accounts, amounts, currencies, dates, charges, and references. If the bank adds one new channel, it must build five new mappings. If it adds one new payment system, it must build six more. The work grows quickly, testing becomes expensive, and defects hide in the least used combinations. A canonical payment model breaks this growth by giving the bank one shared language for every payment. Every channel translates its own instruction once into the canonical model, and every payment system translates once from the canonical model into its own format. With six channels and five systems, the bank now needs eleven mappings instead of thirty. A change to the mobile app affects only its own mapping, and a change to the SWIFT format affects only the SWIFT mapping. The canonical model becomes the single place where the bank defines what a payment is, what fields it must carry, and what rules apply before it can move. The canonical model also makes control and compliance far easier to manage. Sanctions screening, fraud checks, anti money laundering monitoring, liquidity checks, and limit checks can all run once against the canonical record, instead of being rebuilt inside every channel and every payment system. When a regulator asks how a payment of EUR 250,000 from a customer in London to a supplier in Singapore was processed, the bank can show one record with one set of decisions, one audit trail, and one final outcome. That single view is difficult to produce when the same payment exists in five different shapes across five different systems. Without a canonical model, everyday failures become common and expensive. A payment may be duplicated because two channels used different reference numbers for the same instruction. A name may be truncated in one system and rejected in another because address formats did not match. A charge may be applied twice because each system calculated fees from its own copy of the amount. A reconciliation team may spend hours matching a settlement of USD 48,200.50 against a customer instruction for USD 48,200.00 because rounding rules differed. The canonical model removes these surprises by fixing the meaning of each field once, for the whole bank.

A large bank receives payment instructions from many different places, and each place speaks its own dialect. Mobile banking sends a compact JSON message, internet banking sends a web form, a branch system sends a legacy screen record, and a corporate customer sends a bulk file with thousands of rows. One channel may call the sender the debtor, another may call the same person the remitter, and a third may store the name in three separate fields. When each channel connects directly to each payment system, the bank must build and maintain a separate translation for every pair, and a small change in one system can break several others without warning.

Consider a concrete example that shows the scale of the problem. A bank has six channels and five payment systems, including SWIFT, the local clearing house, an instant payment system, an internal book transfer engine, and a cross border correspondent service. With direct point to point links, that bank needs thirty separate mappings, and each mapping must handle names, addresses, accounts, amounts, currencies, dates, charges, and references. If the bank adds one new channel, it must build five new mappings. If it adds one new payment system, it must build six more. The work grows quickly, testing becomes expensive, and defects hide in the least used combinations.

A canonical payment model breaks this growth by giving the bank one shared language for every payment. Every channel translates its own instruction once into the canonical model, and every payment system translates once from the canonical model into its own format. With six channels and five systems, the bank now needs eleven mappings instead of thirty. A change to the mobile app affects only its own mapping, and a change to the SWIFT format affects only the SWIFT mapping. The canonical model becomes the single place where the bank defines what a payment is, what fields it must carry, and what rules apply before it can move.

The canonical model also makes control and compliance far easier to manage. Sanctions screening, fraud checks, anti money laundering monitoring, liquidity checks, and limit checks can all run once against the canonical record, instead of being rebuilt inside every channel and every payment system. When a regulator asks how a payment of EUR 250,000 from a customer in London to a supplier in Singapore was processed, the bank can show one record with one set of decisions, one audit trail, and one final outcome. That single view is difficult to produce when the same payment exists in five different shapes across five different systems.

Without a canonical model, everyday failures become common and expensive. A payment may be duplicated because two channels used different reference numbers for the same instruction. A name may be truncated in one system and rejected in another because address formats did not match. A charge may be applied twice because each system calculated fees from its own copy of the amount. A reconciliation team may spend hours matching a settlement of USD 48,200.50 against a customer instruction for USD 48,200.00 because rounding rules differed. The canonical model removes these surprises by fixing the meaning of each field once, for the whole bank.

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.