VIBAN Close

Virtual IBAN Close service description

Virtual IBAN Close - Request

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

Service is used to close a Virtual IBAN.

Once Virtual IBAN is closed, it cannot be activated again.

Headers

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

Body

viban.close.request.xsd.xml

493B

Open

XML structure description:

MULT.	MESSAGE ELEMENT	XML TAG	Description
[1..1]	+MessageRoot	<VibanCloseRequest>
[1..1]	++MasterAccount	<MasterAccount>	Master account IBAN (must belong to PSP).
[1..1]	++VirtualIBAN	<VirtualIBAN>	Virtual IBAN (must be issued under MasterAccount specified).

Samples

Request VIBAN Closing

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

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_CLOSE

Body

viban.close.response.xsd.xml

558B

Open

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

Closing response

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