Overview of the account.virtual
object.
Shown below is a sample account.virtual
object for wallets and collection tools.
{
"id": "va_2BNgFqGdz0AqUDtKMgZgRfjG6",
"object": "account.virtual",
"type": "virtual",
"used_as": "wallet",
"bank_name": "yes_bank",
"name": "Ganga Reddy",
"mobile_number": "9000000842",
"email": "[email protected]",
"account_number": "36363651152266170",
"ifsc_code": "YESB0CMSNOC",
"vpa": "[email protected]",
"whitelisted_remitters": [
{
"account_number": "98909876123562",
"ifsc_code": "HDFC0000123"
}
],
"kyc": {
"city": "Bangalore",
"postal_code": "560005",
"state_code": "KA",
"pan": "XXXXXX000A",
"business_type": "partnership",
"business_category": "garage_owners"
},
"customer": {
"id": "cus_nsBbFAngtyzfjRGVsy0fXuDvQ",
"mobile_number": "9000000842"
},
"metadata": {
"key_1": "DD",
"key_2": "XOF"
},
"status": "active",
"created_at": 1653995889,
"is_sandbox": true
}
{
"id": "va_u6b8LmK8EKEFaegcUKOLravtd",
"object": "account.virtual",
"type": "virtual",
"used_as": "collection_tool",
"bank_name": "yes_bank",
"name": "Anil Reddy",
"mobile_number": "9000000843",
"email": "[email protected]",
"account_number": "3636365909197251",
"ifsc_code": "YESB0CMSNOC",
"vpa": "[email protected]",
"whitelisted_remitters": [
{
"account_number": "98909876123562",
"ifsc_code": "HDFC0000123"
}
],
"kyc": {
"city": "Bangalore",
"postal_code": "560010",
"state_code": "KA",
"pan": "XXXXXX000F",
"business_type": "partnership",
"business_category": "garage_owners"
},
"customer": {
"id": "cus_sCoO4JTuJgfaMkgxNP54PH81I",
"mobile_number": "9000000843"
},
"metadata": {
"key_1": "DD",
"key_2": "XOF"
},
"status": "active",
"created_at": 1653995905,
"is_sandbox": true
}
The table below lists the various parameters in the virtual account object.
Parameters | Type | Description |
---|---|---|
id | string | Unique identifier of the savings account in the ZWITCH database. Has to be 28 characters. Example: va_Y6evcApKFXhQ9X7qKQ5AaysEI Supported characters:
|
object | string | API object that is returned. Possible value: account.virtual |
type | string | The account type. Possible value: virtual |
used_as | string | Type of virtual account. Possible values:
Types of virtual accounts. |
bank_name | string | Bank where the virtual account is created. Possible value: yes_bank |
name | string | Applicant's name. Maximum 70 characters. Example: Anil Reddy Supported characters:
|
mobile_number | string | Applicant's mobile number. Has to be 10 digits. Example: 9876543210 Supported characters:
|
string | Applicant's email address. Example: [email protected] | |
account_number | string | Virtual account number. Maximum 30 characters. Example: 18539873916 Supported characters:
|
ifsc_code | string | Virtual account IFSC. Has to be 11 characters. Example: STCB0000065 Supported characters:
|
vpa | string | Virtual payment number (VPA) linked to the virtual account. Example: [email protected] |
whitelisted_remitters | array of objects | Array of objects that contain a list of accounts from which the virtual account holder wants to receive money. Currently, only bank accounts can be whitelisted. Learn more about the whitelisted_remitters child object. |
kyc | object | Object that contains the applicant's KYC details. Learn more about the kyc child object. |
customer | object | JSON object that contains details about the account holder. Learn more about the customer child object. |
metadata | object | Object of key-value pair that can be used to store additional information about the entity. Note:
"key_1": "DD" |
status | string | Possible values:
|
created_at | integer | Unix timestamp when the create virtual account request was received by ZWITCH. Example: 1640179951 |
is_sandbox | boolean | Possible values:
|
[Child Object] Whitelisted Remitters Object
The table below lists the various parameters in the whitelisted_remitters
child object. This object is part of the account.virtual
object.
Parameters | Type | Description |
---|---|---|
account_number | string | Account number from which the virtual account holder wants to receive money. Maximum 30 characters. Example: 18539873916 Supported characters:
|
ifsc_code | string | IFSC linked to the account from which the virtual account holder wants to receive money. Has to be 11 characters. Example: AAAA0000001 Supported characters:
|
[Child Object] KYC Object
The table below lists the various parameters in the kyc
child object. This object is part of the account.virtual
object.
Parameters | Type | Description |
---|---|---|
city | string | Account holder's city. Example: Bangalore Supported characters:
|
postal_code | string | Account holder's pincode. Has to be 6 digits. Example: 560005 Supported characters:
|
state_code | string | Applicant's state code. Use the State Codes API to get a list of accepted values. Example: KA |
pan | string | Applicant's PAN number. Has to be 10 characters. Example: AAAPA0000A Supported characters:
|
business_type | string | The business type for the virtual account. Use the Business Types API to get a list of accepted values. Example: partnership |
business_category | string | The business category for the virtual account. Use the Business Categories API to get a list of accepted values. Example: garage_owners |
[Child Object] Customer Object
The table below lists the various parameters in the customer
child object. This object is part of the account.virtual
object.
Parameters | Type | Description |
---|---|---|
id | string | Unique identifier of the applicant in the ZWITCH database. Has to be 29 characters. Example: cus_lmPl9XliJ09yisvcWKrff2WCR .Supported characters:
|
mobile_number | string | Mobile number of the applicant or registered business. Has to be 10 digits. Example: 9876543210 Supported characters:
|