March 2023
We work hard to ensure everyone who uses ZWITCH gets the best experience. Every day we take small steps towards developing new products, enhancing existing features, and improving the performance of our system. We also fix (the occasional) bug in the system.
Below is a list of new feature releases, product improvements, and bug fixes we made in March 2023.
Note
- Except for breaking changes, all other changes are backward compatible.
- Currently, we work on a daily release cycle. We push changes to the production environment as they are developed. However, we will notify you about breaking changes, new feature releases, and major enhancements via email before they are released.
π New FeaturesBelow is a list of new features we released in March 2023.
Accounts
1. Virtual Account - Create Additional VPA HandlesWe have added the ability to create additional VPA handles for Virtual Account Wallets and Collection Tools.
To create additional VPA handles, pass
create_vpa
astrue
in the Update Virtual Account API. We autogenerate additional VPA handles for the virtual account.To allow the creation of additional VPA handles, we have introduced a new parameter
additional_vpa
with a data type array of objects in theaccount.virtual
API object.Note:
- You can create up to 3 additional VPA handles per account.
- You cannot create additional VPA handles using the Create Virtual Account API. This can only be done using the Update Virtual Account API.
Shown below is a sample request and response to create additional VPAs using the Update Virtual Account API.
Sample Request
{ "create_vpa": true, "email": "[email protected]", "kyc": { "state_code": "KA", "city": "Bangalore", "pan": "AAAPA7777H", "postal_code": "560010", "business_type": "individual", "business_category": "daily_wage" }, "whitelisted_remitters": [ { "account_number": "91021021021212", "ifsc_code": "ICIC0666666" } ] }
{ "id": "va_0KKxuNWEp0J4txpebrfZf0mjA", "object": "account.virtual", "type": "virtual", "used_as": "wallet", "bank_name": "icici_bank", "name": "Anil Reddy", "mobile_number": "8888881111", "email": "[email protected]", "account_number": "282839668131", "ifsc_code": "ICIC0000001", "vpa": "testvpa12@yesbank", "additional_vpa": [ { "vpa": "testvpa123@yesbank", "status": "active", "created_at": 1680515701 } ], "whitelisted_remitters": [ { "account_number": "91021021021212", "ifsc_code": "ICIC0666666" } ], "kyc": { "city": "Bangalore", "postal_code": "560010", "state_code": "KA", "pan": "XXXXXX677H", "business_type": "individual", "business_category": "daily_wage", "contact_person": null }, "customer": { "id": "cus_ZhC3VJVPoMJfW5ovtDkeu9QXl", "mobile_number": "8888881111" }, "metadata": { "order_id": "12345" }, "status": "vpa_creation_pending", "created_at": 1678781502, "is_sandbox": true }
Refer to our Update Virtual Account API documentation for more details.
2. Virtual Account - Create Custom VPA HandleWe have added the ability to create a custom VPA handle for Virtual Account Wallets and Collection Tools.
Contact our Integrations Team to learn more.
Note:
You can create custom VPA handled when creating a virtual account or when adding additional VPA handles to a virtual account.
3. Postal Code Serviceability APIBefore creating an account you can check whether the applicantβs postal code is serviceable using the Postal Code Serviceability API.
If the API returns
false
against theis_serviceable
parameter, it means our partner bank does not offer savings and current accounts to the entered postal code.Shown below are the endpoint, sample request, and sample response for a Serviceability API.
POST: https://api.zwitch.io/v1/serviceability/postal-code
{ "purpose": "current_account", "postal_code": "560100" }
{ "id": "ser_ZN6oqEs0EYLk5g2U4HtSJiiNX", "object": "serviceability.postal_code", "purpose": "current_account", "postal_code": "560100", "is_serviceable": true, "created_at": 1680590477, "is_sandbox": false }
Refer to our Serviceability API documentation for more details.
π EnhancementsBelow is a list of improvements we made in March 2023 to our existing APIs
Accounts
Create Savings and Current AccountsThe table below shows the changes in the Create Savings and Current Account APIs.
<th> Description </th> <th> Type of Account </th> </tr>
<td> Based on a regulatory update from our partner bank, we have made the following changes to the Savings Account and Current Account APIs. 1. Changes to the list of accepted values to the `kyc.occupation` parameter. Refer to our <a href="https://developers.zwitch.io/reference/constants-occupations" target="_block">Occupations API documentation</a> for the list of new values. </td> <td> <ul> <li>Savings Account</li> <li>Current Account</li> </ul> </td> </tr> <tr> <td> Employment Status API </td> <td> Based on a regulatory update from our partner bank, we have made the following changes to the Savings Account and Current Account APIs. 2. Added a new parameter `kyc.employment_status` to the Create Savings and Current Account API request and response. Refer to our <a href="https://developers.zwitch.io/reference/employment-status" target="_block">Employment Status API documentation</a> for the list of new values. </td> <td> <ul> <li>Savings Account</li> <li>Current Account</li> </ul> </td> </tr>
Change Occupation API
Virtual Account: New Parameteradditional_vpa
To allow the creation of additional VPA handles, we have introduced a new parameter
additional_vpa
with a data type array of objects in theaccount.virtual
API object.Refer to our Virtual Account API documentation for the updated sample response.
Verification SuiteBelow are the enhancements we made in March 2023.
1. PAN Verification APIBased on a regulatory update from our partner bank, we have introduced a new parameter
consent
in the API.The consent parameter supports the data type boolean and accepts true and false as inputs.
Note:
The consent parameter must be set to true to use the API.
Refer to our PAN Verification API documentation for the updated sample request and sample response.
2. Aadhaar Verification via OTP APIsBased on a regulatory update from our partner bank, we have introduced a new parameter
consent
in the API.Consent is a boolean and accepts true and false as inputs.
Note:
The consent parameter must be set to true to use the API.
Refer to our Aadhaar Verification via OTP API documentation for the updated sample request and sample response.
3. CKYC Registration APIsBased on a regulatory update from our partner bank, we have introduced a new parameter consent in the CKYC Registration APIs.
Consent is a boolean and accepts true and false as inputs.
Note:
The consent parameter must be set to true to use the API.
Refer to our CKYC Registration API documentation for the updated sample request and sample response.
TransfersBelow are the enhancements we made in March 2023.
1. Transfers Response Object - Additional ParametersWe have introduced 2 new parameters in the transfer API response object. These parameters are:
beneficiary_name
beneficiary_ifsc
Refer to our Transfers API documentation for the updated sample response.
2. Resend OTP APIWe have introduced 1 new parameter in the Resend OTP API,
resend_attempts
.Refer to our Resend OTP API documentation for the updated sample response.
Beneficiary APIsWe have introduced a new parameter
status
in the beneficiary response objects. This parameter lets you know the status of the beneficiary.Currently, the only possible value for the parameter is
active
.Refer to our Beneficiaries API documentation for the updated sample response.