# 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="<https://2266620947-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHGywduAxJuxV3reZhASh%2Fuploads%2Ft4nP9yy1xiuLrRluSkx4%2Fpain.011.001.07.xsd?alt=media&token=e6adfa6f-4445-40af-a6ec-b481b9c231d0>" %}

See the Examples section for a [pain.011.001.07](https://docs.lhv.com/home/connect/services/indirect-scheme-access/payment-collection-services/samples#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="../../../../../overview/code-reference-tables/bacs-direct-debit-mandate-reject-codes#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>