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.
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.
Verify UPI VPA for Free!
You can verify your beneficiary UPI VPA details for free using Free Credits. With this limited-time offer, experience and test the feature without paying any verification charges.
A banner displays the offer for you on the Verification Suite - UPI VPA page (Verification Suite Dashboard > Verification Suite - UPI VPA). Click Claim Free Credits and instantly redeem the credits to your account.
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 |
|---|---|
| [email protected] | Successful UPI transfer |
| [email protected] and [email protected] | 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 missing in the request |
| 422 | ERROR | Please provide a valid name |
| 422 | ERROR | Please provide a valid UPI VPA |
| 412 | ERROR | Insufficient balance to process this request |
| 400 | ERROR | Service temporarily unavailable. Please try again later |
| 422 | ERROR | Invalid UPI VPA provided |
| 520 | ERROR | Could not verify bank account details |
| 520 | ERROR | Something went wrong |
| 520 | ERROR | Unknown error occurred |
| 520 | ERROR | Validation attempt failed |