Direct Debit Incoming Collection Notification
For each incoming Direct Debit collection a notification message will be sent (pain.008).
Request message format is Customer Direct Debit Collection Initiation (XML type pain.008.001.10) that covers Bacs Direct Debit scheme.
If Direct Debit collection is cancelled (by Creditor) then the cancellation process has to be started and Direct Debit exception request (pain.007) sent.
If Direct Debit collection is reversed (by Creditor) then the reversal process has to be started and Direct Debit exception request (pain.007) sent.
Payment Status Report (pain.002) is returned to inform about the status of imported collections. More than one status may be returned for one collection.
XML Format pain.008.001.11
LHV is currently using standard version of pain.008.001.11.xsd.
Message structure
| MULT. | MESSAGE ELEMENT | XML TAG | COMMENT |
|---|---|---|---|
[1..1] | +GroupHeader | <GrpHdr> | Mandatory, occurs once. |
[1..*] | +PaymentInformation | <PmtInf> | Mandatory and repetitive. Contains information related to creditor. |
[1..*] | ++DirectDebitTransactionInformation | <DrctDbtTxInf> | Mandatory and repetitive. 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 repetitive. 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> | See the supported values in Code set: Direct Debit scheme |
[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> | See the supported values in Code set: Direct Debit scheme) | |
[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> | Not used | |
[0..*] | +++SupplementaryData | <SplmtryData> | Not used | |
[0..*] | ++SupplementaryData | <SplmtryData> | Not used |
Last updated