SearchRequest Headers
| Header Name | Header Value |
Content-Type | application/json |
X-VERIFY | SHA256(“/v3/recurring/auth/status/{merchantId}/{authRequestId}” + saltKey) + “###” + saltIndex |
Path Parameters
| Parameter Name | Type | Description | Mandatory |
| String | Unique Merchant ID assigned to the merchant by PhonePe | Yes |
| String | Auth Request Id for which status is to be fetched | Yes |
Sample Response for TRANSACTION Type
{
"success": true,
"code": "SUCCESS",
"message": "Your subscription is created.",
"data": {
"merchantId": "MID12345",
"authRequestId": "TX123456789",
"subscriptionDetails": {
"subscriptionId": "OMS2006110139450123456789",
"state": "CREATED"
}
}
}{
"success": true,
"code": "SUCCESS",
"message": "Your subscription is active.",
"data": {
"merchantId": "MID12345",
"authRequestId": "TX123456789",
"transactionDetails": {
"providerReferenceId": "P1806151323093900554957",
"amount": 39900,
"state": "COMPLETED",
"payResponseCode": "SUCCESS",
"paymentModes": [
{
"mode": "ACCOUNT",
"amount": 399000,
"utr": "816626521616",
"ifsc": "HDFC0000999",
"maskedAccountNumber": "XXXXXX999",
"umn": "9123dac357de123cb2cbd45283412305@ybl"
}
]
},
"subscriptionDetails": {
"subscriptionId": "OMS2006110139450123456789",
"state": "ACTIVE"
}
}
}{
"success": true,
"code": "SUCCESS",
"message": "Your subscription is failed.",
"data": {
"merchantId": "MID12345",
"authRequestId": "TX123456789",
"transactionDetails": {
"providerReferenceId": "P1806151323093900554957",
"amount": 39900,
"state": "FAILED",
"payResponseCode": "Z9",
"payResponseCodeDescription": "Insufficient Funds",
"paymentModes": [
{
"mode": "ACCOUNT",
"amount": 399000,
"utr": "816626521616"
}
]
},
"subscriptionDetails": {
"subscriptionId": "OMS2006110139450123456789",
"state": "FAILED"
}
}
}Sample Response for PENNY DROP Type
{
"success": true,
"code": "SUCCESS",
"message": "Your subscription is created.",
"data": {
"merchantId": "MID12345",
"authRequestId": "TX123456789",
"subscriptionDetails": {
"subscriptionId": "OMS2006110139450123456789",
"state": "CREATED"
}
}
}{
"success": true,
"code": "SUCCESS",
"message": "Your subscription is active.",
"data": {
"merchantId": "MID12345",
"authRequestId": "TX123456789",
"subscriptionDetails": {
"subscriptionId": "OMS2006110139450123456789",
"state": "ACTIVE"
}
}
}{
"success": true,
"code": "SUCCESS",
"message": "Your subscription is failed.",
"data": {
"merchantId": "MID12345",
"authRequestId": "TX123456789",
"subscriptionDetails": {
"subscriptionId": "OMS2006110139450123456789",
"state": "FAILED"
}
}
}Response Parameters
| Parameter Name | Type | Description | Comments |
| String | Merchant ID provided by PhonePe | |
subscriptionId | String | User’s unique Id maintained by merchant | |
| String | Merchant’s auth request Id | |
transactionDetails | Object | Same as normal Transaction | ● Available when subscription authWorkflowType is TRANSACTION and not in PENNY_DROP |
transactionDetails.payResponseCode | String | PhonePe internal status code. Please note this is a string value and new codes are likely to be added in the future. (Please don’t do the marshaling/unmarshalling into an enum for this at your side). This is an informative value. | |
transactionDetails.payResponseCodeDescription | String | Description of the payResponseCode ● Max Length – 256 ● Optional Parameter | |
subscriptionDetails | Object | Contains subscriptionId and state |