Manage Virtual Accounts used as Transfer Wallets
Learn how you can update and deactivate a virtual account.
Listed below are the various options available to manage virtual accounts.
- Deactivate Account: Instantly deactivate a virtual account.
Deactivate Account
The Deactivate Account API allows you to instantly deactivate an account. Accounts can be deactivated after they have served their purpose. This prevents misuse of the account and ensures the account is only used for the intended purpose. This makes accounting and account reconciliation easier. An account can also be deactivated if any suspicious activity is detected on the account.
Once an account is deactivated, it cannot be used to make transfers.
Note
Once a virtual account is deactivated it cannot be reactivated.
Only virtual accounts with zero balance can be deactivated.
Endpoint
Use the below endpoint to deactivate a virtual account.
POST: https://api.zwitch.io/v1/accounts/{account_id}/deactivate
Sample Code
Below is a sample response for the Deactivate Account API.
{
"id": "va_VTNxiFQ5nVt1UPOB6k643mk4G",
"object": "account.virtual",
"type": "virtual",
"used_as": "wallet",
"bank_name": "idfc_bank",
"name": "Anil Reddy",
"mobile_number": "9876543210",
"email": "[email protected]",
"account_number": "797979902053773",
"ifsc_code": "IDFB0040101",
"vpa": null,
"additional_vpa": [],
"whitelisted_remitters": [],
"whitelisted_beneficiaries": [],
"kyc": {
"city": "Bangalore",
"postal_code": "560010",
"state_code": "KA",
"pan": "XXXXXX000A",
"business_type": "partnership",
"business_category": "garage_owners",
"contact_person": null
},
"customer": {
"id": "cus_OGOuL7NxzlUj27ECK6T6E0xCR",
"mobile_number": "9876543210"
},
"metadata": {
"key_1": "DD+Cheque",
"key_2": "MSF"
},
"status": "deactivated",
"created_at": 1707736918,
"is_sandbox": true,
"settlement_account_id": null,
"verified_beneficiaries": [],
"verified_remitters": []
}
Refer to the Deactivate Virtual Account API documentation for more information.
Updated 5 days ago