LogoLogo
Connect
Connect
  • ๐ŸกWelcome to LHV Connect API
  • ๐Ÿ“บNews and Updates
    • ๐Ÿ“ˆPerformance and Stats
    • ๐Ÿ””Notice of Change
  • ๐ŸงญQuick Start Guide
  • ๐ŸŽฅConnect Fundamentals
    • Authentication and Certificates
    • Environments
    • Messaging Pattern
    • Service Provider model
    • Technical limitations
    • Encoding and Languages
    • Response Compression
    • Dates and Time Zones
    • Response Codes and Error handling
    • Onboarding
    • Live Proving
    • LHV UK and Estonia integrations
    • FAQ and Tips
  • ๐Ÿ“–Service Catalogue
    • ๐Ÿ’šHeartbeat
      • Heartbeat - GET
      • Heartbeat Advanced - GET
    • ๐Ÿ“ฉMessages Services
      • Get next message
      • Get list of messages
      • Get list of messages V2
      • Get message by response ID
      • Get list of requests
      • Get request by request ID
      • Count number of messages
      • Mark message as processed
      • Mark batch of messages as processed
      • Mark batch of messages as processed V2
      • Messages Metadata
      • Get compressed message for testing
    • ๐Ÿ’ฐAccount Information Services
      • Account Balance
      • Account Statement
      • Transaction Notification
        • Incoming Bacs Credit Notification
    • ๐Ÿ’ธPayment Initiation Services
      • Pain.001.001.09
      • Pain.002.001.10
      • Samples
      • Authentication methods
      • Payment Scheme Selection
      • Payment Return Initiation
      • Payments Service Idempotency
      • Payments Originating Overseas
      • Legacy documents
        • pain.001.001.03 format
    • โœ…Confirmation of Payee Services
      • Confirmation of Payee - Requester
      • Confirmation of Payee - Responder
    • ๐Ÿ˜ถโ€๐ŸŒซ๏ธVIBAN Services
      • VIBAN Open
      • VIBAN Bulk Open
      • VIBAN Modify
      • VIBAN Info
      • VIBAN Close
      • VIBAN Notification
    • ๐Ÿ”—Indirect Scheme Access
      • Agency Account Synchronization
      • RTF - Routing Table Files message
      • ๐ŸงพPayment Collection Services
        • ๐Ÿ’ทBacs Direct Debit
          • Bacs Direct Debit Mandate Initiation Request
          • Bacs Direct Debit Mandate Initiation Response
          • Bacs Direct Debit Mandate Initiation Response Confirmation
          • Bacs Direct Debit Mandate Cancellation Request
          • Bacs Direct Debit Mandate Cancellation Response
          • Direct Debit Incoming Collection Notification Request
          • Direct Debit Collection Notification Response
          • Direct Debit Collection Notification Response Confirmation
          • Direct Debit Reversal Notification Request
          • Examples
    • ๐Ÿ“จWebhooks
      • Webhook Format and Processing
      • Managing Webhook Configurations
      • Webhook Security
      • Webhook Metadata
      • Full Bodied Webhooks
  • ๐Ÿ—“๏ธReference
    • Glossary
    • Code Reference Tables
      • Balance Type Codes
      • Credit and Debit Transaction Codes
      • Payment Scheme Codes
      • Direct Debit Scheme Codes
      • Payment Reject Codes
      • Payment Return Codes
      • Bacs Direct Debit Mandate Reject Codes
      • Bacs Direct Debit Reject Codes
      • Bacs Direct Debit Reversal Reason
      • Bank Transaction Codes
      • Transaction Purpose Codes
      • Category Purpose Codes
      • Private Person Identification Codes
      • Organisation Identification Type Codes
      • Payment Priority Codes
      • Charges Bearer Codes
  • โ˜Ž๏ธSupport
    • Contact
Powered by GitBook
On this page
  • XML Format pain.008.001.11
  • Message structure
  • Message root
  • Group header
  • Payment information

Was this helpful?

  1. Service Catalogue
  2. Indirect Scheme Access
  3. Payment Collection Services
  4. Bacs Direct Debit

Direct Debit Incoming Collection Notification Request

The ISO 20022 Customer Direct Debit Collection Initiation is sent to the client to inform about incoming Bacs Direct Debit.

PreviousBacs Direct Debit Mandate Cancellation ResponseNextDirect Debit Collection Notification Response

Last updated 1 month ago

Was this helpful?

Incoming Customer Direct Debit Collection Initiation can be requested via the .

HTTP Header Message-Response-Type: DIRECT_DEBIT_COLLECTION_NOTIFICATION

XML Format pain.008.001.11

LHV Bank uses the standard version of the pain.008.001.11 XML schema.

See the Example section for a message.

Message structure

MULT.
MESSAGE ELEMENT
XML TAG
COMMENT

[1..1]

+GroupHeader

<GrpHdr>

Mandatory, occurs once.

[1..*]

+PaymentInformation

<PmtInf>

Mandatory and repeatable. Contains information related to creditor.

[1..*]

++DirectDebitTransactionInformation

<DrctDbtTxInf>

Mandatory and repeatable. Contains information related to the direct debit(s) included in the message.

[1..*]

+SupplementaryData

<SplmtryData>

Not used. Additional information that cannot be captured in the structured elements and/or any other specific block.

Message root

MULT.
MESSAGE ELEMENT
XML TAG
COMMENT

[1..1]

+MessageRoot

<CstmrDrctDbtInitn>

Mandatory, occurs once.

Group header

MULT.
OR
MESSAGE ELEMENT
XML TAG
COMMENT

[1..1]

+GroupHeader

<GrpHdr>

Mandatory, occurs once.

[1..1]

++MessageIdentification

<MsgId>

Mandatory. Point to point reference, assigned by the instructing party and sent to the next party in the chain, to unambiguously identify the message.

[1..1]

++CreationDateTime

<CreDtTm>

Mandatory. Date and time at which the message was created.

[0..2]

++Authorisation

<Authstn>

Not used

[1..1]

++NumberOfTransactions

<NbOfTxs>

Mandatory. Number of direct debit transactions in all Payment Information blocks included in this message. If this number is not correct, the file upload will be cancelled.

[1..1]

++ControlSum

<CtrlSum>

Total of all individual amounts included in the message.

[1..1]

++InitiatingParty

<InitgPty>

Mandatory. Party that submits the Direct Debit Initiation Request to LHV.

[0..1]

+++Name

<Nm>

Creditor's name. Name by which a party is known and which is usually used to identify that party.

[0..1]

+++PostalAddress

<PstlAdr>

Not used

[0..1]

+++Identification

<Id>

Not used

[0..1]

+++CountryOfResidence

<CtryOfRes>

Not used

[0..1]

+++ContactDetails

<CtctDtls>

Not used

[0..1]

++ForwardingAgent

<FwdgAgt>

Not used

Payment information

MULT.
OR
MESSAGE ELEMENT
XML TAG
LHV Requirement

[1..*]

+PaymentInformation

<PmtInf>

Mandatory and repeatable. Contains information related to creditor.

[1..1]

++PaymentInformationIdentification

<PmtInfId>

Mandatory. Uniquely identifies the payment information group within this message.

[1..1]

++PaymentMethod

<PmtMtd>

Mandatory. Only the value "DD" (Direct Debit) is allowed here. If any other value is entered, it will be ignored.

[0..1]

++RequestedAdviceType

<ReqdAdvcTp>

Not used

[0..1]

++BatchBooking

<BtchBookg>

Not used

[1..1]

++NumberOfTransactions

<NbOfTxs>

Number of Direct Debit transactions included in the current Payment Information block. If this number is not correct, the file upload will be cancelled.

[1..1]

++ControlSum

<CtrlSum>

Control sum of all individual amounts in the current Payment Information block. If this number is not correct, the file upload will be cancelled.

[0..1]

++PaymentTypeInformation

<PmtTpInf>

Set of elements used to specify the type of transaction. 'Payment Type Information' must be present either here or under 'Direct Debit Transaction Information'.

[0..1]

+++InstructionPriority

<InstrPrty>

Not used

[1..1]

+++ServiceLevel

<SvcLvl>

[1..1]

{Or

++++Code

<Cd>

Not used

[1..1]

Or}

++++Proprietary

<Prtry>

[0..1]

+++LocalInstrument

<LclInstrm>

Not used

[0..1]

+++SequenceType

<SeqTp>

Indicates either 'FRST' (First), 'RCUR' (Recurring) or 'FNAL' (Final).

[0..1]

+++CategoryPurpose

<CtgyPurp>

Not used

[1..1]

++RequestedCollectionDate

<ReqdColltnDt>

Mandatory. Date and time at which the creditor requests that the amount of money is to be collected from the debtor. Day 3 of Bacs cycle (entry day).

[1..1]

++Creditor

<Cdtr>

Mandatory. Party whose account the amount of Direct Debit transaction is to be credited to.

[1..1]

+++Name

<Nm>

Creditorโ€™s name.

[0..1]

+++PostalAddress

<PstlAdr>

Not used

[0..1]

+++Identification

<Id>

Not used

[0..1]

+++CountryOfResidence

<CtryOfRes>

Not used

[0..1]

+++ContactDetails

<CtctDtls>

Not used

[1..1]

++CreditorAccount

<CdtrAcct>

Mandatory. Creditor's account. Can be client account where to Direct Debit transaction amount is credited or Indirect Agency account (client generated accounts).

[1..1]

+++Identification

<Id>

{Or

++++IBAN

<IBAN>

Not used

Or}

++++Other

<Othr>

[1..1]

+++++Identification

<Id>

Mandatory. Identification assigned by an institution. Creditor's account number, BBAN

[0..1]

+++++SchemeName

<SchmeNm>

Name of the identification scheme.

[1..1]

{Or

++++++Code

<Cd>

Name of the identification scheme, in a coded form as published in an external list. 'BBAN'

[1..1]

Or}

++++++Proprietary

<Prtry>

Not used

[0..1]

+++++Issuer

<Issr>

Not used

[0..1]

+++Type

<Tp>

Not used

[0..1]

+++Currency

<Ccy>

Identification of the currency in which the account is held, always 'GBP'.

[0..1]

+++Name

<Nm>

Not used

[0..1]

+++Proxy

<Prxy>

Not used

[1..1]

++CreditorAgent

<CdtrAgt>

Mandatory. Creditorโ€™s bank information.

[1..1]

+++FinancialInstitutionIdentification

<FinInstnId>

Mandatory. Financial institution servicing an account for the creditor.

[0..1]

++++BICFI

<BICFI>

Not used

[0..1]

++++ClearingSystemMemberIdentification

<ClrSysMmbId>

Information used to identify a member within a clearing system.

[0..1]

+++++ClearingSystemIdentification

<ClrSysId>

[1..1]

{Or

++++++Code

<Cd>

Identification of a clearing system. 'GBDSC'

[1..1]

Or}

++++++Proprietary

<Prtry>

Not used

[1..1]

+++++MemberIdentification

<MmbId>

Mandatory. Creditorโ€™s bank sort code. First 6 character from creditor's account number.

[0..1]

++++LEI

<LEI>

Not used

[0..1]

++++Name

<Nm>

Not used

[0..1]

++++PostalAddress

<PstlAdr>

Not used

[0..1]

++++Other

<Othr>

Not used

[0..1]

+++BranchIdentification

<BrnchId>

Not used

[0..1]

++CreditorAgentAccount

<CdtrAgtAcct>

Not used

[0..1]

++UltimateCreditor

<UltmtCdtr>

Not used

[0..1]

++ChargeBearer

<ChrgBr>

Not used

[0..1]

++ChargesAccountAgent

<ChrgsAcctAgt>

Not used

[0..1]

++CreditorSchemeIdentification

<CdtrSchmeId>

Not used

[1..*]

++DirectDebitTransactionInformation

<DrctDbtTxInf>

Mandatory. This block contains a set of elements used to provide information on the individual transaction(s) included in the message.

[1..1]

+++PaymentIdentification

<PmtId>

Mandatory. Set of elements used to reference a payment instruction.

[0..1]

++++InstructionIdentification

<InstrId>

Not used

[1..1]

++++EndToEndIdentification

<EndToEndId>

Mandatory. Unique identification assigned by the initiating party to unumbiguously identify the transaction.

[0..1]

++++UETR

<UETR>

Not used

[0..1]

+++PaymentTypeInformation

<PmtTpInf>

Set of elements used to specify the type of transaction.

[0..1]

++++InstructionPriority

<InstrPrty>

Not used

[1..1]

++++ServiceLevel

<SvcLvl>

{Or

+++++Code

<Cd>

Not used

Or}

+++++Proprietary

<Prtry>

[0..1]

++++LocalInstrument

<LclInstrm>

Not used

[0..1]

++++SequenceType

<SeqTp>

Indicates either 'FRST' (First), 'RCUR' (Recurring) or 'FNAL' (Final).

[0..1]

++++CategoryPurpose

<CtgyPurp>

Not used

[1..1]

+++InstructedAmount

<InstdAmt>

Mandatory. Payment amount ordered by the initiating party.

[0..1]

+++ChargeBearer

<ChrgBr>

Not used

[1..1]

+++DirectDebitTransaction

<DrctDbtTx>

Not used

[0..1]

+++UltimateCreditor

<UltmtCdtr>

Not used

[1..1]

+++DebtorAgent

<DbtrAgt>

Mandatory. Debtorโ€™s bank information.

[1..1]

++++FinancialInstitutionIdentification

<FinInstnId>

Mandatory. Financial institution servicing an account for the debtor.

[0..1]

+++++BICFI

<BICFI>

Not used

[0..1]

+++++ClearingSystemMemberIdentification

<ClrSysMmbId>

[0..1]

++++++ClearingSystemIdentification

<ClrSysId>

[1..1]

{Or

+++++++Code

<Cd>

Identification of a clearing system. 'GBDSC'

[1..1]

Or}

+++++++Proprietary

<Prtry>

Not used

[1..1]

++++++MemberIdentification

<MmbId>

Mandatory. Debtorโ€™s bank sort code. First 6 character from debtor's account number.

[0..1]

+++++LEI

<LEI>

Not used

[0..1]

+++++Name

<Nm>

Not used

[0..1]

+++++PostalAddress

<PstlAdr>

Not used

[0..1]

+++++Other

<Othr>

Not used

[0..1]

++++BranchIdentification

<BrnchId>

Not used

[0..1]

+++DebtorAgent Account

<DbtrAgtAcct>

Not used

[1..1]

+++Debtor

<Dbtr>

Mandatory. Party that owes an amount of money to the creditor.

[1..1]

++++Name

<Nm>

Debtor name.

[0..1]

++++Postal Address

<PstlAdr>

Not used

[0..1]

++++Identification

<Id>

Not used

[0..1]

++++CountryOfResidence

<CtryOfRes>

Not used

[0..1]

++++ContactDetails

<CtctDtls>

Not used

[1..1]

+++DebtorAccount

<DbtrAcct>

Mandatory. Unambiguous identification of the account of the debtor to which a debit entry will be made as a result of the transaction.

[1..1]

++++Identification

<Id>

{Or

+++++IBAN

<IBAN>

Not used

Or}

+++++Other

<Othr>

Unique identification of an account, as assigned by the account servicer, using an identification scheme.

[1..1]

++++++Identification

<Id>

Mandatory. Identification assigned by an institution. Debtor's account number, BBAN.

[0..1]

++++++SchemeName

<SchmeNm>

Name of the identification scheme.

[1..1]

{Or

+++++++Code

<Cd>

Name of the identification scheme. 'BBAN'

[1..1]

Or}

+++++++Proprietary

<Prtry>

Not used

[0..1]

++++++Issuer

<Issr>

Not used

[0..1]

++++Type

<Tp>

Not used

[0..1]

++++Currency

<Ccy>

Identification of the currency in which the account is held. 'GBP'

[0..1]

++++Name

<Nm>

Not used

[0..1]

++++Proxy

<Prxy>

Not used

[0..1]

+++UltimateDebtor

<UltmtDbtr>

Not used

[0..1]

+++InstructionForCreditorAgent

<InstrForCdtrAgt>

Not used

[0..1]

+++Purpose

<Purp>

Not used

[0..10]

+++RegulatoryReporting

<RgltryRptg>

Not used

[0..1]

+++Tax

<Tax>

Not used

[0..10]

+++RelatedRemittanceInformation

<RltdRmtInf>

Not used

[0..1]

+++RemittanceInformation

<RmtInf>

Information supplied to enable the matching of an entry with the items that the transfer is intended to settle.

[0..*]

++++Unstructured

<Ustrd>

Not used

[0..*]

++++Structured

<Strd>

[0..*]

+++++ReferredDocumentInformation

<RfrdDocInf>

Not used

[0..1]

+++++ReferredDocumentAmount

<RfrdDocAmt>

Not used

[0..1]

+++++CreditorReferenceInformation

<CdtrRefInf>

Reference information provided by the creditor to allow the identification of the underlying documents.

[0..1]

++++++Type

<Tp>

Not used

[0..1]

++++++Reference

<Ref>

[0..1]

++++Invoicer

<Invcr>

Not used

[0..1]

++++Invoicee

<Invcee>

Not used

[0..1]

++++TaxRemittance

<TaxRmt>

Not used

[0..1]

++++GarnishmentRemittance

<GrnshmtRmt>

Not used

[0..3]

++++AdditionalRemittanceInformation

<AddtlRmtInf>

Not used

[0..*]

+++SupplementaryData

<SplmtryData>

Not used

[0..*]

++SupplementaryData

<SplmtryData>

Not used

See the supported values in

See the supported values in )

Unique reference. Related Mandate id. Mndt.MndtId.MndtReqId from .

๐Ÿ“–
๐Ÿ”—
๐Ÿงพ
๐Ÿ’ท
Code set: Direct Debit scheme
Code set: Direct Debit scheme
pain.009
Messages service
pain.008.001.11
54KB
pain.008.001.11.xsd