Headers
Header Name | Header Value |
---|---|
Content-Type | application/json |
X-VERIFY | SHA256(“/v3/recurring/debit/status/{merchantId}/{merchantTransactionId}” + salt key) + ### + salt index |
Path Parameters
Parameter Name | Type | Description | Mandatory |
---|---|---|---|
merchantId | String | Unique Merchant ID assigned to the merchant by PhonePe | Yes |
merchantTransactionId | String | Merchant Transaction Id for which status is to be fetched | Yes |
{
"success": true,
"code": "SUCCESS",
"message": "Your payment is successful.",
"data": {
"merchantId": "MID12345",
"transactionId": "TX1234567890",
"notificationDetails": {
"notificationId": "OMN2006110139450123456789",
"amount": 39900,
"state": "NOTIFIED",
"notifiedAt": 1622539751586,
"validAfter": 1622539750000,
"validUpto": 1622885350000
},
"transactionDetails": {
"providerReferenceId": "P1806151323093900554957",
"amount": 39900,
"state": "COMPLETED",
"payResponseCode": "SUCCESS",
"paymentModes": [
{
"mode": "ACCOUNT",
"amount": 399000,
"utr": "816626521616",
"maskedAccountNumber": "XXXXXX999",
"umn": "9123dac357de123cb2cbd45283412305@ybl"
}
]
},
"subscriptionDetails": {
"subscriptionId": "OMS2006110139450123456789",
"state": "ACTIVE"
}
}
}
{
"success": true,
"code": "SUCCESS",
"message": "Payment Failed",
"data": {
"merchantId": "MID12345",
"transactionId": "TX1234567890",
"notificationDetails": {
"notificationId": "OMN2006110139450123456789",
"amount": 39900,
"state": "NOTIFIED",
"notifiedAt": 1622539751586,
"validAfter": 1622539750000,
"validUpto": 1622885350000
},
"transactionDetails": {
"providerReferenceId": "P1806151323093900554957",
"amount": 39900,
"state": "FAILED",
"payResponseCode": "AUTHORIZATION_FAILED",
"payResponseCodeDescription": "Bank did not authorise"
},
"subscriptionDetails": {
"subscriptionId": "OMS2006110139450123456789",
"state": "FAILED"
}
}
}
Response Parameters
Field Name | Data Type | Description |
---|---|---|
merchantId | String | Merchant ID provided by PhonePe |
transactionId | String | Merchant’s TransactionId |
notificationDetails | Object | Contains notification details |
transactionDetails | Object | Same as normal Transaction, please refer here |
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 |
{“method”:”get”,”url”:”/v3/recurring/debit/status/{merchantId}/{merchantTransactionId}”,”auth”:”required”,”results”:{“codes”:[{“name”:””,”code”:”{\n \”success\”: true,\n \”code\”: \”SUCCESS\”,\n \”message\”: \”Your payment is successful.\”,\n \”data\”: {\n \”merchantId\”: \”MID12345\”,\n \”transactionId\”: \”TX1234567890\”,\n \”notificationDetails\”: {\n \”notificationId\”: \”OMN2006110139450123456789\”,\n \”amount\”: 39900,\n \”state\”: \”NOTIFIED\”,\n \”notifiedAt\”: \”1622539751586\”,\n \”validAfter\”: \”1622539750000\”,\n \”validUpto\”: \”1622885350000\”\n },\n \”transactionDetails\”: {\n \”providerReferenceId\”: \”P1806151323093900554957\”,\n \”amount\”: 39900,\n \”state\”: \”COMPLETED\”,\n \”payResponseCode\”: \”SUCCESS\”,\n \”paymentModes\”: [\n {\n \”mode\”: \”ACCOUNT\”,\n \”amount\”: 399000,\n \”utr\”: \”816626521616\”\n }\n ]\n },\n \”subscriptionDetails\”: {\n \”subscriptionId\”: \”OMS2006110139450123456789\”,\n \”state\”: \”ACTIVE\”\n }\n }\n}”,”language”:”json”,”status”:200},{“name”:””,”code”:”{\n \”success\”: false,\n \”code\”: \”RECORD_NOT_FOUND\”,\n \”message\”: \”Record not found\”,\n \”data\”: {}\n}”,”language”:”json”,”status”:500}]},”params”:[{“name”:”Content-Type”,”type”:”string”,”enumValues”:””,”default”:”application/json”,”desc”:””,”required”:true,”in”:”header”,”ref”:””,”_id”:”60af15fac6650a0068efc65a”},{“name”:”X-VERIFY”,”type”:”string”,”enumValues”:””,”default”:””,”desc”:”SHA256(\”/v3/recurring/debit/status/{merchantId}/{merchantTransactionId}\” + salt key) + ### + salt index”,”required”:true,”in”:”header”,”ref”:””,”_id”:”60af15fac6650a0068efc659″},{“name”:”merchantId”,”type”:”string”,”enumValues”:””,”default”:””,”desc”:”Unique Merchant ID assigned to the merchant by PhonePe”,”required”:false,”in”:”path”,”ref”:””,”_id”:”60af15fac6650a0068efc658″},{“name”:”merchantTransactionId”,”type”:”string”,”enumValues”:””,”default”:””,”desc”:”merchant transaction Id for which status is to be fetched”,”required”:false,”in”:”path”,”ref”:””,”_id”:”60af15fac6650a0068efc657″}],”apiSetting”:”63bb01b11abcf7046d98754c”,”examples”:{“codes”:[]}}
https://api-preprod.phonepe.com/apis/pg-sandbox