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
  • Request
  • Headers
  • Body
  • Response
  • Headers
  • Body
  • XML Format pain.011.001.07
  • Message structure
  • Message root
  • Group Header
  • Underlying Cancellation Details

Was this helpful?

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

Bacs Direct Debit Mandate Cancellation Request

The ISO 20022 Mandate Cancellation Request is sent to the LHV to inform about cancellation of Bacs Direct Debit Mandate.

PreviousBacs Direct Debit Mandate Initiation Response ConfirmationNextBacs Direct Debit Mandate Cancellation Response

Last updated 1 month ago

Was this helpful?

Request

POST https://connect.lhv.com/direct-debit/bacs-mandate-cancel

The request message format is a ISO 20022 Mandate Cancellation Request XML (pain.011 message, see below).

Headers

Name
Value

Content-Type

application/xml

Client-Code

customer value

Client-Country

customer value

Body

Response

Headers

Name
Value

Content-Type

application/xml

X-Bank-Code

LHVUK

Body

Request accepted - no content

Error code and description

<Errors>
    <Error>
        <ErrorCode>FORBIDDEN</ErrorCode>
        <Description>Description</Description>
    </Error>
</Errors>

XML Format pain.011.001.07

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

Message structure

MULT.
MESSAGE ELEMENT
XML TAG
COMMENT

[1..1]

+GroupHeader

<GrpHdr>

Mandatory, occurs once.

[1..*]

+UnderlyingCancellationDetails

<UndrlygCxlDtls>

Mandatory and repeatable. Set of elements used to provide details on the cancellation request.

[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

<MndtCxlReq>

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

Underlying Cancellation Details

MULT.
OR
MESSAGE ELEMENT
XML TAG
COMMENT

[1..*]

+UnderlyingCancellationDetails

<UndrlygCxlDtls>

Mandatory and repeatable. Set of elements used to provide details on the cancellation request.

[0โ€ฆ1]

++OriginalMessageInformation

<OrgnlMsgInf>

Provides information on the original message.

[1..1]

+++MessageIdentification

<MsgId>

Mandatory. Point to point reference, as assigned by the original initiating party, to unambiguously identify the original mandate request message.

[1..1]

+++MessageNameIdentification

<MsgNmId>

Mandatory. Specifies the message name identifier to which the message refers. Always 'pain.009.001.07'.

[1..1]

+++CreationDateTime

<CreDtTm>

Date and time at which the message was created.

[1..1]

++CancellationReason

<CxlRsn>

Mandatory. Provides detailed information on the cancellation reason.

[0..1]

+++Originator

<Orgtr>

Not used

[1..1]

+++Reason

<Rsn>

Mandatory. Specifies the reason for the cancellation request.

[1..1]

{Or

++++Code

<Cd>

[1..1]

Or}

++++Proprietary

<Prtry>

Not used

[0โ€ฆ*]

+++AdditionalInformation

<AddtlInf>

Not used

[1..1]

++OriginalMandate

<OrgnlMndt>

Mandatory. Provides the original mandate data.

[1..1]

{Or

+++OriginalMandateIdentification

<OrgnlMndtId>

Unique identification, as assigned by the responsible party, to unambiguously identify the original mandate. Mndt.MndtId from original pain.009.

[1..1]

Or}

+++OriginalMandate

<OrgnlMndt>

Provides the original mandate data.

[1..1]

++++MandateIdentification

<MndtId>

Mandatory. Unique identification, as assigned by the responsible party (such as the creditor) or agent (such as the debtor agent), to unambiguously identify the mandate.

[0..1]

++++MandateRequestIdentification

<MndtReqId>

Not used

[0..1]

++++Authentication

<Authntcn>

Not used

[0..1]

++++Type

<Tp>

Not used

[0..1]

++++Occurrences

<Ocrncs>

Not used

[1..1]

++++TrackingIndicator

<TrckgInd>

Mandatory. Specifies whether the direct debit instructions should be automatically re-submitted periodically when bilaterally agreed. Default value is 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]

+++++Postal Address

<PstlAdr>

Not used

[0..1]

+++++Identification

<Id>

Not used

[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]

++++Ultimate Creditor

<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>

Not used

[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]

++++++++Scheme Name

<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]

+++++ContactDetail

<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

<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]

++++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]

+++++++MemberIdentification

<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]

++++Mandate Reference

<MndtRef>

Not used

[0..1]

++++Referred Document

<RfrdDoc>

Not used

[0..*]

++SupplementaryData

<SplmtryData>

Not used

See the Examples section for a message.

๐Ÿ“–
๐Ÿ”—
๐Ÿงพ
๐Ÿ’ท
pain.011.001.07 MandateCancellationRequestV07
pain.011.001.07
Code set: Bacs Direct Debit Mandate Reject Codes.
36KB
pain.011.001.07.xsd