Payment Initiation

Payment Initiation - Request

POST https://connect.lhv.com/payment

Request message format is Customer to bank Payment Initiation (pain.001 message) that covers SEPA, SEPA Instant, UK Faster Payments and other payments schemes and types available at LHV Pank or LHV Bank. One payment initiation message may contain up to 1500 single payments.

Payment Status Report (pain.002) is returned to inform about the status of imported payments. More than one status may be returned for one payment.

Headers

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

Body

Currently we are supporting following versions of the pain.001 format XML file:

• pain.001.001.09 format - new and default to use

• pain.001.001.03 format - older and phased out soon

Response

Headers

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

Body

202

Request accepted - no content

403

Error code and description

<Errors>
    <Error>
        <ErrorCode>FORBIDDEN</ErrorCode>
        <Description>User doesn't exist</Description>
    </Error>
</Errors>

Response message

Response message is created and can be requests by the Messages services - Messages Services

HTTP Header Message-Response-Type: PAYMENT

Body

Common format for Payment Initiation responses is pain.001.* of the ISO 20022 standard.

Exact message version depends on the message used to initialize the original payment.

• If payment is initialized with new pain.001.001.09 then new pain.002.001.10 is provided in response.

• If payment is initialized with old pain.001.001.03, then old pain.002.001.03 is provided in response.

Full details covered at XML format (ISO 20022 Customer Payment Status Report pain.002)

Samples

List of different payment cases and scenarios are covered - with related request and response messages: Samples

Error codes

Service specific errors

ERROR CODE	DESCRIPTION
errStatement_NoAccess	No access to the account.
errStatement_RequestInvalid	Request message fails xsd validation.