Payment Initiation Services

Payment initiation services enable the execution of outgoing payments from customer accounts.

Payment Initiation Request

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

The request message format is a ISO 20022 Customer Credit Transfer Initiation XML (pain.001 message) which supports UK Faster Payments and various other payment schemes and types available at LHV Bank.

One payment initiation message may contain up to 7000 single payments.

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.

Request

Headers

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

Body

pain.001.001.09 CustomerCreditTransferInitiationV9

We do support older version of payment initiation, pain.001.001.03, but it will be 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>

Payment Initiation Response Message

The Customer Payment Status Report XML (pain.002 message) provides updates on the status of submitted payments. A single payment can have multiple statuses, which means that more than one status may be returned for the same payment.

Pain.002 messages can be requested via the Messages service.

HTTP Header Message-Response-Type: PAYMENT

The specific version of the pain.002 message corresponds to the initiation message used to submit the original payment.

When payment is initiated using pain.001.001.09, then pain.002.001.10 is provided in response. If payment is initiated using the legacy pain.001.001.03 format, the response will be pain.002.001.03.

Samples

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