Request Headers

Header Name	Header Value
`Content-Type`	application/json
`X-VERIFY`	SHA256(base64 encoded payload + "/v4/debit" + salt key) + ### + salt index
`X-``CALLBACK`	S2S callback url
`X-CALL-MODE`	S2S call mode (POST/ PUT)

{	
	"merchantId": "M2306160483220675579140", // String Mandatory
	"transactionId": "e3e1mmcccdmm9ef8vdfmd7b", // String Mandatory
	"merchantUserId": "unknown8898", // String Mandatory - used for auto login.
	"userAuthToken": "unknown8898", // String Mandatory - used in OTP linking flow.
	"amount": 200, // long Mandatory - amount should be in paise
	"merchantOrderId": "OD139924923", // String Mandatory
	"subMerchant": "unknown8898", // String - ONLY if sub merchant id is allocated to you 
	"mobileNumber": "unknown8898", // String - mobile number of the user
	"message": "Payment towards order No. OD139924923.", // String - message will be displayed on completion of payment.
	"email": "xMerchantId", // String - email id of the user.
	"shortName": "OD139924923", // String - user name is pre filled for registration purpose.
	"paymentScope": "PHONEPE", // String Mandatory - value should be PHONEPE only
	"deviceContext":{  // Object Mandatory
		"phonePeVersionCode": 303391 // Long Mandatory - returns intent URI
	},
	"merchantContext": { // Object - Only if Deep offers is allocated to you.
		"offerContext": {
			"tags ": [{
			"id": "GOLD_CATEGORY", // String Mandatory
			"amount": 200  // String Mandatory 
			}]
		}
	}
}

// transactionId length should be less than 38 characters. 
// merchantOrderId length should be less than 48 characters.

Request Parameters


Parameter Name	Type	Description	Mandatory
merchantId	STRING	Unique `MerchantID` assigned to the merchant by PhonePe	`Yes`
transactionId	`STRING`	Unique `TransactionID` generated by the merchant to track request to PhonePe transactionId length should be less than 38 characters.	`Yes`
`merchantUserId`	`STRING`	Unique `UserID` generated by merchant. This is used to pre-login users authenticated on PhonePe. Un-authenticated users are redirected to PhonePe login page. Conversions are higher when this is provided. Avoid passing email/mobile number. Skip this for guest users. `Note:`	`Yes`
`userAuthToken`	`STRING`	Unique `userAuthToken`given to merchant in OTP flow. This is used to pre-login users authenticated on PhonePe. If not passed users will be redirected to PhonePe login page. `Note`	`Only for OTP linking flow.`
`amount`	`LONG`	Transaction amount in Paise	`Yes`
`merchantOrderId`	`STRING`	`OrderID` generated by the merchant merchantOrderId length should be less than 48 characters.	`Yes`
`subMerchant`	`STRING`	Tag to categorize merchant transaction. Skip this field if you don't have multiple merchants tagged under one merchant id.	`No`
`mobileNumber`	`STRING`	Mobile number of the user	`No`
`message`	`STRING`	Short message. This message is displayed to the user on completion of payment.	`No`
`email`	`STRING`	Email address of the user	`No`
`shortName`	`STRING`	User's name pre-filled for registration purpose.	`No`
`paymentScope`	`STRING`	Value should be "PHONEPE"	`Yes`
`deviceContext`	`OBJECT`	PhonePe version code	`Yes`
`merchantContext`	`OBJECT`	Refer Deep Offer API	`No`

Response Parameters

Parameter Name	Type	Description
`success`	`BOOLEAN`	Success status of the request
`code`	`ENUM`	See list of response codes below