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.009.001.07
  • Message structure
  • Message root
  • Group Header
  • Mandate

Was this helpful?

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

Bacs Direct Debit Mandate Initiation Request

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

PreviousBacs Direct DebitNextBacs Direct Debit Mandate Initiation Response

Last updated 1 month ago

Was this helpful?

Incoming Mandate Initiation Requests can be requested via the .

HTTP Header Message-Response-Type: DIRECT_DEBIT_MANDATE_INITIATION

XML Format pain.009.001.07

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

See the Examples section for a message.

Message structure

MULT.
MESSAGE ELEMENT
XML TAG
COMMENT

[1..1]

+GroupHeader

<GrpHdr>

Mandatory, occurs once.

[1..*]

+Mandate

<Mndt>

Mandatory and repeatable. Set of elements used to provide the details of the mandate signed between the creditor and the debtor.

[0..*]

+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

<MndtInitnReq>

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, as assigned by the instructing party, and sent to the instructed party, 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

[0..1]

++InitiatingParty

<InitgPty>

Not used

[0..1]

++InstructingAgent

<InstgAgt>

Not used

[0..1]

++InstructedAgent

<InstdAgt>

Not used

Mandate

MULT.
OR
MESSAGE ELEMENT
XML TAG
COMMENT

[1..*]

+Mandate

<Mndt>

Mandatory and repeatable. Set of elements used to provide the details of the mandate signed between the creditor and the debtor.

[0..*]

++MandateIdentification

<MndtId>

Unique identification, as assigned by the responsible party, to unambiguously identify the mandate

[1..1]

++MandateRequestIdentification

<MndtReqId>

Mandatory. Identification for the mandate request, as assigned by the initiating party.

[0..2]

++Authorisation

<Authstn>

Not used

[0..1]

++Type

<Tp>

Not used

[0..1]

++Occurrences

<Ocrncs<

Provides details of the duration of the mandate and occurrence of the underlying transactions.

[1..1]

+++SequenceType

<SeqTp>

Mandatory. Identifies the underlying transaction sequence as either recurring or one-off. Always 'RCUR'

[0..1]

+++Frequency

<Frqcy>

Regularity with which instructions are to be created and processed.

[1..1]

{Or

++++Type

<Tp>

Specifies a frequency in terms of a specified period type. DAIL - daily

WEEK - weekly

FRTN - Fortnightly

MNTH - monthly

ADHO - bimothly (Event takes place on request or as necessary)

QURT - quarterly

YEAR - annual

[1..1]

or

++++Period

<Prd>

Not used

[1..1]

Or}

++++PointInTime

<PtInTm>

Not used

[0..1]

+++Duration

<Drtn>

Not used

[0..1]

+++FirstCollectionDate

<FrstColltnDt>

Not used

[0..1]

+++FinalCollectionDate

<FnlColltnDt>

Not used

[1..1]

++TrackingIndicator

<TrckgInd>

Mandatory. Specifies whether the direct debit instructions should be automatically re-submitted periodically when bilaterally agreed. True/False indicator. Always False.

[0..1]

++FirstCollectionAmount

<FrstColltnAmt>

Not used

[0..1]

++CollectionAmount

<ColltnAmt>

Not used

[0..1]

++MaximumAmount

<MaxAmt>

Not used

[0..1]

++Adjustment

<Adjstmnt>

Not used

[0..1]

++Reason

<Rsn>

Not used

[0..1]

++CreditorSchemeIdentification

<CdtrSchmeId>

Not used

[1..1]

++Creditor

<Cdtr>

Mandatory. Party that signs the mandate and to whom an amount of money is due.

[0..1]

+++Name

<Nm>

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>

Unique and unambiguous identification of a party.

[1..1]

{Or

++++OrganisationIdentification

<OrgId>

Unique and unambiguous way to identify an organisation.

[0..1]

+++++AnyBIC

<AnyBIC>

Not used

[0..1]

+++++LEI

<LEI>

Not used

[0..*]

+++++Other

<Othr>

Unique identification of an organisation, as assigned by an institution, using an identification scheme.

[1..1]

++++++Identification

<Id>

Mandatory. Identification assigned by an institution. Creditor's Service User Number.

[0..1]

++++++SchemeName

<SchmeNm>

Name of the identification scheme.

[1..1]

{Or

+++++++Code

<Cd>

Name of the identification scheme. Always 'BANK'.

[1..1]

Or}

+++++++Proprietary

<Prtry>

Not used

[0..1]

++++++Issuer

<Issr>

Not used

[1..1]

Or}

++++PrivateIdentification

<PrvtId>

Not used

[0..1]

+++CountryOfResidence

<CtryOfRes>

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.

[0..1]

+++ContactDetails

<CtctDtls>

Not used

[0..1]

++CreditorAccount

<CdtrAcct>

Creditorโ€™s account.

[0..1]

+++Identification

<Id>

Unique and unambiguous identification for the account between the account owner and the account servicer.

[1..1]

{Or

++++IBAN

<IBAN>

Not used

[1..1]

Or}

++++Other

<Othr>

[1..1]

+++++Identification

<Id>

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

[0..1]

+++++SchemeName

<SchmeNm>

[1..1]

{Or

++++++Code

<Cd>

Name of the identification scheme, always '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

[0..1]

++CreditorAgent

<CdtrAgt>

Not used

[0..1]

++UltimateCreditor

<UltmtCdtr>

Not used

[1..1]

++Debtor

<Dbtr>

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

[0..1]

+++Name

<Nm>

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>

[1..1]

{Or

++++OrganisationIdentification

<OrgId>

Unique and unambiguous way to identify an organisation.

[0..1]

+++++AnyBIC

<AnyBIC>

Not used

[0..1]

+++++LEI

<LEI>

Not used

[0..*]

+++++Other

<Othr>

Unique and unambiguous way to identify an organisation.

[1..1]

++++++Identification

<Id>

Mandatory. Unique identification of an organisation, as assigned by an institution, using an identification scheme. Debtor's bank Service User Number.

[0..1]

++++++SchemeName

<SchmeNm>

Name of the identification scheme.

[1..1]

{Or

+++++++Code

<Cd>

Name of the identification scheme. Always 'BANK'.

[1..1]

Or}

+++++++Proprietary

<Prtry>

Not used

[0..1]

++++++Issuer

<Issr>

Not used

[1..1]

Or}

++++PrivateIdentification

<PrvtId>

Not used

[0..1]

+++CountryOfResidence

<CtryOfRes>

Not used

[0..1]

+++ContactDetails

<CtctDtls>

Not used

[0..1]

++DebtorAccount

<DbtrAcct>

Debtor's account

[0..1]

+++Identification

<Id>

Unique and unambiguous identification for the account between the account owner and the account servicer.

[1..1]

{Or

++++IBAN

<IBAN>

Not used

[1..1]

Or}

++++Other

<Othr>

[1..1]

+++++Identification

<Id>

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

[0..1]

+++++SchemeName

<SchmeNm>

[1..1]

{Or

++++++Code

<Cd>

Name of the identification scheme, always 'BBAN'

[1..1]

Or}

++++++Proprietary

<Prtry>

Not used

[0..1]

+++++Issuer

<Issr>

Not used

[0..1]

+++Type

<Type>

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]

++DebtorAgent

<DbtrAgt>

Mandatory. Financial institution servicing an account for the debtor.

PSP - holder of the master account.

[1..1]

+++FinancialInstitutionIdentification

<FinInstnId>

Mandatory. Unique and unambiguous identification of a financial institution, as assigned under an internationally recognised or proprietary identification scheme.

[0..1]

++++BICFI

<BICFI>

Not used

[0..1]

++++ClearingSystemMemberIdentification

<ClrSysMmbId>

[0..1]

+++++ClearingSystemIdentification

<ClrSysId>

[1..1]

{Or

++++++Code

<Cd>

Identification of a clearing system, always 'GBDSC'

[1..1]

Or}

++++++Proprietary

<Prtry>

Not used

[1..1]

+++++Member Identification

<MmbId>

Mandatory. Debtor party sort code. First 6 numbers from Debtor's account number.

[0..1]

++++LEI

<LEI>

Not used

[0..1]

++++Name

<Nm>

Not used

[0..1]

++++PostalAddress

<PstlAdr>

Not used

[1..1]

++++Other

<Othr>

Not used

[0..1]

+++BranchIdentification

<BrnchId>

Not used

[0..1]

++UltimateDebtor

<UltmtDbtr>

Not used

[0..1]

++MandateReference

<MndRef>

Not used

[0..*]

++ReferredDocument

<RfrdDoc>

Not used

[0..*]

++SupplementaryData

<SplmtryData>

Not used

๐Ÿ“–
๐Ÿ”—
๐Ÿงพ
๐Ÿ’ท
Messages service
pain.009.001.07
33KB
pain.009.001.07.xsd