> 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-collection-notification-response.md).

# Direct Debit Collection Notification Response

## Request

`POST` <https://connect.lhv.com/direct-debit/bacs-collection-reject>

The request message format is a ISO 20022 Customer Payment Status Report XML (pain.002 message)

### 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.002.001.14 CustomerPaymentStatusReportV14](#xml-format-pain.002.001.14)

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

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

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

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

### Message structure

<table data-full-width="false"><thead><tr><th>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>+OriginalGroupInformationAndStatus</td><td>&#x3C;OrgnlGrpInfAndSts></td><td><strong>Mandatory.</strong> Original group information concerning the group of transactions, to which the status report message refers to.</td></tr><tr><td>[0..*]</td><td>+OriginalPaymentInformationAndStatus</td><td>&#x3C;OrgnlPmtInfAndSts></td><td><strong>Mandatory</strong> and repeatable. Information concerning the original payment information, to which the status report message refers.</td></tr><tr><td>[1..*]</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**

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

### **Group header**

<table data-full-width="false"><thead><tr><th>MULT.</th><th>OR</th><th>MESSAGE ELEMENT</th><th>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, assigned by the instructing party and sent to the next party in the chain, 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>[1..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>++ForwardingAgent</td><td>&#x3C;FwdgAgt></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>++DebtorAgent</td><td>&#x3C;DbtrAgt></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></tbody></table>

### Original Group Information And Status

<table data-full-width="false"><thead><tr><th>MULT.</th><th>OR</th><th>MESSAGE ELEMENT</th><th>XML TAG</th><th>COMMENT</th></tr></thead><tbody><tr><td>[1..1]</td><td></td><td>+OriginalGroupInformationAndStatus</td><td>&#x3C;OrgnlGrpInfAndSts></td><td><strong>Mandatory</strong>, occurs once. Original group information concerning the group of transactions, to which the status report message refers to.</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><strong>Not used</strong></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 message.</td></tr><tr><td>[0..1]</td><td></td><td>++OriginalControlSum<br></td><td>&#x3C;OrgnlCtrlSum></td><td>Total of all individual amounts included in the original message, irrespective of currencies.</td></tr><tr><td>[0..1]</td><td></td><td>++GroupStatus</td><td>&#x3C;GrpSts></td><td>Specifies the status of a group of transactions. <a href="/pages/xyKEhjI9DlNqjo8acNzC#group-level-statuses-in-pain.002">See possible statuses</a>.</td></tr><tr><td>[0..*]</td><td></td><td>++StatusReasonInformation<br></td><td>&#x3C;StsRsnInf></td><td>Provides detailed information on the status 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 status report.</td></tr><tr><td>[1..1]</td><td>{Or</td><td>++++Code</td><td>&#x3C;Cd></td><td>Reason for the status. If Group Status is RJCT, then mandatory. <a href="/pages/xyKEhjI9DlNqjo8acNzC#status-reasons">See list of possible 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>Further details on the status reason.</td></tr><tr><td>[0..*]</td><td></td><td>++NumberOfTransactionsPerStatus</td><td>&#x3C;NbOfTxsPerSts></td><td><strong>Not used</strong></td></tr></tbody></table>

### Original Payment Information And Status

<table data-full-width="false"><thead><tr><th>MULT.</th><th>OR</th><th>MESSAGE ELEMENT</th><th>XML TAG</th><th>COMMENT</th></tr></thead><tbody><tr><td>[0..*]</td><td></td><td>+OriginalPaymentInformationAndStatus</td><td>&#x3C;OrgnlPmtInfAndSts></td><td><strong>Mandatory</strong> and repeatable. Information concerning the original payment information, to which the status report message refers.</td></tr><tr><td>[1..1]</td><td></td><td>++OriginalPaymentInformationIdentification</td><td>&#x3C;OrgnlPmtInfId></td><td><p><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.</p><p>Refere to the AcctSvcrRef value in the <a href="/pages/G5QAj0DHQkUnPnyyY2xu">camt.054</a> message.</p></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.</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, irrespective of currencies.</td></tr><tr><td>[0..1]</td><td></td><td>++PaymentInformationStatus</td><td>&#x3C;PmtInfSts></td><td>Specifies the status of the payment information group. <a href="/pages/xyKEhjI9DlNqjo8acNzC#group-level-statuses-in-pain.002">See possible statuses.</a></td></tr><tr><td>[0..*]</td><td></td><td>++StatusReasonInformation</td><td>&#x3C;StsRsnInf></td><td>Provides detailed information on the status 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 status report.</td></tr><tr><td>[1..1]</td><td>{Or</td><td>++++Code</td><td>&#x3C;Cd></td><td>Reason for the status. If Group Status is RJCT, then mandatory. <a href="/pages/xyKEhjI9DlNqjo8acNzC#status-reasons">See list of possible 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>Further details on the status reason.</td></tr><tr><td>[0..*]</td><td></td><td>++NumberOfTransactionsPerStatus</td><td>&#x3C;NbOfTxsPerSts></td><td><strong>Not used</strong></td></tr><tr><td>[0..*]</td><td></td><td>++TransactionInformationAndStatus</td><td>&#x3C;TxInfAndSts></td><td>Provides information on the original transactions to which the status report message refers.</td></tr><tr><td>[0..1]</td><td></td><td>+++StatusIdentification<br></td><td>&#x3C;StsId></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>+++OriginalInstructionIdentification</td><td>&#x3C;OrgnlInstrId></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>+++OriginalEndToEndIdentification</td><td>&#x3C;OrgnlEndToEndId></td><td>Unique identification, as assigned by the original initiating party, to unambiguously identify the original transaction. DrctDbtTxInf.PmtId.EndToEndId from original pain.008.</td></tr><tr><td>[0..1]</td><td></td><td>+++OriginalUETR</td><td>&#x3C;OrgnlUETR></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>+++TransactionStatus</td><td>&#x3C;TxSts></td><td>Specifies the status of a transaction. <a href="/pages/xyKEhjI9DlNqjo8acNzC#single-payment-statuses-in-pain.002">See list of possible codes.</a></td></tr><tr><td>[0..1]</td><td></td><td>+++StatusReasonInformation<br></td><td>&#x3C;StsRsnInf></td><td>Provides detailed information on the status reason.</td></tr><tr><td>[0..1]</td><td></td><td>++++Originator</td><td>&#x3C;Orgtr></td><td>Party that issues the status.</td></tr><tr><td>[0..1]</td><td></td><td>++++Reason</td><td>&#x3C;Rsn></td><td>Specifies the reason for the status report.</td></tr><tr><td>[1..1]</td><td>{Or</td><td>+++++Code</td><td>&#x3C;Cd></td><td>Reason for the status. If Group Status is RJCT, then mandatory. <a href="/pages/xyKEhjI9DlNqjo8acNzC#status-reasons">See list of possible 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>Further details on the status reason.</td></tr><tr><td>[0..*]</td><td></td><td>+++ChargesInformation</td><td>&#x3C;ChrgsInf></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>+++Tracker Data</td><td>&#x3C;TrckrData></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>+++Acceptance Date Time</td><td>&#x3C;AccptncDtTm></td><td>Point in time when the payment order from the initiating party meets the processing conditions of the account servicing agent. This means that the account servicing agent has received the payment order and has applied checks such as authorisation, availability of funds.</td></tr><tr><td>[0..1]</td><td></td><td>+++Account Servicer Reference</td><td>&#x3C;AcctSvcrRef></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>+++Clearing System Reference</td><td>&#x3C;ClrSysRef></td><td><strong>Not used</strong></td></tr><tr><td>[0..1]</td><td></td><td>+++Original Transaction Reference</td><td>&#x3C;OrgnlTxRef></td><td><strong>Not used</strong></td></tr><tr><td>[0..*]</td><td></td><td>+++Supplementary Data</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/direct-debit-collection-notification-response.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.