> 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/incoming-bacs-credit-notification.md).

# Incoming BACS Mandate Cancelled Notification

## Service Description

The Mandate Cancellation Notification Service provides customers with prompt notification when a Direct Debit Mandate is cancelled by a Service User via AUDDIS (the Automated Direct Debit Instruction Service). This alerts the customer as soon as a cancellation instruction has been processed, rather than customers only discovering the change when an expected payment fails to collect.

This service should be used by the customer to maintain full visibility over their Direct Debit instructions, helping them stay informed of changes made by Service Users and reducing the risk of confusion, missed payments, or unexpected gaps in scheduled collections.

The standard AUDDIS process for managing mandate cancellations remains unchanged. This service complements that process, offering customers an additional layer of awareness whenever a mandate they hold on behalf of their customers is cancelled.

If you would like to subscribe to incoming Bacs notifications, please contact your relationship manager.

### Incoming BACS Mandate Cancelled Notification

Incoming Bacs Mandate Cancelled Notification can be requested via the [Messages Services](/home/connect/services/messages.md).

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

### Body

<table data-header-hidden><thead><tr><th width="353" valign="top"></th><th width="84" valign="top"></th><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Field</td><td valign="top">M/O</td><td valign="top">Description</td></tr><tr><td valign="top">Mandate.Beneficiary</td><td valign="top">M</td><td valign="top">Beneficiary / creditor party details.</td></tr><tr><td valign="top">Mandate.Beneficiary.AccountName</td><td valign="top">M</td><td valign="top">Creditor name stored on the mandate.</td></tr><tr><td valign="top">Mandate.Beneficiary.AccountNumber</td><td valign="top">M</td><td valign="top">Creditor account number part only, without sort code.</td></tr><tr><td valign="top">Mandate.Beneficiary.AccountNumberCode</td><td valign="top">M</td><td valign="top">Always BBAN.</td></tr><tr><td valign="top">Mandate.Beneficiary.Bank</td><td valign="top">M</td><td valign="top">Beneficiary bank details.</td></tr><tr><td valign="top">Mandate.Beneficiary.Bank.BankId</td><td valign="top">M</td><td valign="top">Creditor sort code part of the stored local account number.</td></tr><tr><td valign="top">Mandate.Beneficiary.Bank.BankIdCode</td><td valign="top">M</td><td valign="top">Always GBDSC.</td></tr><tr><td valign="top">Mandate.Debtor</td><td valign="top">M</td><td valign="top">Debtor party details.</td></tr><tr><td valign="top">Mandate.Debtor.AccountName</td><td valign="top">M</td><td valign="top">Debtor name stored on the mandate.</td></tr><tr><td valign="top">Mandate.Debtor.AccountNumber</td><td valign="top">M</td><td valign="top">Debtor account number part only, without sort code</td></tr><tr><td valign="top">Mandate.Debtor.AccountNumberCode</td><td valign="top">M</td><td valign="top">Always BBAN</td></tr><tr><td valign="top">Mandate.Debtor.Bank</td><td valign="top">M</td><td valign="top">Debtor bank details</td></tr><tr><td valign="top">Mandate.Debtor.Bank.BankId</td><td valign="top">M</td><td valign="top">Debtor sort code part of the stored local account number</td></tr><tr><td valign="top">Mandate.Debtor.Bank.BankIdCode</td><td valign="top">M</td><td valign="top">Always GBDSC</td></tr><tr><td valign="top">Mandate.OriginalMandateId</td><td valign="top">M</td><td valign="top">Internal/original mandate identifier</td></tr><tr><td valign="top">Mandate.Reference</td><td valign="top">M</td><td valign="top">Mandate reference</td></tr><tr><td valign="top">Mandate.ClearingId</td><td valign="top">M</td><td valign="top">Service User Number / clearing identifier</td></tr><tr><td valign="top">Status</td><td valign="top">M</td><td valign="top">Mandate status at notification time, for this flow CANCELLED_BY_SCHEME</td></tr><tr><td valign="top">ReasonCode</td><td valign="top">M</td><td valign="top">Always MD17</td></tr><tr><td valign="top">Reason</td><td valign="top">M</td><td valign="top">Always Cancelled by Service User/creditor</td></tr><tr><td valign="top">DateClosed</td><td valign="top">M</td><td valign="top">Date the mandate was closed, formatted as yyyy-MM-dd</td></tr></tbody></table>

#### Example

```json
{
 "Mandate": {
  "Beneficiary": {
   "AccountName": "Creditor Name",
   "AccountNumber": "25677513",
   "AccountNumberCode": "BBAN",
   "Bank": {
    "BankId": "600102",
    "BankIdCode": "GBDSC"
   }
  },
  "Debtor": {
   "AccountName": "Debtor Name",
   "AccountNumber": "20266221",
   "AccountNumberCode": "BBAN",
   "Bank": {
    "BankId": "600102",
    "BankIdCode": "GBDSC"
   }
  },
 "OriginalMandateId": "dfd78e01-de34-4b62-9fb3-e80b992332a3",
 "Reference": "D/1234567890123400",
 "ClearingId": "280421"
 }
 "Status": "CANCELLED_BY_SCHEME",
 "ReasonCode": "MD17",
 "Reason": "Cancelled by Service User/creditor",
 "DateClosed": "2024-02-23"
}
```

Example of the flow

<table data-header-hidden><thead><tr><th valign="top"></th><th valign="top"></th><th valign="top"></th></tr></thead><tbody><tr><td valign="top"><strong>Step</strong></td><td valign="top">Action</td><td valign="top"><strong>Description</strong></td></tr><tr><td valign="top">1</td><td valign="top">Receive Mandate Cancelation</td><td valign="top">LHV receives mandate cancelation from the Bacs scheme. This step confirms that there is an active mandate in the system that can be cancelled</td></tr><tr><td valign="top">2</td><td valign="top">Notification</td><td valign="top">LHV will cancel the Mandate and send a notification to the customer</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/incoming-bacs-credit-notification.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.
