> 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

Description of Incoming BACS Mandated Cancelled Notification service.

## 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
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=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
