VIBAN Bulk Open

Virtual IBAN Bulk open service description

Virtual IBAN Bulk Open - Request

POST https://connect.lhv.com/viban/bulk

Service is used for bulk opening nameless Virtual IBANs. Up to 1000 virtual IBANs can be opened with one request. Nameless virtual IBANs remain in "PENDING" status and can not be used for making payments until Virtual IBAN owner's personal details are added via service Virtual IBAN Modify.

There is a limit to allow up to 10 000 Pending VIBAN accounts at a time per single Master Account. This is enforced to avoid opening too many accounts due to any errors.

Limit can be overridden only on special request to our Support.

Headers

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

Body

772B

viban.bulk.request.xsd.xml

XML structure description:

MULT.	MESSAGE ELEMENT	XML TAG	Description
[1..1]	+MessageRoot	<VibanBulkRequest>
[1..1]	++MasterAccount	<MasterAccount>	Master account IBAN (must belong to PSP).
[1..1]	++Amount	<Amount>	Amount of Virtual IBANs to be generated. Must be in range of 1 - 1000.

Samples

Opening two accounts

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<VibanBulkRequest>
  <MasterAccount>EE737700771001625166</MasterAccount>
  <Amount>2</Amount>
</VibanBulkRequest>

Response

Headers

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

Body

202

Request accepted - no content

403

Error code and description

<Errors>
    <Error>
        <ErrorCode>FORBIDDEN</ErrorCode>
        <Description>User doesn't exist</Description>
    </Error>
</Errors>

Response message

Response message is created and can be requests by the Messages services - Messages Services

HTTP Header Message-Response-Type: VIBAN_BULK

Body

705B

viban.bulk.response.xsd.xml

XML structure description:

MULT.	MESSAGE ELEMENT	XML TAG	Description
[1..1]	+MessageRoot	<VibanBulkResponse>
[1..1]	++MasterAccount	<MasterAccount>	Master account IBAN (must belong to PSP).
[1..1]	++VirtualIBANList	<VirtualIBANList>
[1..n]	++VirtualIBAN	<VirtualIBAN>	Virtual IBAN that was generated.

Samples

Two accounts opened

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<VibanBulkResponse>
    <MasterAccount>EE737700771001625166</MasterAccount>
    <VirtualIBANList>
        <VirtualIBAN>EE717777000200014007</VirtualIBAN>
        <VirtualIBAN>EE507777000200014094</VirtualIBAN>
    </VirtualIBANList>
</VibanBulkResponse>