Close Virtual Accounts

You can use this endpoint to close one or more Virtual Accounts.

Each Virtual Account number (virtualAccountNumber) and its associated closure reason code (reasonCode) must be in separate items in the closeVirtualAccountsList array of the request body.

When a Virtual Account is closed with this endpoint 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.

A closure request must include a closure reason. Please provide one of the available closure reason codes for each Virtual Account.

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

After a successful closure request, you can check the status of the closure process with the status endpoint. Note that to allow the backend system to process pending payments before closure, there is a 15-minute delay between the closure request and the closure completion.

🚧

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

Language
Credentials
Bearer