Transaction Status Enquiry API
Description - This API enables the user to enquire about the status of the transaction at a later time. After passing the required parameters (pertaining to a particular transaction) in the request body the user is presented the details of this particular transaction as the response. |
Headers
Content-Type: application/JSON |
client_id: To be shared during integration |
client_secret: To be shared during integration |
Request Body Parameters
Parameter | Parameter Name | Parameter description with validation and examples |
Data type | Mandatory/ Not Mandatory |
$1 | Query Operation | Hard-coded field. It must Not be NULL. Must pass the value provided below-"DMT_txn_status_api" |
String | Mandatory |
$4 | Start Date | Date field in yyyy-mm-dd format pass in string. It must Not be NULL. It must be same as the End Date. E.g.-"2023-02-21" |
String | Mandatory |
$5 | End Date | Date field in yyyy-mm-dd format pass in string. It must Not be NULL. It must be same as the Start Date. E.g.-"2023-02-21" |
String | Mandatory |
$6 | ClientRefID | Client reference id. It must Not be NULL. E.g. - "290209276702413230" |
String | Mandatory |
$10 | Transaction ID | Transaction Id must contains integer value pass as string, length ≤ 18 . E.g. - "7539296023420928" |
Integer | Not Mandatory |
Sample Request Body
{
"$1": "DMT_txn_status_api", "$4": "2023-02-21", "$5": "2023-02-21", "$6": "290209276702413230", "$10": "7539296023420928" } |
Sample Response Body
Success
{
"status": 200, "message": "Success", "length": 1, "results": [ { "statusDesc": "Transaction Success", "createdDate": 1676976061003, "updatedDate": 1676976062007, "productCode": "DMT", "txnType": "IMPS_FUND_TRANSFER", "txnAmount": 3000, "txnDateTime": 1676976061003, "customeridentIfication": "8895462778", "status": "SUCCESS", "rrn": "305216223756", "txnId": "#7539296023420928", "gatewayId": "#75392960234209281", "txnStausCode": "4", "retailerUserName": "qaapitestuser", "userName": "isutest", "clientreferenceid": "290209276702413230", "param_b": null, "param_c": "qaapitestuser" } ] } |
Success with no data
{
"status": 1, "message": "Transaction response has no data for required parameters", "length": 0, "results": [] } |
! Note: If you receive this response kindly treat this transaction as a failed transaction. |
Failed
{
"status": 0, "message": "Query error: Unrecognized name: undefined at [12:29]" } |
Detailed Status Code
Sl. no. | Status | Code | Description | HTTP Status Code |
01 | SUCCESS | 4 | IMPS SUCCESS | 200 |
02 | SUCCESS | 5 | IMPS INPROGRESS TO SUCCESS | 200 |
03 | FAILED | 3,12,8 | IMPS & NEFT FAILED | 200 |
04 | INPROGRESS | 20,0,1,2,3,4,6,9 | IMPS & NEFT INPROGRESS | 200 |
05 | SUCCESS | 20 | IMPS INPROGRESS TO SUCCESS | 200 |
06 | FAILED | 0 | IMPS & NEFT INPROGRESS TO FAIL | 200 |
07 | SUCCESS | 22 | IMPS SUCCESS TRANSACTION | 200 |
08 | REFUNDED | 0,3 | IMPS FAILED TRANSACTION | 200 |
09 | SUCCESS | 6 | NEFT INPROGRESS TO SUCCESS | 200 |
! Note: How do you maintain status code:
|