Closing Virtual Accounts

It is possible to close your Virtual Accounts through our API in two different ways. You can provide the virtual accounts you wish to close in JSON format or a CSV file.

This endpoint accepts JSON and this endpoint accepts CSV files. Common for the two ways is to provide one or more Virtual Accounts and a closure reason code for each.

The codes symbolize the following closure reasons:

• C01 (Merchant has been off-boarded)
• C02 (Due to AML/risk appetite/fraud reasons)

When a Virtual Account is closed with these endpoints it will apply to all available currencies of the Virtual Account. It is not possible to close a subset of currencies. The endpoint does not support re-opening of Virtual Accounts.

CSV example

The headers are mandatory and have to be provided as shown in the example.

VirtualAccountNumber,ReasonCode
0099394118,C01
0099394117,C02

When the closure request is sent it goes to processing. In most cases, the closure process is completed within a few minutes. You can follow the closure process by requesting the closure status via this status endpoint.

Immediately after the request, the closure status is pending. When the process is completed, the status is processed. In case of errors, the status is failed and in that situation, contact our Client Services team for help.

When the closure status reaches processed, the Virtual Account is closed. This is also shown in the response of the endpoint GET /api/v1/virtualAccounts, where the status property for the Virtual Account is will be inActive.

🚧

There is a limit of 1,000 Virtual Accounts per close request.