# VIBAN Close

## Virtual IBAN Close - Request <a href="#virtual-iban-open" id="virtual-iban-open"></a>

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

Service is used to close a Virtual IBAN.

{% hint style="warning" %}
Once Virtual IBAN is closed, it cannot be activated again.
{% endhint %}

#### **Headers**

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

#### **Body**

{% file src="<https://2266620947-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHGywduAxJuxV3reZhASh%2Fuploads%2FOCLOkC34IzQmksS0rYt6%2Fviban.close.request.xsd.xml?alt=media&token=bc098fe2-f778-41dd-b6f4-c7ebc8e0c522>" %}

XML structure description:

<table><thead><tr><th width="97">MULT.</th><th>MESSAGE ELEMENT</th><th>XML TAG</th><th>Description</th></tr></thead><tbody><tr><td>[1..1]</td><td>+MessageRoot</td><td>&#x3C;VibanCloseRequest></td><td></td></tr><tr><td>[1..1]</td><td>++MasterAccount</td><td>&#x3C;MasterAccount></td><td>Master account IBAN (must belong to PSP).</td></tr><tr><td>[1..1]</td><td>++VirtualIBAN</td><td>&#x3C;VirtualIBAN></td><td>Virtual IBAN (must be issued under MasterAccount specified).</td></tr></tbody></table>

#### Samples

{% tabs %}
{% tab title="Request VIBAN Closing" %}

```xml
<?xml version="1.0" encoding="UTF-8"?>
<VibanCloseRequest>
  <MasterAccount>GB88LHVB01020000000001</MasterAccount>
  <VirtualIBAN>GB88LHVB01020000000002</VirtualIBAN>
</VibanCloseRequest>
```

{% endtab %}
{% endtabs %}

### **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 %}

## Response message

Response message is created and can be requests by the Messages services - [messages](https://docs.lhv.com/home/connect/services/messages "mention")

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

#### Body

{% file src="<https://2266620947-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHGywduAxJuxV3reZhASh%2Fuploads%2FwGgFB6PFAeijt8KlxAgq%2Fviban.close.response.xsd.xml?alt=media&token=dc552604-ec4d-4017-b5d2-806b88c8baee>" %}

XML structure description:

| MULT.   | MESSAGE ELEMENT | XML TAG               | Description               |
| ------- | --------------- | --------------------- | ------------------------- |
| \[1..1] | +MessageRoot    | \<VibanCloseResponse> |                           |
| \[1..1] | ++VirtualIBAN   | \<VirtualIBAN>        |                           |
| \[1..1] | ++Status        | \<Status>             | 'CLOSED'                  |
| \[1..1] | ++DateClosed    | \<DateClosed>         | Date and time of closing. |

#### Samples

{% tabs %}
{% tab title="Closing response" %}

```xml
<?xml version="1.0" encoding="UTF-8"?>
<VibanCloseResponse>
  <VirtualIBAN>GB88LHVB01020000000002</VirtualIBAN>
  <Status>CLOSED</Status>
  <DateClosed>2018-05-22+03:00</DateClosed>
</VibanCloseResponse>
```

{% endtab %}
{% endtabs %}