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 Features

Below is a list of new features we released in March 2023.

Accounts

1. Virtual Account - Create Additional VPA Handles

We have added the ability to create additional VPA handles for Virtual Account Wallets and Collection Tools.

To create additional VPA handles, pass create_vpa as true 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 the account.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 Handle

We 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 API

Before 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 the is_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.

πŸŽ‰ Enhancements

Below is a list of improvements we made in March 2023 to our existing APIs

Accounts

Create Savings and Current Accounts

The table below shows the changes in the Create Savings and Current Account APIs.

ChangeDescriptionType of Account
Occupation APIBased 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 Occupations API documentation for the list of new values.
  • Savings Account
  • Current Account
Employment Status APIBased 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 Employment Status API documentation for the list of new values.
  • Savings Account
  • Current Account

Virtual Account: New Parameter additional_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 the account.virtual API object.

Refer to our Virtual Account API documentation for the updated sample response.

Verification Suite

Below are the enhancements we made in March 2023.

1. PAN Verification API

Based 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 APIs

Based 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 APIs

Based 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.

Transfers

Below are the enhancements we made in March 2023.

1. Transfers Response Object - Additional Parameters

We 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 API

We 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 APIs

We 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.