Create Virtual Account/VPA Version 1.1

Use this API to create a virtual account or a virtual UPI address.

Click to view the response codes.

Response Codes

Sub Code

Status

Description

200

SUCCESS

Virtual account created successfully

409

ERROR

Virtual account Id already exists.

400

ERROR

Invalid proportion scale precision provided for the given vendorId: {vendorId}

400

ERROR

Split Settlement preference is not enabled for profile, you cannot provide Split Config Details for virtual account.

400

ERROR

Specified Split Proportions greater than 100

400

ERROR

Invalid Proportion provided for the given vendorId : {vendorId}

400

ERROR

Specified VendorId: {vendorid}, is not registered with merchant

400

ERROR

Please provide valid virtual account ID. Only digits and alphabets are allowed

400

ERROR

vAccountId can be minimum of 3 characters.

400

ERROR

vAccountId can be maximum of 12 characters for IDFC Bank VBA.

400

ERROR

vAccountId can be maximum of 8 characters for Yes Bank VBA

400

ERROR

vAccountId can be maximum of 15 numeric characters for ICICI Bank VPA.

400

ERROR

vAccountId can be maximum of 26 alpha-numeric characters for ICICI Bank VPA.

400

ERROR

vAccountId can be maximum of 10 characters for Yes Bank VPA.

400

ERROR

vAccountId can be maximum of 8 characters for multiple VBAs.

400

ERROR

vAccountId can be maximum of 10 characters for multiple VPAs.

409

ERROR

Create Multiple Accounts feature not enabled for your account. Please contact [email protected]

409

ERROR

Virtual VPA not enabled for your account. Please check with your account manager or mail [email protected]

400

ERROR

Please provide the name.

400

ERROR

Please provide valid name. Only alphabets and spaces are allowed.

400

ERROR

Name can be minimum of 5 and maximum of 30 characters.

400

ERROR

Please provide the phone number.

400

ERROR

Please provide valid phone number.

400

ERROR

Please provide the email.

400

ERROR

Please provide valid email

400

ERROR

Remitter account and remitter IFSC should be provided together

400

ERROR

Remitter Account number should contain 9 to 30 alphanumeric characters.

400

ERROR

Enter valid IFSC.

422

ERROR

Amount Lock with VPA not supported.

422

ERROR

Remitter Lock with VPA not supported.

400

ERROR

Invalid minAmount and/or maxAmount Parameter. Maximum 2 digit precision allowed and minAmount should be less than or equal to maxAmount.

400

ERROR

Please check the notification group provided.

500

ERROR

Virtual account(s) created but split config could not be created.

400

ERROR

Any of the parameter(s) is not compatible with required data type. Please pass correct data type for all parameters.


📘

minAmount and maxAmount

  • You can specify either minAmount, maxAmount, or both for virtual accounts. These parameters are not applicable for virtual VPAs.
  • minAmount should always be lesser than or equal to maxAmount.

Language