# 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](https://docs.lhv.com/home/connect/services/payments/pain.001.001.09-format)) which supports UK Faster Payments and [various other payment schemes and types available at LHV Bank.](https://docs.lhv.com/home/connect/services/payments/payment-types-and-scheme-selection)

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="../../fundamentals/lhv-uk-and-estonia-integrations#override-option-for-lhv-uk-or-lhv-ee-services">#override-option-for-lhv-uk-or-lhv-ee-services</a></p> |

#### **Body**

[pain.001.001.09 CustomerCreditTransferInitiationV9](https://docs.lhv.com/home/connect/services/payments/pain.001.001.09-format)

We do support older version of payment initiation, [pain.001.001.03](https://docs.lhv.com/home/connect/services/payments/initiate-a-pending-or-direct-payment/pain.001.001.03-format), 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](https://docs.lhv.com/home/connect/services/payments/response)) 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](https://docs.lhv.com/home/connect/services/messages).

{% 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-examples](https://docs.lhv.com/home/connect/services/payments/payment-examples "mention")