Bacs Direct Debit Mandate Initiation Response

The ISO 20022 Mandate Acceptance Report is sent to the LHV by the customer to accept or reject Mandate Initiation Request.

Request

POST https://connect.lhv.com/direct-debit/bacs-mandate-accept

The request message format is a ISO 20022 Mandate Acceptance Report XML (pain.012 message, see below).

Headers

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

Body

pain.012.001.07 MandateAcceptanceReportV07

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.012.001.07

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

pain.012.001.07.xsd

36KB

Open

See the Examples section for a pain.012.001.07 message.

Message structure

MULT.	MESSAGE ELEMENT	XML TAG	COMMENT
[1..1]	+GroupHeader	<GrpHdr>	Mandatory, occurs once.
[1..*]	+UnderlyingAcceptanceDetails	<Mndt>	Mandatory and repeatable. Provides information on the acceptance or rejection of the mandate request.
[0..*]	+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	<MndtAccptncRpt>	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, as assigned by the instructing party, and sent to the instructed party, to unambiguously identify the message.
[1..1]		++CreationDateTime	<CreDtTm>	Mandatory. Date and time at which the message was created.
[0..2]		++Authorisation	<Authstn>	Not used
[0..1]		++InitiatingParty	<InitgPty>	Not used
[0..1]		++InstructingAgent	<InstgAgt>	Not used
[0..1]		++InstructedAgent	<InstdAgt>	Not used

Underlying Acceptance Details

MULT.	OR	MESSAGE ELEMENT	XML TAG	COMMENT
[1..*]		+UnderlyingAcceptanceDetails	<UndrlygAccptncDtls>	Mandatory and repeatable. Provides information on the acceptance or rejection of the mandate request.
[0..1]		++OriginalMessageInformation	<OrgnlMsgInf>	Provides information on the original message
[1..1]		+++MessageIdentification	<MsgId>	Mandatory. Point to point reference, as assigned by the original initiating party, to unambiguously identify the original mandate request message. In case of response to Mandate Initiation Request GrpHdr.MsgId from original pain.009.
[1..1]		+++MessageNameIdentification	<MsgNmId>	Mandatory. Specifies the message name identifier to which the message refers. In case of response to Mandate Initiation Request 'pain.009.001.07'.
[0..1]		+++CreationDateTime	<CreDtTm>	Date and time at which the message was created.
[1..1]		++AcceptanceResult	<AccptncRslt>	Mandatory. Provides detailed information on the acceptance result.
[1..1]		+++Accepted	<Accptd>	Mandatory. Indicates whether the mandate request was accepted or rejected. Yes No Indicator.
[0..1]		+++RejectReason	<RjctRsn>	Specifies the reason for the rejection of a mandate request. Mandatory in case of rejection.
[1..1]	{Or	++++Code	<Cd>	Code set: Bacs Direct Debit Mandate Reject Codes.
[1..1]	Or}	++++Proprietary	<Prtry>	Not used
[0..*]		+++AdditionalRejectReasonInformation	<AddtlRjctRsnInf>	Further details on the reject reason. Is filled when code value = 'NARR'
[0..1]		++OriginalMandate	<OrgnlMndt>	Provides the original mandate data.
[1..1]	{Or	+++OriginalMandateIdentification	<OrgnlMndtId>	Unique identification, as assigned by the responsible party, to unambiguously identify the original mandate. In case of response to Mandate Initiation Request Mndt.MndtId from original pain.009.
[1..1]	Or}	+++OriginalMandate	<OrgnlMndt>	Not used
[0..*]		++SupplementaryData	<SplmtryData>	Not used