Skip to main content
POST
Terminate Virtual Account
Sets the virtual account’s status to terminated and closes its bank details. Termination is permanent: a terminated virtual account cannot be reopened, and its account number is not issued again. The request takes no body. Only an active virtual account can be terminated, and all three balances (available, pending_payin and held_for_payout) must be zero. Move the funds out first with a payout or a transfer, and wait for pending deposits and payouts to finish. A pending or frozen virtual account can only be closed by Hop. The call is idempotent: terminating an already-terminated virtual account returns 200 with the virtual account unchanged. Tell your payers to stop using the bank details before you terminate. A deposit sent to a terminated virtual account is not credited. A virtual_account.updated webhook is sent when the status changes. Requires an API key with write access on the virtual_accounts scope.

Path Parameters

string
required
The account’s external ID (starts with acct_)
string
required
The virtual account group’s external ID (starts with vag_)
string
required
The virtual account’s external ID (starts with va_)

Response

Returns the full virtual account object, the same shape as Get Virtual Account, with status set to terminated.

Errors