Request 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 |
---|---|---|---|
merchantId | STRING | Unique Merchant ID assigned to the merchant by PhonePe | Yes |
authRequestId | 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
Field Name | Data Type | Description | Comments |
---|---|---|---|
merchantId | STRING | MID provided by PhonePe | |
subscriptionId | STRING | User’s unique Id maintained by merchant | |
authRequestId | STRING | Merchant’s auth request Id | |
transactionDetails | OBJECT | Same as normal Transaction, please refer here | ● 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 | ● As available previously in this document. |
{“method”:”get”,”url”:”/v3/recurring/auth/status/{merchantId}/{authRequestId}”,”auth”:”required”,”results”:{“codes”:[{“name”:””,”code”:”{}”,”language”:”json”,”status”:200},{“name”:””,”code”:”{}”,”language”:”json”,”status”:400}]},”params”:[{“name”:”merchantId”,”type”:”string”,”enumValues”:””,”default”:””,”desc”:”Unique Merchant ID assigned to the merchant by PhonePe”,”required”:false,”in”:”path”,”ref”:””,”_id”:”60ae1177347cb9000f396cc2″},{“name”:”authRequestId”,”type”:”string”,”enumValues”:””,”default”:””,”desc”:”Auth Request Id for which status is to be fetched”,”required”:false,”in”:”path”,”ref”:””,”_id”:”60ae1177347cb9000f396cc1″},{“name”:”Content-Type”,”type”:”string”,”enumValues”:””,”default”:”application/json”,”desc”:””,”required”:true,”in”:”header”,”ref”:””,”_id”:”60ae1177347cb9000f396cc0″},{“name”:”X-VERIFY”,”type”:”string”,”enumValues”:””,”default”:””,”desc”:”SHA256(\”/v3/recurring/auth/status/{merchantId}/{authRequestId}\” + saltKey) + \”###\” + saltIndex”,”required”:true,”in”:”header”,”ref”:””,”_id”:”60ae1177347cb9000f396cbf”}],”apiSetting”:”63bb01b11abcf7046d98754c”,”examples”:{“codes”:[]}}
https://api-preprod.phonepe.com/apis/pg-sandbox