get https://payout-api.cashfree.com/payout/v1/validation/upiDetails
Use this API to verify if a given UPI handle exists. You will receive the customer name given at the bank in the response for valid UPIs.
You can claim free credits to verify your beneficiary details.
Test Data
View the test data and use this information to trigger the validations. The test data are usable only in the test environments such as gamma and sandbox.
The API returns a success response in two cases:
- The UPI VPA entered exists and verified.
- The UPI VPA entered does not exist.
Click here to view the test data.
Sample UPI VPA
For UPI, the primary parameter for transfer would be the UPI VPA included while adding the beneficiary. Use these UPI VPA to test payouts to an account. Can be used only with test API keys.
| VPA | Remarks |
|---|---|
| success@upi | Successful UPI transfer |
| incorrect@upi and invalid@upi | Failed UPI transfer |
Click here to view the response codes.
Response Codes
| Sub Code | Status | Message |
|---|---|---|
| 200 | SUCCESS | VPA verification successful |
| 403 | ERROR | Token is not valid |
| 403 | ERROR | IP not whitelisted |
| 412 | ERROR | Token is not valid |
| 422 | ERROR | Please provide a valid Name. |
| 422 | ERROR | Please provide a valid vpa |
| 412 | ERROR | Insufficient balance to process this request. |
| 400 | ERROR | Service temporarily unavailable. Please try again later |
| 422 | ERROR | Please provide a valid Virtual Payee Address. |
| 520 | ERROR | Could not verify bank account details |
| 520 | ERROR | Something went wrong |
| 520 | ERROR | Unknown error occurred! |
| 520 | ERROR | Validation attempt failed |