UPI QR

This flow generates a QR code that the customer can scan using any UPI-enabled app to complete the payment.

Environment

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

⚠️ 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

Header Name	Header Value	Description
Content-Type	application/json
`Authorizatio`n	O-Bearer <access_token>	Pass `access_token` received in Authorization call

Request Parameters

Parameter Name	Data Type	Mandatory	Description	Constraints
`merchantOrderId`	String	Yes	Unique merchant order id generated by merchant.	Max Length = 63 charactersNo Special characters allowed except underscore “_” and hyphen “-“
`amount`	Long	Yes	Order amount in paisa.	Min Value = 100 (In paise)
`expireAfter`	Long	No	Order expiry in seconds. If not passed default value will be used.	Min Value = 300, Max Value = 5184000 Default Value (in Secs): UPI QR: 480
`metaInfo`	Object	No	Merchant defined meta info to store additional information.same data will be returned in status and callback response.
`metaInfo.udf1-5`	String	No	Merchant defined additional information	Max length = 256 characters
`paymentFlow`	Object	Yes	Additional details required by this flow.
`paymentMode.type`	String	Yes	Type of payment mode	Values Allowed: • UPI_INTENT • UPI_COLLECT • UPI_QR • NET_BANKING • TOKEN • CARD

headers

body params

Sample Response

{
    "orderId": "OMO123456789",
    "state": "PENDING",
    "expireAt": 1703756259307,
    "intentUrl": "ppe://url",
    "qrData": ""
}

Field Name	Data Type	Description
`orderId`	String	PG generated internal order id.
`state`	String	State of the order created, Expected value is CREATED.
`expiryAt`	Long	Order expiry date in epoch (in milliseconds).
`intentUrl`	String	Intent url (Present in case of UPI_INTENT or UPI_QR).