# VIBAN Services

Virtual IBAN (VIBAN) services are a special solution for financial institutions to issue unique account numbers for their 3rd party customers in their name.

## Services

List of VIBAN management services:

[open-a-viban-1](https://docs.lhv.com/home/connect/services/viban/open-a-viban-1 "mention")

[open-a-viban-1-1](https://docs.lhv.com/home/connect/services/viban/open-a-viban-1-1 "mention")

[open-a-viban-1-2](https://docs.lhv.com/home/connect/services/viban/open-a-viban-1-2 "mention")

[open-a-viban-1-3](https://docs.lhv.com/home/connect/services/viban/open-a-viban-1-3 "mention")

[open-a-viban-1-4](https://docs.lhv.com/home/connect/services/viban/open-a-viban-1-4 "mention")

[open-a-viban-1-5](https://docs.lhv.com/home/connect/services/viban/open-a-viban-1-5 "mention")

## XML Formats

All our VIBAN services are using custom XML formats. The XSD definitions are lists separately under each service. Most of the XSD definitions are also using a common XSD file for different datatypes:

{% file src="<https://2266620947-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHGywduAxJuxV3reZhASh%2Fuploads%2FjNi9NSWgZaizRmUi0i1d%2Fviban.common.xsd.xml?alt=media&token=123be4e3-f71e-4bae-ad48-4c0848cc926d>" %}
XML schema
{% endfile %}

## Errors

List of error codes for VIBAN services

#### Virtual IBAN Error Codes <a href="#virtual-iban-error-codes" id="virtual-iban-error-codes"></a>

<table><thead><tr><th>ErrorCode</th><th width="327">Description</th><th>Field</th></tr></thead><tbody><tr><td>'INVALID_REQUEST'</td><td>Invalid request.</td><td>-</td></tr><tr><td>'TECHNICAL_ERROR'</td><td>Technical error.</td><td>-</td></tr><tr><td>'FORBIDDEN'</td><td>Unauthorized master account.</td><td>&#x3C;MasterAccount></td></tr><tr><td>'FORBIDDEN'</td><td>Unauthorized virtual IBAN.</td><td>&#x3C;VirtualIBAN></td></tr><tr><td>'INVALID_ACCOUNT'</td><td>Account does not exist.</td><td>&#x3C;MasterAccount></td></tr><tr><td>'INVALID_BIRTH_DATE'</td><td>Birth date format is YYYY-MM-DD.<br>Birth date cannot be in the future.</td><td>&#x3C;BirthDate></td></tr><tr><td>'INVALID_COUNTRY'</td><td>Unknown country.</td><td>&#x3C;BirthCountry><br>&#x3C;Residency><br>&#x3C;CountryOfOrigin><br>&#x3C;TaxResidency><br>&#x3C;Country></td></tr><tr><td>'INVALID_STATUS'</td><td>Virtual IBAN has to be in ACTIVE / PENDING / BLOCKED status.<br>Virtual IBAN has to be in ACTIVE / PENDING / ON_HOLD status.</td><td>&#x3C;VirtualIBAN></td></tr><tr><td>'INVALID_VIBAN'</td><td>Virtual IBAN does not exist.</td><td>&#x3C;VirtualIBAN></td></tr><tr><td>'MASTER_ACCOUNT_AGREEMENT_MISSING'</td><td>Active master account agreement is missing.</td><td>&#x3C;MasterAccount></td></tr><tr><td>'INVALID_REASON'</td><td>Reason for the change is missing.<br>Reason for the change is not allowed when status is PENDING.</td><td>&#x3C;ModifyReason></td></tr><tr><td>'INVALID_USER_TYPE'</td><td>Changing user type is not allowed.</td><td>&#x3C;User></td></tr><tr><td>'INVALID_CLIENT_REFERENCE'</td><td>Client reference number must be unique.<br>Client reference number change is not allowed.</td><td>&#x3C;ClientReference></td></tr></tbody></table>