Payment Initiation
Last updated
Last updated
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.
| Name | Value |
|---|---|
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
Headers
Request accepted - no content
Response message is created and can be requests by the Messages services - Messages Services
HTTP Header Message-Response-Type: PAYMENT
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.
List of different payment cases and scenarios are covered - with related request and response messages: Samples
Error codes
Service specific errors
| Name | Value |
|---|---|
Full details covered at
| ERROR CODE | DESCRIPTION |
|---|---|
Content-Type
application/xml
Client-Code
customer value
Client-Country
customer value
Content-Type
application/xml
X-Bank-Code
LHVUK, LHVEE
errStatement_NoAccess
No access to the account.
errStatement_RequestInvalid
Request message fails xsd validation.