post https://cac-api.cashfree.com/cac/v1.1/createVA
Use this API to create a virtual account or a virtual UPI address.
URLs
- Production/Live: https://cac-api.cashfree.com/cac/v1.1/createVA
- Sandbox/Test: https://cac-gamma.cashfree.com/cac/v1.1/createVA
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 20 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.