> 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/direct-debit-reversal-notification.md).

# Direct Debit Reversal Notification Request

Incoming Customer Payment Reversal can be requested via the [Messages service](https://docs.lhv.com/home/connect/services/messages).

{% hint style="info" %}
HTTP Header Message-Response-Type: DIRECT\_DEBIT\_REVERSAL\_NOTIFICATION
{% endhint %}

## XML Format pain.007.001.11

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

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

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

## Message Structure <a href="#message-structure-and-field-mapping" id="message-structure-and-field-mapping"></a>

<table data-full-width="false"><thead><tr><th width="116">MULT.</th><th>MESSAGE ELEMENT</th><th>XML TAG</th><th>COMMENT</th></tr></thead><tbody><tr><td>[1..1]</td><td>Message root</td><td>&#x3C;Document> &#x3C;CstmrPmtRvsl></td><td><strong>Mandatory.</strong> Customer Payment Reversal V11</td></tr><tr><td>[1..1]</td><td>+GroupHeader</td><td>&#x3C;GrpHdr></td><td><strong>Mandatory.</strong> Group Header</td></tr><tr><td>[1..1]</td><td>+OriginalGroupInformation</td><td>&#x3C;OrgnlGrpInf></td><td><strong>Mandatory.</strong> Original Group Information</td></tr><tr><td>[0..*]</td><td>+OriginalPaymentInformationAndReversal</td><td>&#x3C;OrgnlPmtInfAndRvsl></td><td>Original Payment Information And Reversal Information concerning the original payment information, to which the reversal message refers.</td></tr><tr><td>[0..*]</td><td>+SupplementaryData</td><td>&#x3C;SplmtryData></td><td><p><strong>Not used.</strong> Additional information that cannot be captured in the structured elements and/or any other specific block.</p><p>Ignored</p></td></tr></tbody></table>

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

<table data-full-width="false"><thead><tr><th width="113">MULT.</th><th>MESSAGE ELEMENT</th><th>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..1]</td><td>++MessageIdentification</td><td>&#x3C;MsgId></td><td>​<strong>Mandatory.</strong> Message identification.</td></tr><tr><td>[1..1]</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>++Authorisation</td><td>&#x3C;Authstn></td><td><strong>Not used.</strong></td></tr><tr><td>[1..1]</td><td>++NumberOfTransactions</td><td>&#x3C;NbOfTxs></td><td><strong>Mandatory.</strong> Number of individual transactions contained in the message.</td></tr><tr><td>[0..1]</td><td>++ControlSum</td><td>&#x3C;CtrlSum></td><td>Total of all individual amounts included in the message.</td></tr><tr><td>[0..1]</td><td>++GroupReversal</td><td>&#x3C;GrpRvsl></td><td>Indicates whether the reversal applies to the whole group of transactions or to individual transactions within the original group.</td></tr><tr><td>[0..1]</td><td>++InitiatingParty</td><td>&#x3C;InitgPty></td><td><strong>Not used.</strong></td></tr><tr><td>[0..1]</td><td>++ForwardingAgent</td><td>&#x3C;FwdgAgt></td><td><strong>Not used.</strong></td></tr><tr><td>[0..1]</td><td>++DebtorAgent</td><td>&#x3C;DbtrAgt></td><td><strong>Not used.</strong></td></tr><tr><td>[0..1]</td><td>++CreditorAgent</td><td>&#x3C;CdtrAgt></td><td><strong>Not used.</strong></td></tr></tbody></table>

### Original Group Information <a href="#original-group-information" id="original-group-information"></a>

<table data-full-width="false"><thead><tr><th width="98">MULT.</th><th width="70">OR</th><th>MESSAGE ELEMENT</th><th>XML TAG</th><th>COMMENT</th></tr></thead><tbody><tr><td>[1..1]</td><td> </td><td>+OriginalGroupInformation</td><td>&#x3C;OrgnlGrpInf></td><td><strong>Mandatory</strong>, occurs once. Information concerning the original group of transactions, to which the message refers.</td></tr><tr><td>[1..1]</td><td> </td><td>++OriginalMessageIdentification</td><td>&#x3C;OrgnlMsgId></td><td><strong>Mandatory.</strong> Point to point reference, as assigned by the original instructing party, to unambiguously identify the original message. GrpHdr.MsgId from original pain.008</td></tr><tr><td>[1..1]</td><td> </td><td>++OriginalMessageNameIdentification</td><td>&#x3C;OrgnlMsgNmId></td><td><strong>Mandatory.</strong> Specifies the original message name identifier to which the message refers. <strong>‘pain.008.001.11’</strong></td></tr><tr><td>[0..1]</td><td> </td><td>++OriginalCreationDateTime</td><td>&#x3C;OrgnlCreDtTm></td><td>Date and time at which the original message was created.</td></tr><tr><td>[0..*]</td><td> </td><td>++ReversalReasonInformation</td><td>&#x3C;RvslRsnInf></td><td>Provides detailed information on the reversal 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>[0..1]</td><td> </td><td>+++Reason</td><td>&#x3C;Rsn></td><td>Specifies the reason for the reversal.</td></tr><tr><td>[1..1]</td><td>{Or</td><td>++++Code</td><td>&#x3C;Cd></td><td><strong>Not used.</strong></td></tr><tr><td>[1..1]</td><td>Or}</td><td>++++Proprietary</td><td>&#x3C;Prtry></td><td>Reason for the reversal, as published in an <a href="/pages/ilR8dknqJy3g3VpRDMP3">external reason code list.</a> Bacs scheme code</td></tr><tr><td>[0..*]</td><td> </td><td>+++AdditionalInformation</td><td>&#x3C;AddtlInf></td><td>Further details on the reversal reason. Bacs scheme code description. </td></tr></tbody></table>

### Original Payment Information And Reversal <a href="#original-payment-information-and-reversal" id="original-payment-information-and-reversal"></a>

<table data-full-width="false"><thead><tr><th width="94">MULT.</th><th width="76">OR</th><th>MESSAGE ELEMENT</th><th>XML TAG</th><th>COMMENT</th></tr></thead><tbody><tr><td>[0..*]</td><td> </td><td>+OriginalPaymentInformationAndReversal<br><br></td><td>&#x3C;OrgnlPmtInfAndRvsl></td><td>Information concerning the original payment information, to which the reversal message refers.</td></tr><tr><td>[0..1]</td><td> </td><td>++ReversalPaymentInformationIdentification</td><td>&#x3C;RvslPmtInfId></td><td>Unique identification, as assigned by an instructing party for an instructed party, to unambiguously identify the reversed payment information group.</td></tr><tr><td>[1..1]</td><td> </td><td>++OriginalPaymentInformationIdentification</td><td>&#x3C;OrgnlPmtInfId></td><td> <strong>Mandatory.</strong> Unique identification, as assigned by the original sending party, to unambiguously identify the original payment information group. PmtInf.PmtInfId from original pain.008.</td></tr><tr><td>[0..1]</td><td> </td><td>++OriginalNumberOfTransactions</td><td>&#x3C;OrgnlNbOfTxs></td><td>Number of individual transactions contained in the original payment information group. PmtInf.NbOfTxs from original pain.008</td></tr><tr><td>[0..1]</td><td> </td><td>++OriginalControlSum</td><td>&#x3C;OrgnlCtrlSum></td><td>Total of all individual amounts included in the original payment information group. CtrlSum.NbOfTxs from original pain.008</td></tr><tr><td>[0..1]</td><td> </td><td>++BatchBooking</td><td>&#x3C;BtchBookg></td><td><strong>Not used.</strong></td></tr><tr><td>[0..1]</td><td> </td><td>++PaymentInformationReversal</td><td>&#x3C;PmtInfRvsl></td><td><strong>Not used.</strong></td></tr><tr><td>[0..*]</td><td> </td><td>++ReversalReasonInformation</td><td>&#x3C;RvslRsnInf></td><td>Provides detailed information on the reversal 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>[0..1]</td><td> </td><td>+++Reason</td><td>&#x3C;Rsn></td><td>Specifies the reason for the reversal.</td></tr><tr><td>[1..1]</td><td>{Or</td><td>++++Code</td><td>&#x3C;Cd></td><td><strong>Not used.</strong></td></tr><tr><td>[1..1]</td><td>Or}</td><td>++++Proprietary</td><td>&#x3C;Prtry></td><td>Reason for the reversal, as published in an <a href="/pages/ilR8dknqJy3g3VpRDMP3">external reason code list.</a> Bacs scheme code</td></tr><tr><td>[0..*]</td><td> </td><td>+++AdditionalInformation</td><td>&#x3C;AddtlInf></td><td>Further details on the reversal reason. Bacs scheme code description. </td></tr><tr><td>[0..*]</td><td> </td><td>++TransactionInformation</td><td>&#x3C;TxInf></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/direct-debit-reversal-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.