> For the complete documentation index, see [llms.txt](https://docs.lhv.com/home/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.lhv.com/home/connect/services/indirect-scheme-access/payment-collection-services/bacs-direct-debit/bacs-direct-debit-mandate-cancellation-request.md).

# Bacs Direct Debit Mandate Cancellation Request

{% hint style="warning" %} <mark style="color:$warning;">**Please do not initiate a mandate cancellation request before the mandate has actually been activated.**</mark> <mark style="color:$warning;"></mark><mark style="color:$warning;">Mandate activation occurs by the end of Day 3, no later than 18:35 UK local time.</mark>
{% endhint %}

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

<table><thead><tr><th>Name</th><th>Value</th><th data-hidden></th></tr></thead><tbody><tr><td>Content-Type</td><td><code>application/xml</code></td><td></td></tr><tr><td>Client-Code</td><td><code>customer value</code></td><td></td></tr><tr><td>Client-Country</td><td><code>customer value</code></td><td></td></tr></tbody></table>

### Body

[pain.011.001.07 MandateCancellationRequestV07](#xml-format-pain.011.001.07)

## Response

### Headers

<table><thead><tr><th>Name</th><th>Value</th><th data-hidden></th></tr></thead><tbody><tr><td>Content-Type</td><td><code>application/xml</code></td><td></td></tr><tr><td>X-Bank-Code</td><td><code>LHVUK</code></td><td></td></tr></tbody></table>

### Body

{% tabs %}
{% tab title="202" %}
{% hint style="success" %}
Request accepted - no content
{% endhint %}
{% endtab %}

{% tab title="403" %}
{% hint style="danger" %}
Error code and description
{% endhint %}

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

{% endtab %}
{% endtabs %}

## XML Format pain.011.001.07

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

{% file src="/files/nveDkW36XzXLcQC2qDfW" %}

See the Examples section for a [pain.011.001.07](/home/connect/services/indirect-scheme-access/payment-collection-services/bacs-direct-debit/samples.md#example-of-mandate-cancellation-request) message.

### Message structure

<table data-full-width="false"><thead><tr><th width="90.5">MULT.</th><th width="269.5">MESSAGE ELEMENT</th><th width="181.75">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>+UnderlyingCancellationDetails</td><td>&#x3C;UndrlygCxlDtls></td><td><strong>Mandatory</strong> and repeatable. Set of elements used to provide details on the cancellation request.</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 <a href="#message-root" id="message-root"></a>

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

### Group Header <a href="#group-header" id="group-header"></a>

<table data-full-width="false"><thead><tr><th width="112.75">MULT.</th><th width="67.5">OR</th><th>MESSAGE ELEMENT</th><th width="185.25">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>

### Underlying Cancellation Details <a href="#underlying-cancellation-details" id="underlying-cancellation-details"></a>

<table data-full-width="false"><thead><tr><th width="112.75">MULT.</th><th width="61.5">OR</th><th>MESSAGE ELEMENT</th><th width="183.5">XML TAG</th><th>COMMENT</th></tr></thead><tbody><tr><td>[1..*]</td><td> </td><td>+UnderlyingCancellationDetails</td><td>&#x3C;UndrlygCxlDtls></td><td><strong>Mandatory</strong> and repeatable. Set of elements used to provide details on the cancellation request.</td></tr><tr><td>[0…1]</td><td> </td><td>++OriginalMessageInformation</td><td>&#x3C;OrgnlMsgInf></td><td>Provides information on the original message.</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 original initiating party, to unambiguously identify the original mandate request message.</td></tr><tr><td>[1..1]</td><td> </td><td>+++MessageNameIdentification</td><td>&#x3C;MsgNmId></td><td><strong>Mandatory.</strong> Specifies the message name identifier to which the message refers. <br>Always <strong>'pain.009.001.07'</strong>.</td></tr><tr><td>[1..1]</td><td></td><td>+++CreationDateTime</td><td>&#x3C;CreDtTm></td><td>Date and time at which the message was created.</td></tr><tr><td>[1..1]</td><td> </td><td>++CancellationReason</td><td>&#x3C;CxlRsn></td><td><strong>Mandatory.</strong> Provides detailed information on the cancellation reason.</td></tr><tr><td>[0..1]</td><td> </td><td>+++Originator </td><td>&#x3C;Orgtr></td><td><strong>Not used</strong></td></tr><tr><td>[1..1]</td><td> </td><td>+++Reason</td><td>&#x3C;Rsn></td><td><strong>Mandatory.</strong> Specifies the reason for the cancellation request.</td></tr><tr><td>[1..1]</td><td>{Or</td><td>++++Code</td><td>&#x3C;Cd></td><td><a href="/pages/pC3okS66zp8T8ITo9WEX#mandate-cancellation-codes">Code set: Bacs Direct Debit Mandate Reject Codes.</a></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…*]</td><td> </td><td>+++AdditionalInformation</td><td>&#x3C;AddtlInf></td><td><strong>Not used</strong></td></tr><tr><td>[1..1]</td><td> </td><td>++OriginalMandate</td><td>&#x3C;OrgnlMndt></td><td><strong>Mandatory.</strong> Provides the original mandate data.</td></tr><tr><td>[1..1]</td><td>{Or</td><td>+++OriginalMandateIdentification</td><td>&#x3C;OrgnlMndtId></td><td>Unique identification, as assigned by the responsible party, to unambiguously identify the original mandate.<br>Mndt.MndtId from original pain.009.</td></tr><tr><td>[1..1]</td><td>Or}</td><td>+++OriginalMandate</td><td>&#x3C;OrgnlMndt></td><td>Provides the original mandate data.</td></tr><tr><td>[1..1]</td><td></td><td>++++MandateIdentification</td><td>&#x3C;MndtId></td><td><strong>Mandatory.</strong> Unique identification, as assigned by the responsible party (such as the creditor) or agent (such as the debtor agent), to unambiguously identify the mandate.</td></tr><tr><td>[0..1]</td><td></td><td>++++MandateRequestIdentification</td><td>&#x3C;MndtReqId></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>++++Authentication</td><td>&#x3C;Authntcn></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></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. Default value is False.</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>+++++Postal Address</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><strong>Not used</strong></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. 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>++++Ultimate Creditor</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><strong>Not used</strong></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>++++++++Scheme Name</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>+++++ContactDetail</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;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>[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<br></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>+++++++MemberIdentification</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>++++Mandate Reference</td><td>&#x3C;MndtRef></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>++++Referred Document</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>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.lhv.com/home/connect/services/indirect-scheme-access/payment-collection-services/bacs-direct-debit/bacs-direct-debit-mandate-cancellation-request.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
