ISO 20022

Your payment systems already produce ISO 20022 messages. Notabene is designed to accept your pain.001 payment instructions and answer each with a pain.002 status report, so you keep the messages you already use.

Each instruction becomes a payment, and Payments explains what a payment is and how it settles. Payments are in beta, so contact your Solutions Engineer or [email protected] to start mapping your payment flows.

Message flow

  1. Your payment system produces a pain.001 with one or more credit transfer instructions.
  2. Notabene reads each instruction on its own, with its two accounts, its amount and currency, and your references.
  3. Each instruction it accepts becomes a payment.
  4. You get a pain.002 back. It lists every instruction as accepted or rejected, with the reason for each rejection.

pain.001

A pain.001 groups its instructions in payment information blocks (PmtInf). Each block names the debtor and the debtor’s account, and holds one or more credit transfer instructions (CdtTrfTxInf).

XML
<?xml version="1.0" encoding="UTF-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.001.001.09">
  <CstmrCdtTrfInitn>
    <GrpHdr>
      <MsgId>MSG-2026-0412</MsgId>
      <NbOfTxs>2</NbOfTxs>
      <InitgPty><Nm>Ava Chen</Nm></InitgPty>
    </GrpHdr>
    <PmtInf>
      <PmtInfId>PMT-1</PmtInfId>
      <PmtMtd>TRF</PmtMtd>
      <Dbtr><Nm>Ava Chen</Nm></Dbtr>
      <DbtrAcct><Id><IBAN>DE89370400440532013000</IBAN></Id></DbtrAcct>
      <CdtTrfTxInf>
        <PmtId><InstrId>INSTR-1</InstrId><EndToEndId>INV-18234</EndToEndId></PmtId>
        <Amt><InstdAmt Ccy="USD">129.00</InstdAmt></Amt>
        <CdtrAgt><FinInstnId><Othr><Id>did:web:merchant.example</Id></Othr></FinInstnId></CdtrAgt>
        <Cdtr><Nm>Acme Coffee Inc.</Nm></Cdtr>
        <CdtrAcct><Id><IBAN>NL91ABNA0417164300</IBAN></Id></CdtrAcct>
        <RmtInf><Ustrd>Order 18234</Ustrd><Ustrd>two bags</Ustrd></RmtInf>
      </CdtTrfTxInf>
      <CdtTrfTxInf>
        <PmtId><EndToEndId>INV-18235</EndToEndId></PmtId>
        <Amt><InstdAmt Ccy="XXQ">5.00</InstdAmt></Amt>
        <Cdtr><Nm>Acme Coffee Inc.</Nm></Cdtr>
        <CdtrAcct><Id><IBAN>NL91ABNA0417164300</IBAN></Id></CdtrAcct>
      </CdtTrfTxInf>
    </PmtInf>
  </CstmrCdtTrfInitn>
</Document>
<?xml version="1.0" encoding="UTF-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.001.001.09">
  <CstmrCdtTrfInitn>
    <GrpHdr>
      <MsgId>MSG-2026-0412</MsgId>
      <NbOfTxs>2</NbOfTxs>
      <InitgPty><Nm>Ava Chen</Nm></InitgPty>
    </GrpHdr>
    <PmtInf>
      <PmtInfId>PMT-1</PmtInfId>
      <PmtMtd>TRF</PmtMtd>
      <Dbtr><Nm>Ava Chen</Nm></Dbtr>
      <DbtrAcct><Id><IBAN>DE89370400440532013000</IBAN></Id></DbtrAcct>
      <CdtTrfTxInf>
        <PmtId><InstrId>INSTR-1</InstrId><EndToEndId>INV-18234</EndToEndId></PmtId>
        <Amt><InstdAmt Ccy="USD">129.00</InstdAmt></Amt>
        <CdtrAgt><FinInstnId><Othr><Id>did:web:merchant.example</Id></Othr></FinInstnId></CdtrAgt>
        <Cdtr><Nm>Acme Coffee Inc.</Nm></Cdtr>
        <CdtrAcct><Id><IBAN>NL91ABNA0417164300</IBAN></Id></CdtrAcct>
        <RmtInf><Ustrd>Order 18234</Ustrd><Ustrd>two bags</Ustrd></RmtInf>
      </CdtTrfTxInf>
      <CdtTrfTxInf>
        <PmtId><EndToEndId>INV-18235</EndToEndId></PmtId>
        <Amt><InstdAmt Ccy="XXQ">5.00</InstdAmt></Amt>
        <Cdtr><Nm>Acme Coffee Inc.</Nm></Cdtr>
        <CdtrAcct><Id><IBAN>NL91ABNA0417164300</IBAN></Id></CdtrAcct>
      </CdtTrfTxInf>
    </PmtInf>
  </CstmrCdtTrfInitn>
</Document>

Each instruction needs your EndToEndId, an amount with an ISO 4217 currency, and the accounts of the debtor and the creditor. An account can be an IBAN or another identifier. Notabene also reads the names, your InstrId, the creditor’s institution and the remittance text when you send them.

A bad instruction does not stop the file. One without an account, with a negative amount or with an unknown currency is rejected on its own, and the others go ahead.

pain.002

The pain.002 answers the whole file. It lists every instruction by your EndToEndId, in the order you sent them.

XML
<?xml version="1.0" encoding="UTF-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.002.001.10">
  <CstmrPmtStsRpt>
    <GrpHdr>
      <MsgId>REPORT-1</MsgId>
      <CreDtTm>2026-10-28T08:30:00Z</CreDtTm>
    </GrpHdr>
    <OrgnlGrpInfAndSts>
      <OrgnlMsgId>MSG-2026-0412</OrgnlMsgId>
      <OrgnlMsgNmId>pain.001.001.09</OrgnlMsgNmId>
      <GrpSts>PART</GrpSts>
    </OrgnlGrpInfAndSts>
    <OrgnlPmtInfAndSts>
      <OrgnlPmtInfId>PMT-1</OrgnlPmtInfId>
      <TxInfAndSts>
        <OrgnlEndToEndId>INV-18234</OrgnlEndToEndId>
        <TxSts>ACTC</TxSts>
        <AcctSvcrRef>0f4b7f7e-3a1c-4c7e-9d36-1b2f0f6a9c11</AcctSvcrRef>
      </TxInfAndSts>
      <TxInfAndSts>
        <OrgnlEndToEndId>INV-18235</OrgnlEndToEndId>
        <TxSts>RJCT</TxSts>
        <StsRsnInf>
          <AddtlInf>unknown currency XXQ</AddtlInf>
        </StsRsnInf>
      </TxInfAndSts>
    </OrgnlPmtInfAndSts>
  </CstmrPmtStsRpt>
</Document>
<?xml version="1.0" encoding="UTF-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.002.001.10">
  <CstmrPmtStsRpt>
    <GrpHdr>
      <MsgId>REPORT-1</MsgId>
      <CreDtTm>2026-10-28T08:30:00Z</CreDtTm>
    </GrpHdr>
    <OrgnlGrpInfAndSts>
      <OrgnlMsgId>MSG-2026-0412</OrgnlMsgId>
      <OrgnlMsgNmId>pain.001.001.09</OrgnlMsgNmId>
      <GrpSts>PART</GrpSts>
    </OrgnlGrpInfAndSts>
    <OrgnlPmtInfAndSts>
      <OrgnlPmtInfId>PMT-1</OrgnlPmtInfId>
      <TxInfAndSts>
        <OrgnlEndToEndId>INV-18234</OrgnlEndToEndId>
        <TxSts>ACTC</TxSts>
        <AcctSvcrRef>0f4b7f7e-3a1c-4c7e-9d36-1b2f0f6a9c11</AcctSvcrRef>
      </TxInfAndSts>
      <TxInfAndSts>
        <OrgnlEndToEndId>INV-18235</OrgnlEndToEndId>
        <TxSts>RJCT</TxSts>
        <StsRsnInf>
          <AddtlInf>unknown currency XXQ</AddtlInf>
        </StsRsnInf>
      </TxInfAndSts>
    </OrgnlPmtInfAndSts>
  </CstmrPmtStsRpt>
</Document>

The group status, GrpSts, covers the whole file.

  • ACTC: every instruction was accepted.
  • PART: some were accepted and some rejected.
  • RJCT: none was accepted.

Each instruction has its own TxSts, either ACTC or RJCT. A rejected one says why in AddtlInf, and an accepted one carries Notabene’s reference in AcctSvcrRef.


Did this page help you?