# Bacs Direct Debit Mandate Initiation Request

&#x20;Incoming Mandate Initiation Requests can be requested via the [Messages service](https://docs.lhv.com/home/connect/services/messages).

{% hint style="info" %}
HTTP Header Message-Response-Type: DIRECT\_DEBIT\_MANDATE\_INITIATION
{% endhint %}

## XML Format pain.009.001.07

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

{% file src="<https://2266620947-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHGywduAxJuxV3reZhASh%2Fuploads%2F3PfgM6CsoIcvMh09RQ5g%2Fpain.009.001.07.xsd?alt=media&token=abb09bb5-2dcc-416c-9d49-623333918b27>" %}

See the Examples section for a [pain.009.001.07](https://docs.lhv.com/home/connect/services/indirect-scheme-access/payment-collection-services/samples#example-of-mandate-initiation-request) message.

### Message structure

<table data-full-width="false"><thead><tr><th width="98">MULT.</th><th width="201">MESSAGE ELEMENT</th><th width="163">XML TAG</th><th>COMMENT</th></tr></thead><tbody><tr><td>[1..1]</td><td>+GroupHeader</td><td>&#x3C;GrpHdr></td><td><strong>Mandatory</strong>, occurs once.</td></tr><tr><td>[1..*]</td><td>+Mandate</td><td>&#x3C;Mndt></td><td><strong>Mandatory</strong> and repeatable. Set of elements used to provide the details of the mandate signed between the creditor and the debtor.</td></tr><tr><td>[0..*]</td><td>+SupplementaryData</td><td>&#x3C;SplmtryData></td><td><strong>Not used.</strong> Additional information that cannot be captured in the structured elements and/or any other specific block.</td></tr></tbody></table>

### Message root

<table data-full-width="false"><thead><tr><th width="95">MULT.</th><th width="200">MESSAGE ELEMENT</th><th width="154">XML TAG</th><th>COMMENT</th></tr></thead><tbody><tr><td>[1..1]</td><td>+MessageRoot</td><td>&#x3C;MndtInitnReq></td><td><strong>Mandatory</strong>, occurs once.</td></tr></tbody></table>

### Group Header

<table data-full-width="false"><thead><tr><th width="99">MULT.</th><th width="61">OR</th><th width="221">MESSAGE ELEMENT</th><th width="127">XML TAG</th><th>COMMENT</th></tr></thead><tbody><tr><td>[1..1]</td><td></td><td>+GroupHeader</td><td>&#x3C;GrpHdr></td><td><strong>Mandatory</strong>, occurs once.</td></tr><tr><td>[1..1]</td><td></td><td>++MessageIdentification</td><td>&#x3C;MsgId></td><td><strong>Mandatory</strong>. Point to point reference, as assigned by the instructing party, and sent to the instructed party, to unambiguously identify the message.</td></tr><tr><td>[1..1]</td><td></td><td>++CreationDateTime</td><td>&#x3C;CreDtTm></td><td><strong>Mandatory</strong>. Date and time at which the message was created.</td></tr><tr><td>[0..2]</td><td></td><td>++Authorisation</td><td>&#x3C;Authstn></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>++InitiatingParty</td><td>&#x3C;InitgPty></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>++InstructingAgent</td><td>&#x3C;InstgAgt></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>++InstructedAgent</td><td>&#x3C;InstdAgt></td><td><strong>Not used</strong></td></tr></tbody></table>

### Mandate

<table data-full-width="false"><thead><tr><th width="86">MULT.</th><th width="58">OR</th><th width="278">MESSAGE ELEMENT</th><th width="156">XML TAG</th><th>COMMENT</th></tr></thead><tbody><tr><td>[1..*]</td><td></td><td>+Mandate</td><td>&#x3C;Mndt></td><td><strong>Mandatory</strong> and repeatable. Set of elements used to provide the details of the mandate signed between the creditor and the debtor.</td></tr><tr><td>[0..*]</td><td></td><td>++MandateIdentification</td><td>&#x3C;MndtId></td><td>Unique identification, as assigned by the responsible party, to unambiguously identify the mandate</td></tr><tr><td>[1..1]</td><td></td><td>++MandateRequestIdentification</td><td>&#x3C;MndtReqId></td><td><strong>Mandatory.</strong> Identification for the mandate request, as assigned by the initiating party.</td></tr><tr><td>[0..2]</td><td></td><td>++Authorisation</td><td>&#x3C;Authstn></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>++Type</td><td>&#x3C;Tp></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>++Occurrences</td><td>&#x3C;Ocrncs&#x3C;</td><td>Provides details of the duration of the mandate and occurrence of the underlying transactions.</td></tr><tr><td>[1..1]</td><td></td><td>+++SequenceType</td><td>&#x3C;SeqTp></td><td><strong>Mandatory.</strong> Identifies the underlying transaction sequence as either recurring or one-off. Always '<strong>RCUR</strong>'</td></tr><tr><td>[0..1]</td><td></td><td>+++Frequency</td><td>&#x3C;Frqcy></td><td>Regularity with which instructions are to be created and processed. </td></tr><tr><td>[1..1]</td><td>{Or</td><td>++++Type</td><td>&#x3C;Tp></td><td><p>Specifies a frequency in terms of a specified period type.<br>DAIL - daily</p><p>WEEK - weekly</p><p>FRTN - Fortnightly</p><p>MNTH - monthly</p><p>ADHO - bimothly (Event takes place on request or as necessary)</p><p>QURT - quarterly</p><p>YEAR - annual</p></td></tr><tr><td>[1..1]</td><td>or</td><td>++++Period</td><td>&#x3C;Prd></td><td><strong>Not used</strong></td></tr><tr><td>[1..1]</td><td>Or}</td><td>++++PointInTime</td><td>&#x3C;PtInTm></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>+++Duration</td><td>&#x3C;Drtn></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>+++FirstCollectionDate</td><td>&#x3C;FrstColltnDt></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>+++FinalCollectionDate</td><td>&#x3C;FnlColltnDt></td><td><strong>Not used</strong></td></tr><tr><td>[1..1]</td><td></td><td>++TrackingIndicator</td><td>&#x3C;TrckgInd></td><td><strong>Mandatory.</strong> Specifies whether the direct debit instructions should be automatically re-submitted periodically when bilaterally agreed.<br>True/False indicator. Always <strong>False</strong>.</td></tr><tr><td>[0..1]</td><td></td><td>++FirstCollectionAmount</td><td>&#x3C;FrstColltnAmt></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>++CollectionAmount</td><td>&#x3C;ColltnAmt></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>++MaximumAmount</td><td>&#x3C;MaxAmt></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>++Adjustment</td><td>&#x3C;Adjstmnt></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>++Reason</td><td>&#x3C;Rsn></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>++CreditorSchemeIdentification</td><td>&#x3C;CdtrSchmeId></td><td><strong>Not used</strong></td></tr><tr><td>[1..1]</td><td></td><td>++Creditor</td><td>&#x3C;Cdtr></td><td><strong>Mandatory.</strong> Party that signs the mandate and to whom an amount of money is due.</td></tr><tr><td>[0..1]</td><td></td><td>+++Name</td><td>&#x3C;Nm></td><td>Name by which a party is known and which is usually used to identify that party.</td></tr><tr><td>[0..1]</td><td></td><td>+++PostalAddress</td><td>&#x3C;PstlAdr></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>+++Identification</td><td>&#x3C;Id></td><td>Unique and unambiguous identification of a party.</td></tr><tr><td>[1..1]</td><td>{Or</td><td>++++OrganisationIdentification</td><td>&#x3C;OrgId></td><td>Unique and unambiguous way to identify an organisation.</td></tr><tr><td>[0..1]</td><td></td><td>+++++AnyBIC</td><td>&#x3C;AnyBIC></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>+++++LEI</td><td>&#x3C;LEI></td><td><strong>Not used</strong></td></tr><tr><td>[0..*]</td><td></td><td>+++++Other</td><td>&#x3C;Othr></td><td>Unique identification of an organisation, as assigned by an institution, using an identification scheme.</td></tr><tr><td>[1..1]</td><td></td><td>++++++Identification</td><td>&#x3C;Id></td><td><strong>Mandatory.</strong> Identification assigned by an institution.<br>Creditor's Service User Number.</td></tr><tr><td>[0..1]</td><td></td><td>++++++SchemeName</td><td>&#x3C;SchmeNm></td><td>Name of the identification scheme.</td></tr><tr><td>[1..1]</td><td>{Or</td><td>+++++++Code</td><td>&#x3C;Cd></td><td>Name of the identification scheme. Always '<strong>BANK</strong>'.</td></tr><tr><td>[1..1]</td><td>Or}</td><td>+++++++Proprietary</td><td>&#x3C;Prtry></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>++++++Issuer</td><td>&#x3C;Issr></td><td><strong>Not used</strong></td></tr><tr><td>[1..1]</td><td>Or}</td><td>++++PrivateIdentification</td><td>&#x3C;PrvtId></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>+++CountryOfResidence</td><td>&#x3C;CtryOfRes></td><td>Country in which a person resides (the place of a person's home). In the case of a company, it is the country from which the affairs of that company are directed.</td></tr><tr><td>[0..1]</td><td></td><td>+++ContactDetails</td><td>&#x3C;CtctDtls></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>++CreditorAccount</td><td>&#x3C;CdtrAcct></td><td>Creditor’s account.</td></tr><tr><td>[0..1]</td><td></td><td>+++Identification</td><td>&#x3C;Id></td><td>Unique and unambiguous identification for the account between the account owner and the account servicer.</td></tr><tr><td>[1..1]</td><td>{Or</td><td>++++IBAN</td><td>&#x3C;IBAN></td><td><strong>Not used</strong></td></tr><tr><td>[1..1]</td><td>Or}</td><td>++++Other</td><td>&#x3C;Othr></td><td></td></tr><tr><td>[1..1]</td><td></td><td>+++++Identification</td><td>&#x3C;Id></td><td><strong>Mandatory.</strong> Identification assigned by an institution. Creditor's account number, BBAN.</td></tr><tr><td>[0..1]</td><td></td><td>+++++SchemeName</td><td>&#x3C;SchmeNm></td><td></td></tr><tr><td>[1..1]</td><td>{Or</td><td>++++++Code</td><td>&#x3C;Cd></td><td>Name of the identification scheme, always '<strong>BBAN</strong>'</td></tr><tr><td>[1..1]</td><td>Or}</td><td>++++++Proprietary</td><td>&#x3C;Prtry></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>+++++Issuer</td><td>&#x3C;Issr></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>+++Type</td><td>&#x3C;Tp></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>+++Currency</td><td>&#x3C;Ccy></td><td>Identification of the currency in which the account is held, always '<strong>GBP</strong>'.</td></tr><tr><td>[0..1]</td><td></td><td>+++Name</td><td>&#x3C;Nm></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>+++Proxy</td><td>&#x3C;Prxy></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>++CreditorAgent</td><td>&#x3C;CdtrAgt></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>++UltimateCreditor</td><td>&#x3C;UltmtCdtr></td><td><strong>Not used</strong></td></tr><tr><td>[1..1]</td><td></td><td>++Debtor</td><td>&#x3C;Dbtr></td><td><strong>Mandatory.</strong> Party that signs the mandate and owes an amount of money to the creditor</td></tr><tr><td>[0..1]</td><td></td><td>+++Name</td><td>&#x3C;Nm></td><td>Name by which a party is known and which is usually used to identify that party.</td></tr><tr><td>[0..1]</td><td></td><td>+++PostalAddress</td><td>&#x3C;PstlAdr></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>+++Identification</td><td>&#x3C;Id></td><td></td></tr><tr><td>[1..1]</td><td>{Or</td><td>++++OrganisationIdentification</td><td>&#x3C;OrgId></td><td>Unique and unambiguous way to identify an organisation.</td></tr><tr><td>[0..1]</td><td></td><td>+++++AnyBIC</td><td>&#x3C;AnyBIC></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>+++++LEI</td><td>&#x3C;LEI></td><td><strong>Not used</strong></td></tr><tr><td>[0..*]</td><td></td><td>+++++Other</td><td>&#x3C;Othr></td><td>Unique and unambiguous way to identify an organisation.</td></tr><tr><td>[1..1]</td><td></td><td>++++++Identification</td><td>&#x3C;Id></td><td><strong>Mandatory.</strong> Unique identification of an organisation, as assigned by an institution, using an identification scheme.<br>Debtor's bank Service User Number.</td></tr><tr><td>[0..1]</td><td></td><td>++++++SchemeName</td><td>&#x3C;SchmeNm></td><td>Name of the identification scheme.</td></tr><tr><td>[1..1]</td><td>{Or</td><td>+++++++Code</td><td>&#x3C;Cd></td><td>Name of the identification scheme. Always '<strong>BANK</strong>'.</td></tr><tr><td>[1..1]</td><td>Or}</td><td>+++++++Proprietary</td><td>&#x3C;Prtry></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>++++++Issuer</td><td>&#x3C;Issr></td><td><strong>Not used</strong></td></tr><tr><td>[1..1]</td><td>Or}</td><td>++++PrivateIdentification</td><td>&#x3C;PrvtId></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>+++CountryOfResidence</td><td>&#x3C;CtryOfRes></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>+++ContactDetails</td><td>&#x3C;CtctDtls></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>++DebtorAccount</td><td>&#x3C;DbtrAcct></td><td>Debtor's account</td></tr><tr><td>[0..1]</td><td></td><td>+++Identification</td><td>&#x3C;Id></td><td>Unique and unambiguous identification for the account between the account owner and the account servicer.</td></tr><tr><td>[1..1]</td><td>{Or</td><td>++++IBAN</td><td>&#x3C;IBAN></td><td><strong>Not used</strong></td></tr><tr><td>[1..1]</td><td>Or}</td><td>++++Other</td><td>&#x3C;Othr></td><td></td></tr><tr><td>[1..1]</td><td></td><td>+++++Identification</td><td>&#x3C;Id></td><td><strong>Mandatory.</strong> Identification assigned by an institution. Debtor's account number, BBAN.</td></tr><tr><td>[0..1]</td><td></td><td>+++++SchemeName</td><td>&#x3C;SchmeNm></td><td></td></tr><tr><td>[1..1]</td><td>{Or</td><td>++++++Code</td><td>&#x3C;Cd></td><td>Name of the identification scheme, always '<strong>BBAN</strong>'</td></tr><tr><td>[1..1]</td><td>Or}</td><td>++++++Proprietary</td><td>&#x3C;Prtry></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>+++++Issuer</td><td>&#x3C;Issr></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>+++Type</td><td>&#x3C;Type></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>+++Currency</td><td>&#x3C;Ccy></td><td>Identification of the currency in which the account is held, always '<strong>GBP</strong>'.</td></tr><tr><td>[0..1]</td><td></td><td>+++Name</td><td>&#x3C;Nm></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>+++Proxy</td><td>&#x3C;Prxy></td><td><strong>Not used</strong></td></tr><tr><td>[1..1]</td><td></td><td>++DebtorAgent</td><td>&#x3C;DbtrAgt></td><td><p><strong>Mandatory.</strong> Financial institution servicing an account for the debtor.</p><p>PSP - holder of the master account.</p></td></tr><tr><td>[1..1]</td><td></td><td>+++FinancialInstitutionIdentification</td><td>&#x3C;FinInstnId></td><td><strong>Mandatory.</strong> Unique and unambiguous identification of a financial institution, as assigned under an internationally recognised or proprietary identification scheme.</td></tr><tr><td>[0..1]</td><td></td><td>++++BICFI</td><td>&#x3C;BICFI></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>++++ClearingSystemMemberIdentification</td><td>&#x3C;ClrSysMmbId></td><td></td></tr><tr><td>[0..1]</td><td></td><td>+++++ClearingSystemIdentification</td><td>&#x3C;ClrSysId></td><td></td></tr><tr><td>[1..1]</td><td>{Or</td><td>++++++Code</td><td>&#x3C;Cd></td><td>Identification of a clearing system, always '<strong>GBDSC</strong>'</td></tr><tr><td>[1..1]</td><td>Or}</td><td>++++++Proprietary</td><td>&#x3C;Prtry></td><td><strong>Not used</strong></td></tr><tr><td>[1..1]</td><td></td><td>+++++Member Identification</td><td>&#x3C;MmbId></td><td><strong>Mandatory.</strong> Debtor party sort code. First 6 numbers from Debtor's account number.</td></tr><tr><td>[0..1]</td><td></td><td>++++LEI</td><td>&#x3C;LEI></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>++++Name</td><td>&#x3C;Nm></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>++++PostalAddress</td><td>&#x3C;PstlAdr></td><td><strong>Not used</strong></td></tr><tr><td>[1..1]</td><td></td><td>++++Other</td><td>&#x3C;Othr></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>+++BranchIdentification</td><td>&#x3C;BrnchId></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>++UltimateDebtor</td><td>&#x3C;UltmtDbtr></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>++MandateReference</td><td>&#x3C;MndRef></td><td><strong>Not used</strong></td></tr><tr><td>[0..*]</td><td></td><td>++ReferredDocument</td><td>&#x3C;RfrdDoc></td><td><strong>Not used</strong></td></tr><tr><td>[0..*]</td><td></td><td>++SupplementaryData</td><td>&#x3C;SplmtryData></td><td><strong>Not used</strong></td></tr></tbody></table>

<br>
