curl -X DELETE 'https://api.yativo.com/api/v1/business/virtual-account/delete-virtual-account/acct_xxxxxx' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET'
{
"status": "success",
"status_code": 200,
"message": "Request successful",
"data": {
"message": "Virtual account deleted successfully",
"account_id": "acct_xxxxxx"
}
}
{
"status": "failed",
"status_code": 404,
"message": "Account with the provided ID does not exists",
"data": { "error": "Account with the provided ID does not exists" }
}
Virtual Accounts
Delete Virtual Account
Permanently delete a virtual account
DELETE
/
business
/
virtual-account
/
delete-virtual-account
/
{account_id}
curl -X DELETE 'https://api.yativo.com/api/v1/business/virtual-account/delete-virtual-account/acct_xxxxxx' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET'
{
"status": "success",
"status_code": 200,
"message": "Request successful",
"data": {
"message": "Virtual account deleted successfully",
"account_id": "acct_xxxxxx"
}
}
{
"status": "failed",
"status_code": 404,
"message": "Account with the provided ID does not exists",
"data": { "error": "Account with the provided ID does not exists" }
}
Permanently deletes a virtual account. This action is irreversible.
The account stops accepting funds, and a
DELETE /v1/business/virtual-account/delete-virtual-account/{account_id}
curl -X DELETE 'https://api.yativo.com/api/v1/business/virtual-account/delete-virtual-account/acct_xxxxxx' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET'
{
"status": "success",
"status_code": 200,
"message": "Request successful",
"data": {
"message": "Virtual account deleted successfully",
"account_id": "acct_xxxxxx"
}
}
{
"status": "failed",
"status_code": 404,
"message": "Account with the provided ID does not exists",
"data": { "error": "Account with the provided ID does not exists" }
}
virtual_account.deleted webhook is sent.
| HTTP | data.error | Cause |
|---|---|---|
| 404 | Account with the provided ID does not exists | The account doesn’t exist or isn’t yours. |
| 400 | Unable to delete virtual account, please try again later | The account couldn’t be closed. Retry later. |
Deleting a virtual account is permanent and cannot be undone. Ensure any pending transactions are resolved before deleting.
Authorizations
Your API key (yativo_pk_...) from Developers → API Keys. Send together with X-Api-Secret.
Your API secret (yativo_sk_...), shown once when the key is created.
Path Parameters
The ID of the virtual account to delete.