Import International payments by XML (Non-IBAN)

  • You can import payments into Commercial Banking Online using XML. We recommend that your IT department sets up your XML files.
    The information on this page is designed to show which tags are optional or mandatory, and specify the correct format for your data.
    We currently use the ISO 20022 PAIN 001.001.003 format for importing into Commercial Banking Online.

     F&S icon 

    Always make sure that your payment and beneficiary details are correct before importing to Commercial Banking Online

    File Structure

    XMLs for International Payments have a Group header and Payment information sections. More payments can be added by repeating the Payment information section.

     

    Group header
    (GrpHdr)

    The XML file starts with a Group header to identify the file in Commercial Banking Online.

    • You should only have one Group Header on an XML file
    • All the tags in the Group header need to be in the XML
    • None of the information in this section will be used as part of the payment
     

    Payment information
    (PmtInf)

    Payment information

    • You can have more than one Payment information section on an XML file
    • Some of the tags in Payment information are optional
     


    Name

    Mandatory /Optional

    Tag

    Character Limit

    Notes

    Message Identification

    M

     

    <CstmrCdtTrfInitn>
     <GrpHdr>
      < MsgId>

    35

    Your Message Identification tag should be:
    “Commercial Banking Online”

    Created date and time

    M

     

    <CstmrCdtTrfInitn>
     <GrpHdr>
      <CreDtTm>

     

    This tag is needed and should contain the Year, Month, Day and Time in the following format:
    YYYY-MM-DDT:HH:MM:00.000Z
    “2016-12-16T14:30:00.000Z”

    Number of transactions

    M

     

    <CstmrCdtTrfInitn>
     <GrpHdr>
      <NbOfTxs>

    15

    This tag is needed to maintain the structure of the XML, it will not be used for any payment information.
    Enter any value up to 15 characters long, for example “1234”

    Initiating Party

    M

     

    <CstmrCdtTrfInitn>
     <GrpHdr>
      <InitgPty>

     

    This tag is needed to maintain the structure of the XML it should be left as an empty -element tag and appear as <InitgPty/> on the XML

    Payment Information Identification

    M

    <CstmrCdtTrfInitn>
     <PmtInf>
      <PmtInfId>

    35

    This tag is needed to identify the XML in Commercial Banking Online, the information will not be part of the payment details.

    Payment Method

    M

     

    <CstmrCdtTrfInitn>
     <PmtInf>
      <PmtMtd

     

    Enter ‘TRA’ for payment method

    Payment Type

    M

    <CstmrCdtTrfInitn>
     <PmtInf>
      <PmtTpInf>
       <LclInstrm>
        <Prtry

     

    Enter ‘INTL’ to make International payments

    Debit Account Reference

    O

    <CstmrCdtTrfInitn>
     <PmtInf>
      <PmtTpInf>
       <CtgyPurp>
        <Prtry>

    16

    This tag is optional, if you include it in your XML then you must provide some information.
    If don’t want to provide a Debit account reference you will need to remove the following tags from the XML:
    <CtgyPurp>
    <Prtry>

    Value Date

    M

    <CstmrCdtTrfInitn>
     <PmtInf>
      <ReqdExctnDt>

     

    Enter the value date of the payment, using the Year, Month and Day in the following format:
    YYYY-MM-DD

    Debtor

    M

    <CstmrCdtTrfInitn>
     <PmtInf>
      <Dbtr>

     

    This tag is needed to maintain the structure of the XML it should be left as an empty -element tag and appear as <Dbtr/> in the XML

    Debit Account Number

    M

    <CstmrCdtTrfInitn>
     <PmtInf>
      <DbtrAcct>
       <Id>
        <Othr>
         <Id>

     

    Enter the sort code and account number of the debit account in the following format:
    123456-12345678

    Financial Institution ID

    M

    <CstmrCdtTrfInitn>
     <PmtInf>
      <DbtrAgt>
       <FinInstnId

     

    This tag is needed to maintain the structure of the XML it should be left as an empty -element tag and appear as <FinInstnId/> in the XML

    End to End Reference

    M

    <CstmrCdtTrfInitn>
     <PmtInf>
      <CdtTrfTxInf
       <PmtId>
        <EndToEndId>

    31

    Enter a reference for the transaction

    Credit Amount and Payment Currency

    M

    <CstmrCdtTrfInitn>
     <PmtInf>
      <CdtTrfTxInf>
       <Amt>
        <InstdAmt>

     

    The currency information needs to be an attribute of the InstdAmt tag. It need to use a three letter ISO currency code.
    You can enter any amount from 0.01 to 8,999,999,999,999.99. You should avoid using a comma in the payment amount.
    For example £1,500 would be:
    <InstdAmt Ccy="GBP">1500.00</InstdAmt>

    Exchange Rate

    O

    <CstmrCdtTrfInitn>
     <PmtInf>
      <CdtTrfTxInf>
       <XchgRateInf>
        <XchgRate>

    22

    This tag is optional, if you include it in your XML then you must provide some information.
    If don’t want to provide an Exchange Rate you will need to remove the following tags from the XML:
    <XchgRateInf>
    <XchgRate>

    FX Contract ID

    O

    <CstmrCdtTrfInitn>
     <PmtInf>
      <CdtTrfTxInf>
       <XchgRateInf>
        <CtrctId>

    16

    This tag is optional, if you include it in your XML then you must provide some information.
    If don’t want to provide a FX Contact ID you will need to remove following tags from the XML:
    <XchgRateInf>
    <CtrctId>

    Charges

    M

    <CstmrCdtTrfInitn>
     <PmtInf>
      <CdtTrfTxInf>
       <ChrgBr>

    4

    You must enter a Charges code, it can be SHAR , CRED, or DEBT

    SHAR (SHA): The charges are shared between parties, they will be invoiced as part of your agreed tariff and won’t appear on the debit advice 

    DEBT (OUR): You pay the charges, they will be invoiced as part of your agreed tariff and won’t appear on the debit advice.

    CRED (BEN):  The beneficiary pays the charges, they will be taken from the total amount sent to the beneficiary. The charges will appear on the debit advice. 

    Intermediary Bank Code

    O

    <CstmrCdtTrfInitn>
     <PmtInf>
      <CdtTrfTxInf>
       <IntrmyAgt1>
        <FinInstnId>
         <BIC>

     

    Enter the SWIFT/BIC code for any Intermediary Bank.

    If you don’t have an Intermediary Bank BIC then you must remove the following tags:
    <IntrmyAgt1>
    <FinInstnId>
    <BIC>

    Beneficiary Bank Code Type

    M

    <CstmrCdtTrfInitn>
     <PmtInf>
      <CdtTrfTxInf>
       <CdtrAgt>
        <FinInstnId>
         <ClrSysMmbId>
          <ClrSysId>
           <Cd>

     

     

    Enter the Bank Code type for your payment

    Beneficiary Bank Code

    M

    <CstmrCdtTrfInitn>
     <PmtInf>
      <CdtTrfTxInf>
       <CdtrAgt>
        <FinInstnId>
         <ClrSysMmbId>
          <MmbId>

     

    This will depend on the Beneficiary Bank Code Type that you have entered above. The Bank Code should be entered without spaces or dashes, for example: 123456

    Beneficiary Name

    M

    <CstmrCdtTrfInitn>
     <PmtInf>
      <CdtTrfTxInf>
       <Cdtr>
        <Nm>

    35

    Enter the name of the Beneficiary account

    Beneficiary Address Line 1

    O


    <CstmrCdtTrfInitn>
     <PmtInf>
      <CdtTrfTxInf>
       <Cdtr>
        <PstlAdr>
         <AdrLine>

    35

    This tag is optional, if you include it in your XML then you must provide some information.
    If don’t want to provide a Beneficiary Address you will need to remove the <AdrLine > tag from the XML:
    If you remove the tags for all three lines of the Beneficiary Address and the Beneficiary Country, you will also need to remove the <PstlAdr> tag

    Beneficiary Address Line 2

    O


    <CstmrCdtTrfInitn>
     <PmtInf>
      <CdtTrfTxInf>
       <Cdtr>
        <PstlAdr>
         <AdrLine>

    35

    This tag is optional, if you include it in your XML then you must provide some information.
    If don’t want to provide a Beneficiary Address you will need to remove the <AdrLine > tag from the XML:
    If you remove the tags for all three lines of the Beneficiary Address and the Beneficiary Country, you will also need to remove the <PstlAdr> tag

    Beneficiary Address Line 3

    O

    <CstmrCdtTrfInitn>
     <PmtInf>
      <CdtTrfTxInf>
       <Cdtr>
        <PstlAdr>
         <AdrLine>

    35

    This tag is optional, if you include it in your XML then you must provide some information.
    If don’t want to provide a Beneficiary Address you will need to remove the <AdrLine > tag from the XML:
    If you remove the tags for all three lines of the Beneficiary Address and the Beneficiary Country, you will also need to remove the <PstlAdr> tag

    Beneficiary Country

    O

    <CstmrCdtTrfInitn>
     <PmtInf>
      <CdtTrfTxInf>
       <Cdtr>
        <PstlAdr>
         <AdrLine>

    2

    This tag is optional, if you include it in your XML then you must provide some information.
    If don’t want to provide a Beneficiary Country you will need to remove the <AdrLine > tag from the XML:
    If you remove the tags for all three lines of the Beneficiary Address and the Beneficiary Country, you will also need to remove the <PstlAdr> tag

    Beneficiary Account Number

    M

    <CstmrCdtTrfInitn>
     <PmtInf>
      <CdtTrfTxInf>
       <CdtrAcct>
        <Id>
         <Othr>
          <Id>

     

    Enter the Beneficiary Account Number using the following format: 12345678

    Beneficiary Account Type

    M

    <CstmrCdtTrfInitn>
     <PmtInf>
      <CdtTrfTxInf>
       <CdtrAcct>
        <Tp>
         <Prtry>

     

    You need to enter Other in this tag

    Beneficiary Reference Line 1

    O

    <CstmrCdtTrfInitn>
     <PmtInf>
      <CdtTrfTxInf>
       <RmtInf>
        <Ustrd>

    35

    This tag is optional, if you include it in your XML then you must provide some information.
    If don’t want to provide a Beneficiary reference you will need to remove the < Ustrd> tag from the XML:
    If you remove all four lines of the Beneficiary reference, you will also need to remove the <RmtInf> tag

    Beneficiary Reference Line 2

    O

    <CstmrCdtTrfInitn>
     <PmtInf>
      <CdtTrfTxInf>
       <RmtInf>
        <Ustrd>

    35

    This tag is optional, if you include it in your XML then you must provide some information.
    If don’t want to provide a Beneficiary reference you will need to remove the < Ustrd> tag from the XML:
    If you remove all four lines of the Beneficiary reference, you will also need to remove the <RmtInf> tag

    Beneficiary Reference Line 3

    O

    <CstmrCdtTrfInitn>
     <PmtInf>
      <CdtTrfTxInf>
       <RmtInf>
        <Ustrd>

    35

    This tag is optional, if you include it in your XML then you must provide some information.
    If don’t want to provide a Beneficiary reference you will need to remove the < Ustrd> tag from the XML:
    If you remove all four lines of the Beneficiary reference, you will also need to remove the <RmtInf> tag

    Beneficiary Reference Line 4

    O

     

    <CstmrCdtTrfInitn>
     <PmtInf>
      <CdtTrfTxInf>
       <RmtInf>
        <Ustrd>

    35

    This tag is optional, if you include it in your XML then you must provide some information.
    If don’t want to provide a Beneficiary reference you will need to remove the < Ustrd> tag from the XML:
    If you remove all four lines of the Beneficiary reference, you will also need to remove the <RmtInf> tag



Calls may be monitored or recorded in case we need to check we have carried out your instructions correctly and to help improve our quality of service.

Lloyds Bank plc Registered Office: 25 Gresham Street, London EC2V 7HN. Registered in England and Wales no. 2065. Telephone: 020 7626 1500.

Authorised by the Prudential Regulation Authority and regulated by the Financial Conduct Authority and the Prudential Regulation Authority under registration number 119278.

We subscribe to the Lending Code; copies of the Code can be obtained from www.lendingstandardsboard.org.uk.

Eligible deposits with us are protected by the Financial Services Compensation Scheme (FSCS). We are covered by the Financial Ombudsman Service (FOS). Please note that due to FSCS and FOS eligibility criteria not all business customers will be covered.