| Field | Meaning | Required |
|---|---|---|
GrpHdr | The header holding message identification, creation date and time, number of transactions and control sum. It identifies the message for tracking and duplicate | M |
PmtId | The identification block with instruction identification, end to end identification and transaction identification. End to end identification links this advice | M |
IntrBkSttlmAmt | The amount and currency that will be settled between the debtor agent and the creditor agent, for example USD 367,574.90. The receiving bank uses it to expect t | M |
IntrBkSttlmDt | The date on which interbank settlement is expected to occur. It drives liquidity planning and value dating of the related customer payment. The date must be a b | O |
SttlmInf | How settlement will occur, including settlement method and settlement account. ADV means an advice of a payment and tells the receiver that funds will follow th | M |
DbtrAgt | The bank sending the advice and debiting its account when the funds move. It is identified by BIC. The debtor agent is responsible for funding the payment, choo | M |
CdtrAgt | The bank receiving the advice and expecting the funds. It is identified by BIC. The creditor agent checks the advice against its expected receipts, screens the | M |
Dbtr | The customer who ordered the underlying payment, carried in the advice so the receiver can screen it. It gives the name and address of the originator. The recei | M |
Cdtr | The final beneficiary of the underlying customer payment, carried in the advice so the receiver can screen it. It gives the name and address of the recipient. T | M |
CdtrAcct | The account of the creditor to be credited when the funds arrive, identified by IBAN or other account identification. It tells the creditor agent exactly where | O |
RltdPmtInf | Information about a related payment, most often the customer credit transfer that this advice refers to. It can hold the related message identification and amou | O |
RmtInf | Structured or unstructured information explaining what the underlying payment is for, such as invoice numbers. It is carried in the advice so the beneficiary ba | O |
BNP Paribas Paris sends a pacs.009 ADV for USD 367,574.90 value 6 November 2026 to Banco Santander Madrid, advising that settlement funds for a customer payment from a Paris corporate to a Madrid supplier will arrive that day. Santander screens the debtor and creditor, checks the beneficiary account, and prepares the credit for release on receipt of funds.
Valid example from the message catalogue. Scheme rules: pacs.009 ADV follows the CBPR+ advice rules, which require full debtor and creditor data so the receiving bank can screen before funds arrive. It is distinct from Core, which settles funds, and from C
UETR: the unique tracking reference
What you will learn
Your objective. By the end of this lesson, you will be able to explain UETR: the unique tracking reference. The Unique End to end Transaction Reference, known as the UETR, is the identifier that makes gpi tracking possible, and every analyst who works on cross border payments must understand it.
Why it matters. The Unique End to end Transaction Reference, known as the UETR, is the identifier that makes gpi tracking possible, and every analyst who works on cross border payments must understand it.
Chapter objective: Learner calculates payment charges under BEN, OUR, and SHA, explains foreign exchange conversion and spread, and traces a payment using gpi status updates from initiation to credit. Learner practises this skill on realistic banking cases, explaining the reasoning clearly and using correct terminology throughout the work.
Key learning points
- Unique End to end Transaction Reference
- UETR stays with the payment
- Customer asks where their
- Business analyst must ensure
- Payment: lookup
Key terms
Cover payment: A payment method where the customer instruction travels one route while the funds travel separately as a bank to bank cover message.
ISO 20022: An international standard for financial messaging that defines XML message formats for payments, securities and trade.
pacs.009: An ISO 20022 message for a financial institution to financial institution credit transfer with no customer beneficiary.
ISO 20022 XML explorer showing UETR: the unique tracking reference.
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
Route the payment described in this lesson and justify the route.
Use the routing rules, the correspondent chain and the charges in this lesson.
- What to do. Name each bank in the chain, the message used on each leg, and the charges deducted at each step.
Correct result. The route follows the correspondent chain from the debtor agent to the creditor agent, with each intermediary deducting its charge and passing the remainder on. The message on each leg carries the information the next bank needs.
Why. Routing is a business decision with a cost. The wrong route is slower, more expensive, or fails.
Check your understanding
Practice question
Which of the following best describes UETR: the unique tracking reference?
Takeaway and next step
What to remember
Unlike the sender's own reference, which can change as the payment passes through different systems, the UETR is never changed, and every bank must carry it forward.
Build a cross-border payment like the one in this lesson and watch the chain, the charges, and the final amount change.
Open the Cross-Border Payment Configurator →
Builds on "SWIFT gpi: what it is and how it changed tracking".
Transcript and full text
Show transcript
The Unique End to end Transaction Reference, known as the UETR, is the identifier that makes gpi tracking possible, and every analyst who works on cross border payments must understand it. The UETR is a thirty six character string in the format of a universally unique identifier, for example a string of letters and numbers separated by hyphens, and it is generated by the sending bank when the payment is created. The UETR stays with the payment through every bank in the chain, through every conversion, and through every return or recall, so that the payment can be identified at any point by a single reference. Unlike the sender's own reference, which can change as the payment passes through different systems, the UETR is never changed, and every bank must carry it forward. The UETR is carried in the SWIFT message, in the ISO 20022 pacs.008 message, and in the gpi tracker, so that all three views of the payment can be linked together. In the MT world, the UETR is carried in field 121 of the MT103, in the user header block. In ISO 20022, the UETR is carried in the UETR element of the pacs.008, in the pacs.002 status report, in the pacs.004 return, and in the pacs.009 COV for cover payments. When a customer asks where their payment is, the operations team searches the tracker by UETR and sees the full journey. When a bank needs to investigate a payment, it quotes the UETR, and every other bank can find the same payment in its own system. When a payment is returned, the return message carries the same UETR, so that the return can be matched to the original payment without ambiguity. The UETR is also used in the cover payment, where the pacs.009 COV carries the UETR of the customer payment it covers, so that the funds leg and the instruction leg can be matched. A business analyst must ensure that the system generates a UETR for every cross border payment, stores it, shows it to the customer, and includes it in every message and every report. The UETR must be generated as a version 4 universally unique identifier, using a random number generator, and it must be unique across all payments, because a duplicate UETR would cause two payments to be confused. The UETR is a simple idea with a large impact, because it solves the oldest problem in cross border payments. The payment changes its identity as it moves. Before the UETR, a payment could have one reference at the sending bank, a different reference at the intermediary bank, and a third reference at the receiving bank, and tracing it meant matching amounts and dates by hand. With the UETR, the payment has one identity from start to finish, and tracing it is a lookup, not a detective exercise. The analyst should treat the UETR as a first class field in the data model, not as an optional extra, and should test that it survives every transformation in the payment flow, including currency conversion, charge deduction, and repair. If a payment is repaired, for example because the beneficiary name was corrected, the UETR must not change, because the repaired payment is the same payment. If a payment is split into two payments, for example because of a limit, each part must get its own UETR, because they are now two payments. If a payment is returned and resent, the resent payment must get a new UETR, because it is a new payment, but the return must carry the original UETR so that it can be matched. If a cover payment is generated, it must carry the UETR of the customer payment it covers, not a new UETR. Each of these rules must be specified and tested, because a system that gets the UETR wrong will produce payments that cannot be traced, and a payment that cannot be traced is a payment that cannot be supported. The payment record must store the UETR, the sender's reference, the end to end reference, and the transaction reference, and must link them together. The UETR must be indexed so that a lookup by UETR is fast, even when the database holds millions of payments. The UETR must be shown on the customer portal, on the receipt, and in the operations screens, so that the customer and the operations team are using the same reference. The UETR must be included in the audit trail, so that every action on the payment can be traced back to the same identifier. And the UETR must be carried in every message, including the pacs.002 status report, the pacs.004 return, and the camt.056 recall, so that the exception messages can be matched to the original payment. The analyst should also know that the UETR is mandatory for gpi payments, and that SWIFT will reject a gpi payment that does not carry a UETR. For non gpi payments, the UETR is strongly recommended, and most banks now generate it for all cross border payments, because it costs nothing and it makes every payment traceable. The CBPR+ migration to ISO 20022 made the UETR a standard element of the pacs.008, and the market practice is to generate it for every payment, not just for gpi. The analyst who is designing a new payment product should specify that a UETR is generated for every cross border payment, without exception, and should test that it is present in every message the system generates. Finally, the UETR is the key to the customer experience. A customer who is given a UETR can track their payment on the bank's portal, can quote it when they call the bank, and can give it to the beneficiary so that the beneficiary can ask their own bank about the same payment. A customer who is not given a UETR must rely on the bank's internal reference, which the beneficiary's bank cannot use. The analyst should therefore ensure that the UETR is shown to the customer at the point of instruction, on the confirmation screen, and on the receipt, and that the portal allows the customer to search by UETR. That is a small design decision with a large impact on customer satisfaction.
The Unique End to end Transaction Reference, known as the UETR, is the identifier that makes gpi tracking possible, and every analyst who works on cross border payments must understand it. The UETR is a thirty six character string in the format of a universally unique identifier, for example a string of letters and numbers separated by hyphens, and it is generated by the sending bank when the payment is created. The UETR stays with the payment through every bank in the chain, through every conversion, and through every return or recall, so that the payment can be identified at any point by a single reference. Unlike the sender's own reference, which can change as the payment passes through different systems, the UETR is never changed, and every bank must carry it forward.
The UETR is carried in the SWIFT message, in the ISO 20022 pacs.008 message, and in the gpi tracker, so that all three views of the payment can be linked together. In the MT world, the UETR is carried in field 121 of the MT103, in the user header block. In ISO 20022, the UETR is carried in the UETR element of the pacs.008, in the pacs.002 status report, in the pacs.004 return, and in the pacs.009 COV for cover payments. When a customer asks where their payment is, the operations team searches the tracker by UETR and sees the full journey. When a bank needs to investigate a payment, it quotes the UETR, and every other bank can find the same payment in its own system.
When a payment is returned, the return message carries the same UETR, so that the return can be matched to the original payment without ambiguity. The UETR is also used in the cover payment, where the pacs.009 COV carries the UETR of the customer payment it covers, so that the funds leg and the instruction leg can be matched. A business analyst must ensure that the system generates a UETR for every cross border payment, stores it, shows it to the customer, and includes it in every message and every report. The UETR must be generated as a version 4 universally unique identifier, using a random number generator, and it must be unique across all payments, because a duplicate UETR would cause two payments to be confused.
The UETR is a simple idea with a large impact, because it solves the oldest problem in cross border payments. The payment changes its identity as it moves. Before the UETR, a payment could have one reference at the sending bank, a different reference at the intermediary bank, and a third reference at the receiving bank, and tracing it meant matching amounts and dates by hand. With the UETR, the payment has one identity from start to finish, and tracing it is a lookup, not a detective exercise. The analyst should treat the UETR as a first class field in the data model, not as an optional extra, and should test that it survives every transformation in the payment flow, including currency conversion, charge deduction, and repair.
If a payment is repaired, for example because the beneficiary name was corrected, the UETR must not change, because the repaired payment is the same payment. If a payment is split into two payments, for example because of a limit, each part must get its own UETR, because they are now two payments. If a payment is returned and resent, the resent payment must get a new UETR, because it is a new payment, but the return must carry the original UETR so that it can be matched. If a cover payment is generated, it must carry the UETR of the customer payment it covers, not a new UETR. Each of these rules must be specified and tested, because a system that gets the UETR wrong will produce payments that cannot be traced, and a payment that cannot be traced is a payment that cannot be supported.
The payment record must store the UETR, the sender's reference, the end to end reference, and the transaction reference, and must link them together. The UETR must be indexed so that a lookup by UETR is fast, even when the database holds millions of payments. The UETR must be shown on the customer portal, on the receipt, and in the operations screens, so that the customer and the operations team are using the same reference. The UETR must be included in the audit trail, so that every action on the payment can be traced back to the same identifier. And the UETR must be carried in every message, including the pacs.002 status report, the pacs.004 return, and the camt.056 recall, so that the exception messages can be matched to the original payment.
The analyst should also know that the UETR is mandatory for gpi payments, and that SWIFT will reject a gpi payment that does not carry a UETR. For non gpi payments, the UETR is strongly recommended, and most banks now generate it for all cross border payments, because it costs nothing and it makes every payment traceable. The CBPR+ migration to ISO 20022 made the UETR a standard element of the pacs.008, and the market practice is to generate it for every payment, not just for gpi. The analyst who is designing a new payment product should specify that a UETR is generated for every cross border payment, without exception, and should test that it is present in every message the system generates.
Finally, the UETR is the key to the customer experience. A customer who is given a UETR can track their payment on the bank's portal, can quote it when they call the bank, and can give it to the beneficiary so that the beneficiary can ask their own bank about the same payment. A customer who is not given a UETR must rely on the bank's internal reference, which the beneficiary's bank cannot use. The analyst should therefore ensure that the UETR is shown to the customer at the point of instruction, on the confirmation screen, and on the receipt, and that the portal allows the customer to search by UETR. That is a small design decision with a large impact on customer satisfaction.
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.