UPI Address Validate API

Use this API to validate whether the UPI address (VPA) or UPI number provided by the customer is valid and ready to accept payments.

Environment

Environment	HTTP Method	API
Sandbox	`POST`	https://api-preprod.phonepe.com/apis/pg-sandbox/v2/validate/upi
Production	`POST`	https://api.phonepe.com/apis/pg/v2/validate/upi

⚠️ Before initiating a payment, install the PhonePe Test App and configure the payment template. Skipping this step may result in HTTP 500 errors.

Request Header

Request Parameters

Parameter Name	Data Type	Mandatory	Description	Constraints
`type`	String	Yes	Type of UPI Payment Address.	Values allowed: • VPA • UPI_NUMBER
`vpa`	String	Conditional	VPA of user to validate.	Max Length = 255 Pass only if “type” = “VPA”
`upiNumber`	String	Conditional	UPI Number of user to validate.	Pass only if “type” = “UPI_NUMBER”

headers

body params

headers

body params

Sample Response for Case 1: VPA is Valid

{
    "valid": true
}

Sample Response for Case 2: Invalid VPA

{
    "valid": false
}