Payments Training Hub
BAHDocumentFIToFICstmrCdtTrfGrpHdrPmtInfCdtTrfTxInfpacs.008 message structureBAHDocumentFIToFICstmrCdtTrfGrpHdrPmtInfCdtTrfTxInf
<?xml version="1.0" encoding="UTF-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:pacs.008.001.08">
  <FIToFICstmrCdtTrf>
    <GrpHdr>
      <MsgId>ACME2026110501</MsgId>
      <CreDtTm>2026-11-05T09:00:00</CreDtTm>
      <NbOfTxs>1</NbOfTxs>
      <CtrlSum>10000</CtrlSum>
      <InitgPty><Nm>Acme Trading Ltd</Nm></InitgPty>
    </GrpHdr>
    <PmtInf>
      <PmtInfId>PmtInf001</PmtInfId>
      <PmtMtd>TRF</PmtMtd>
      <ReqdExctnDt>2026-11-05</ReqdExctnDt>
      <ChrgBr>SHAR</ChrgBr>
      <Dbtr>
        <Nm>Acme Trading Ltd</Nm>
        <PstlAdr><TwnNm>London</TwnNm></PstlAdr>
      </Dbtr>
      <DbtrAcct><Id><Othr><Id>London current account</Id></Othr></Id></DbtrAcct>
      <DbtrAgt><FinInstnId><Nm>London bank</Nm></FinInstnId></DbtrAgt>
      <CdtTrfTxInf>
        <PmtId><InstrId>Instr001</InstrId><EndToEndId>INV4567</EndToEndId><UETR>a1b2c3d4-e5f6-4789-abcd-ef0123456789</UETR><TxId>TXN2026110501</TxId></PmtId>
        <InstdAmt Ccy="USD">10000</InstdAmt>
        <SttlmInf><SttlmMtd>INDA</SttlmMtd></SttlmInf>
        <CdtrAgt><FinInstnId><Nm>Singapore bank</Nm></FinInstnId></CdtrAgt>
        <Cdtr>
          <Nm>Meridian Supplies Pte Ltd</Nm>
          <PstlAdr><TwnNm>Singapore</TwnNm></PstlAdr>
        </Cdtr>
        <CdtrAcct><Id><Othr><Id>Singapore account</Id></Othr></Id></CdtrAcct>
        <Purp><Cd>SUPP</Cd></Purp>
        <RmtInf><Strd><CdtrRefInf><Ref>4567</Ref></CdtrRefInf></Strd></RmtInf>
      </CdtTrfTxInf>
    </PmtInf>
  </FIToFICstmrCdtTrf>
</Document>

Example: pacs.008.001.08 (explorer scheme_version). Versions listed in the explorer: pacs.008.001.06, pacs.008.001.08, pacs.008.001.09, pacs.008.001.10. Shortened for display from the chapter walkthrough: one PmtInf and one CdtTrfTxInf, Acme Trading Ltd pays Meridian Supplies Pte Ltd 10000 USD for invoice 4567. This is the base ISO 20022 structure. Scheme rules add to it: under CBPR+ the message must carry a UETR and fully structured debtor and creditor addresses, and under SEPA SCT the charge bearer must be SLEV only. The chapter example names the agents only as the London bank and the Singapore bank, so no BIC is shown. The UETR value shown is illustrative; the chapter names no UETR value.

0:00 / 2:02 Step 1 of 3

Key fields explained with examples

pacs.008 Deep Dive, Lesson 5 of 8, Narration 2:02, D04 Messaging and standards

Instructed AmountInterbank Settlement AmountUltimate Debtor

What you will learn

Your objective. By the end of this lesson, you will be able to explain key fields explained with examples and apply it to a real banking scenario.

Why it matters. An analyst should know which codes are used in the relevant usage guideline, and should ensure that test data covers each code that the product supports.

Chapter objective: After this lesson the learner can read a pacs.008 message block by block, explain each field in business terms, and spot the errors that get a message rejected.

Key learning points

  • The Debtor field
  • Example: Acme Trading Ltd
  • The Instructed Amount

Key terms

Instructed Amount: The amount the debtor instructs to be transferred, with its currency.

Interbank Settlement Amount: The amount actually settled between banks, which may differ from the instructed amount after charges or conversion.

Ultimate Debtor: The party on whose behalf the payment is made, when it differs from the debtor.

The Debtor and Creditor boxes are highlighted in the XML panel with the example names Acme Trading Ltd and Meridian Supplies Pte Ltd.

Practise this lesson

Exercise

Apply the concept in this lesson to a real banking scenario.

Use the definition, the example and the key points in this lesson.

  1. What to do. Explain the concept in your own words, give a banking example with an amount, and state what goes wrong if it is misunderstood.

Correct result. A correct answer names the concept accurately, uses a realistic banking example with a concrete amount, and identifies the consequence of getting it wrong.

Why. Understanding is not memorising a definition. It is being able to explain it, apply it, and spot the failure it prevents.

Check your understanding

Practice question

Which of the following best describes key fields explained with examples?

Takeaway and next step

What to remember

An analyst should know which codes are used in the relevant usage guideline, and should ensure that test data covers each code that the product supports.

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 "Credit Transfer Transaction, the single payment".

Transcript and full text

Show transcript

The Debtor field identifies the party who owes the money, and it contains the debtor name, postal address, and identification. For example, the debtor could be Acme Trading Ltd, with a structured address in London and a legal entity identifier. The Creditor field identifies the party who is owed the money, and it contains the same type of information for the supplier, for example Meridian Supplies Pte Ltd in Singapore. Both fields can also contain an Ultimate Debtor and an Ultimate Creditor, where the party on whose behalf the payment is made is different from the debtor or creditor. For example, a parent company may pay on behalf of a subsidiary, and the subsidiary is then the ultimate debtor. The Instructed Amount is the amount the debtor instructs to be transferred, with its currency, for example 10000 US dollars. The Interbank Settlement Amount is the amount that will actually be settled between banks, which may differ if charges are deducted or if a currency conversion occurs. The Charge Bearer, as already noted, determines who pays the charges. The Remittance Information can be unstructured, as free text such as Invoice 4567, or structured, as a set of elements that identify the invoice number, the invoice date, and the amount. Structured remittance information is preferred in ISO 20022 because it can be processed automatically by the creditor accounts payable system. Other key fields include the Payment Type Information, which contains the Service Level and the Category Purpose, the Purpose code, and the Regulatory Reporting details where required. The Service Level can indicate that the payment is urgent or that it should be processed under a specific scheme, such as SEPA. SWIFT gpi is a service and tracking initiative, not a scheme. The Category Purpose can indicate that the payment is for a salary, a pension, or a supplier payment. These codes help banks route the payment correctly and help regulators monitor payment flows. An analyst should know which codes are used in the relevant usage guideline, and should ensure that test data covers each code that the product supports. Take a worked example with real numbers. A pacs.008 for a SEPA supplier payment carries payment type information with service level SEPA, which means the payment follows the SEPA Credit Transfer scheme rulebook, and category purpose SUPP, which means it is a supplier payment. The purpose code is also SUPP, and the regulatory reporting field is empty, because no regulatory reporting is required for this payment. The remittance information is unstructured with the text Invoice INV-2026-1187, and the debtor has also provided a structured remittance with the invoice number, the invoice date and the amount, so the creditor can reconcile automatically. The service level, the category purpose and the purpose code together tell the clearing system, the creditor agent and the creditor exactly what kind of payment this is, and they drive the processing, the screening and the reconciliation. Failure and recovery: a service level code that the clearing system does not recognise is rejected with a pacs.002 and reason code AG01, and the sender must correct it and resend. A category purpose code that contradicts the purpose code, for example category purpose SALA for salary with purpose code SUPP for supplier payment, is flagged by the creditor agent and may be returned, because the inconsistency suggests the payment was built from the wrong template. A remittance information field longer than 140 characters is truncated or rejected, depending on the scheme, and the sender must shorten it. A regulatory reporting field that is mandatory for the corridor but left empty is rejected, and the sender must populate it. The recovery is to correct the field and resend with a new MsgId, because the payment has not yet been executed and no funds have moved. For a business analyst, product owner or subject matter expert, the test is to state, for every payment product, the service level, the category purpose, the purpose code and the remittance format, and to explain what each one drives. The service level selects the scheme and the processing rules. The category purpose selects the processing priority and the reporting category. The purpose code is used by the creditor for reconciliation and by the bank for screening and reporting. The remittance information must be in the format the creditor can reconcile, structured for automated matching and unstructured for human reading, and the requirement must state which one the product uses. Note that SWIFT gpi is a service and tracking initiative, not a scheme, so it is never named as a service level. Source: ISO 20022 pacs.008.001.08, Payment Type Information; EPC SCT Rulebook 2025. Last reviewed 7 November 2026.

The Debtor field identifies the party who owes the money, and it contains the debtor name, postal address, and identification. For example, the debtor could be Acme Trading Ltd, with a structured address in London and a legal entity identifier. The Creditor field identifies the party who is owed the money, and it contains the same type of information for the supplier, for example Meridian Supplies Pte Ltd in Singapore. Both fields can also contain an Ultimate Debtor and an Ultimate Creditor, where the party on whose behalf the payment is made is different from the debtor or creditor. For example, a parent company may pay on behalf of a subsidiary, and the subsidiary is then the ultimate debtor.

The Instructed Amount is the amount the debtor instructs to be transferred, with its currency, for example 10000 US dollars. The Interbank Settlement Amount is the amount that will actually be settled between banks, which may differ if charges are deducted or if a currency conversion occurs. The Charge Bearer, as already noted, determines who pays the charges. The Remittance Information can be unstructured, as free text such as Invoice 4567, or structured, as a set of elements that identify the invoice number, the invoice date, and the amount. Structured remittance information is preferred in ISO 20022 because it can be processed automatically by the creditor accounts payable system.

Other key fields include the Payment Type Information, which contains the Service Level and the Category Purpose, the Purpose code, and the Regulatory Reporting details where required. The Service Level can indicate that the payment is urgent or that it should be processed under a specific scheme, such as SEPA. SWIFT gpi is a service and tracking initiative, not a scheme. The Category Purpose can indicate that the payment is for a salary, a pension, or a supplier payment. These codes help banks route the payment correctly and help regulators monitor payment flows. An analyst should know which codes are used in the relevant usage guideline, and should ensure that test data covers each code that the product supports.

Take a worked example with real numbers. A pacs.008 for a SEPA supplier payment carries payment type information with service level SEPA, which means the payment follows the SEPA Credit Transfer scheme rulebook, and category purpose SUPP, which means it is a supplier payment. The purpose code is also SUPP, and the regulatory reporting field is empty, because no regulatory reporting is required for this payment.

The remittance information is unstructured with the text Invoice INV-2026-1187, and the debtor has also provided a structured remittance with the invoice number, the invoice date and the amount, so the creditor can reconcile automatically. The service level, the category purpose and the purpose code together tell the clearing system, the creditor agent and the creditor exactly what kind of payment this is, and they drive the processing, the screening and the reconciliation.

Failure and recovery: a service level code that the clearing system does not recognise is rejected with a pacs.002 and reason code AG01, and the sender must correct it and resend. A category purpose code that contradicts the purpose code, for example category purpose SALA for salary with purpose code SUPP for supplier payment, is flagged by the creditor agent and may be returned, because the inconsistency suggests the payment was built from the wrong template.

A remittance information field longer than 140 characters is truncated or rejected, depending on the scheme, and the sender must shorten it. A regulatory reporting field that is mandatory for the corridor but left empty is rejected, and the sender must populate it. The recovery is to correct the field and resend with a new MsgId, because the payment has not yet been executed and no funds have moved.

For a business analyst, product owner or subject matter expert, the test is to state, for every payment product, the service level, the category purpose, the purpose code and the remittance format, and to explain what each one drives. The service level selects the scheme and the processing rules. The category purpose selects the processing priority and the reporting category. The purpose code is used by the creditor for reconciliation and by the bank for screening and reporting.

The remittance information must be in the format the creditor can reconcile, structured for automated matching and unstructured for human reading, and the requirement must state which one the product uses. Note that SWIFT gpi is a service and tracking initiative, not a scheme, so it is never named as a service level. Source: ISO 20022 pacs.008.001.08, Payment Type Information; EPC SCT Rulebook 2025. Last reviewed 7 November 2026.

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.

Scene beat timestamps for this lesson were measured from the real audio, not estimated.