# Payment Initiation Services

## Payment Initiation Request <a href="#virtual-iban-open" id="virtual-iban-open"></a>

<mark style="color:green;">`POST`</mark> <https://connect.lhv.com/payment>

The request message format is a ISO 20022 Customer Credit Transfer Initiation XML ([pain.001 message](/home/connect/services/payments/pain.001.001.09-format.md)) which supports UK Faster Payments and [various other payment schemes and types available at LHV Bank.](/home/connect/services/payments/payment-types-and-scheme-selection.md)

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

{% hint style="info" %}
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.
{% endhint %}

### Request

**Headers**

| Name           | Value                                                                                                                                                                                                                                                      |
| -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Content-Type   | `application/xml`                                                                                                                                                                                                                                          |
| Client-Code    | `customer value`                                                                                                                                                                                                                                           |
| Client-Country | `customer value`                                                                                                                                                                                                                                           |
| X-Bank-Code    | <p><code>LHVUK</code>, <code>LHVEE</code><br>For more information, see  <a data-mention href="/pages/itRjoiSbC0SvpAZ12lTu#override-option-for-lhv-uk-or-lhv-ee-services">/pages/itRjoiSbC0SvpAZ12lTu#override-option-for-lhv-uk-or-lhv-ee-services</a></p> |

#### **Body**

[pain.001.001.09 CustomerCreditTransferInitiationV9](/home/connect/services/payments/pain.001.001.09-format.md)

We do support older version of payment initiation, [pain.001.001.03](/home/connect/services/payments/initiate-a-pending-or-direct-payment/pain.001.001.03-format.md), but it will be phased out soon.

### **Response**

**Headers**

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

#### Body

{% tabs %}
{% tab title="202" %}
{% hint style="success" %}
Request accepted - no content
{% endhint %}
{% endtab %}

{% tab title="403" %}
{% hint style="danger" %}
Error code and description
{% endhint %}

<pre><code>&#x3C;Errors>
<strong>    &#x3C;Error>
</strong>        &#x3C;ErrorCode>FORBIDDEN&#x3C;/ErrorCode>
        &#x3C;Description>User doesn't exist&#x3C;/Description>
    &#x3C;/Error>
&#x3C;/Errors>
</code></pre>

{% endtab %}
{% endtabs %}

## Payment Initiation Response Message

The Customer Payment Status Report XML ([pain.002 message](/home/connect/services/payments/response.md)) 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](/home/connect/services/messages.md).

{% hint style="info" %}
HTTP Header Message-Response-Type: PAYMENT
{% endhint %}

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.

## Examples

List of different payment cases and scenarios are covered - with related request and response messages: [Payment Example Library](/home/connect/services/payments/payment-examples.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.lhv.com/home/connect/services/payments.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.