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 UK Faster Payments and other payments schemes and types available at LHV Bank.

LHV EE Payment services details are covered at https://partners.lhv.ee/en/connect/#payment-initiation

While LHV UK and EE services are mostly similar and using also similar file formats there are differences in details.

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:

Response

Headers

Name
Value

Content-Type

application/xml

X-Bank-Code

LHVUK, LHVEE

Body

Request accepted - no content

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.

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.

Last updated