Direct Debit Collection Notification Response

The ISO 20022 Customer Payment Status Report is sent to LHV by the customer to accept or reject Incoming Collection Initiation Request.

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

Name	Value
Content-Type	application/xml
Client-Code	customer value
Client-Country	customer value

Body

pain.002.001.14 CustomerPaymentStatusReportV14

Response

Headers

Name	Value
Content-Type	application/xml
X-Bank-Code	LHVUK

Body

202

Request accepted - no content

403

Error code and description

<Errors>
    <Error>
        <ErrorCode>FORBIDDEN</ErrorCode>
        <Description>Description</Description>
    </Error>
</Errors>

XML Format pain.002.001.14

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

61KB

pain.002.001.14.xsd

See the Examples section for a pain.002.001.14 message.

Message structure

MULT.	MESSAGE ELEMENT	XML TAG	COMMENT
[1..1]	+GroupHeader	<GrpHdr>	Mandatory, occurs once.
[1..1]	+OriginalGroupInformationAndStatus	<OrgnlGrpInfAndSts>	Mandatory. Original group information concerning the group of transactions, to which the status report message refers to.
[0..*]	+OriginalPaymentInformationAndStatus	<OrgnlPmtInfAndSts>	Mandatory and repeatable. Information concerning the original payment information, to which the status report message refers.
[1..*]	+SupplementaryData	<SplmtryData>	Not used. Additional information that cannot be captured in the structured elements and/or any other specific block.

Message root

MULT.	MESSAGE ELEMENT	XML TAG	COMMENT
[1..1]	+MessageRoot	<CstmrPmtStsRpt>	Mandatory, occurs once.

Group header

MULT.	OR	MESSAGE ELEMENT	XML TAG	COMMENT
[1..1]		+GroupHeader	<GrpHdr>	Mandatory, occurs once.
[1..1]		++MessageIdentification	<MsgId>	Mandatory. Point to point reference, assigned by the instructing party and sent to the next party in the chain, to unambiguously identify the message.
[1..1]		++CreationDateTime	<CreDtTm>	Mandatory. Date and time at which the message was created.
[1..1]		++InitiatingParty	<InitgPty>	Not used
[0..1]		++ForwardingAgent	<FwdgAgt>	Not used
[0..1]		++DebtorAgent	<DbtrAgt>	Not used
[0..1]		++CreditorAgent	<CdtrAgt>>	Not used

Original Group Information And Status

MULT.	OR	MESSAGE ELEMENT	XML TAG	COMMENT
[1..1]		+OriginalGroupInformationAndStatus	<OrgnlGrpInfAndSts>	Mandatory, occurs once. Original group information concerning the group of transactions, to which the status report message refers to.
[1..1]		++OriginalMessageIdentification	<OrgnlMsgId>	Mandatory. Point to point reference, as assigned by the original instructing party, to unambiguously identify the original message. GrpHdr.MsgId from original pain.008.
[1..1]		++OriginalMessageNameIdentification	<OrgnlMsgNmId>	Mandatory. Specifies the original message name identifier to which the message refers. 'pain.008.001.11'
[0..1]		++OriginalCreationDateTime	<OrgnlCreDtTm>	Not used
[0..1]		++OriginalNumberOfTransactions	<OrgnlNbOfTxs>	Number of individual transactions contained in the original message.
[0..1]		++OriginalControlSum	<OrgnlCtrlSum>	Total of all individual amounts included in the original message, irrespective of currencies.
[0..1]		++GroupStatus	<GrpSts>	Specifies the status of a group of transactions. See possible statuses.
[0..*]		++StatusReasonInformation	<StsRsnInf>	Provides detailed information on the status reason.
[0..1]		+++Originator	<Orgtr>	Not used
[0..1]		+++Reason	<Rsn>	Specifies the reason for the status report.
[1..1]	{Or	++++Code	<Cd>	Reason for the status. If Group Status is RJCT, then mandatory. See list of possible codes.
[1..1]	Or}	++++Proprietary	<Prtry>	Not used
[0..*]		+++AdditionalInformation	<AddtlInf>	Further details on the status reason.
[0..*]		++NumberOfTransactionsPerStatus	<NbOfTxsPerSts>	Not used

Original Payment Information And Status

MULT.	OR	MESSAGE ELEMENT	XML TAG	COMMENT
[0..*]		+OriginalPaymentInformationAndStatus	<OrgnlPmtInfAndSts>	Mandatory and repeatable. Information concerning the original payment information, to which the status report message refers.
[1..1]		++OriginalPaymentInformationIdentification	<OrgnlPmtInfId>	Mandatory. Unique identification, as assigned by the original sending party, to unambiguously identify the original payment information group. PmtInf.PmtInfId from original pain.008.
[0..1]		++OriginalNumberOfTransactions	<OrgnlNbOfTxs>	Number of individual transactions contained in the original payment information group.
[0..1]		++OriginalControlSum	<OrgnlCtrlSum>	Total of all individual amounts included in the original payment information group, irrespective of currencies.
[0..1]		++PaymentInformationStatus	<PmtInfSts>	Specifies the status of the payment information group. See possible statuses.
[0..*]		++StatusReasonInformation	<StsRsnInf>	Provides detailed information on the status reason.
[0..1]		+++Originator	<Orgtr>	Not used
[0..1]		+++Reason	<Rsn>	Specifies the reason for the status report.
[1..1]	{Or	++++Code	<Cd>	Reason for the status. If Group Status is RJCT, then mandatory. See list of possible codes.
[1..1]	Or}	++++Proprietary	<Prtry>	Not used
[0..*]		+++AdditionalInformation	<AddtlInf>	Further details on the status reason.
[0..*]		++NumberOfTransactionsPerStatus	<NbOfTxsPerSts>	Not used
[0..*]		++TransactionInformationAndStatus	<TxInfAndSts>	Provides information on the original transactions to which the status report message refers.
[0..1]		+++StatusIdentification	<StsId>	Not used
[0..1]		+++OriginalInstructionIdentification	<OrgnlInstrId>	Not used
[0..1]		+++OriginalEndToEndIdentification	<OrgnlEndToEndId>	Unique identification, as assigned by the original initiating party, to unambiguously identify the original transaction. DrctDbtTxInf.PmtId.EndToEndId from original pain.008.
[0..1]		+++OriginalUETR	<OrgnlUETR>	Not used
[0..1]		+++TransactionStatus	<TxSts>	Specifies the status of a transaction. See list of possible codes.
[0..1]		+++StatusReasonInformation	<StsRsnInf>	Provides detailed information on the status reason.
[0..1]		++++Originator	<Orgtr>	Party that issues the status.
[0..1]		++++Reason	<Rsn>	Specifies the reason for the status report.
[1..1]	{Or	+++++Code	<Cd>	Reason for the status. If Group Status is RJCT, then mandatory. See list of possible codes.
[1..1]	Or}	+++++Proprietary	<Prtry>	Not used
[0..*]		++++AdditionalInformation	<AddtlInf>	Further details on the status reason.
[0..*]		+++ChargesInformation	<ChrgsInf>	Not used
[0..1]		+++Tracker Data	<TrckrData>	Not used
[0..1]		+++Acceptance Date Time	<AccptncDtTm>	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.
[0..1]		+++Account Servicer Reference	<AcctSvcrRef>	Not used
[0..1]		+++Clearing System Reference	<ClrSysRef>	Not used
[0..1]		+++Original Transaction Reference	<OrgnlTxRef>	Not used
[0..*]		+++Supplementary Data	<SplmtryData>	Not used