post https://sandbox.cashfree.com/verification/upi/mobile
Use this API to fetch the account holder name along with the associated UPI VPA information of your customer by providing the phone number. This API fetches multiple VPA from the phone number, and contact your account manager or write to [email protected] to enable this API. View the test data and use the information to trigger the validations. The test data are usable only in the test environments such as gamma and sandbox.
Response Codes
| Sub Code | Status | Message | Next Action |
|---|---|---|---|
| 200 | SUCCESS | VALID | - |
| 200 | SUCCESS | No UPI ID found linked to the Mobile Number | Enter a mobile number linked to at least one UPI VPA. |
| 200 | SUCCESS | Unable to validate, please retry later | Try again after some time. |
| 400 | ERROR | Mobile number entered is invalid. | Enter a valid mobile number. |
| 400 | ERROR | mobile_number is missing in the request. | Enter a valid mobile number in the API request. |
| 400 | ERROR | x-client-id is missing in the request. | Enter all the header information in the API request. |
| 400 | ERROR | Client secret belongs to test environment | Enter the correct environment credentials in the request. |
| 401 | ERROR | Invalid clientId and clientSecret combination | Enter valid client ID and secret key in the request. |
| 403 | ERROR | IP not whitelisted your current ip is 106.51.91.104.For IP whitelisting assistance, visit our guide at https://docs.cashfree.com/docs/ip-whitelisting-verification | Whitelist the IP address. |
| 409 | ERROR | verification id already exists | Create a unique verification ID to identify the request. |
| 422 | ERROR | Insufficient balance to process this request | Ensure you have sufficient balance and then process the request. |
| 500 | ERROR | something went wrong | Try again after some time. |