Transaction Status Enquiry

post-request

Description:: : If the final transaction response will not be received by client due to any technical or network issue then client can consume this API to get the final response for given transaction Id as path variable.

URL: https://apidev.iserveu.online/sandbox/statuscheck/txnreport

Headers

Content-Type: application/JSON

client_id: To be shared during integration

client_secret: To be shared during integration

Request Body Parameters

Parameters	Parameter Name	Parameter description with validation and examples	Attribute type	Mandatory/Not Mandatory
$1	Query Operation	Hard-coded field. Must pass the value provided below- "UMatm_txn_status_api_common"	String	Mandatory
$4	Start Date	Date field in yyyy-mm-dd format pass in string. It should be same as the End date. E.g. - "2023-07-10"	String	Mandatory
$5	End Date	Date field in yyyy-mm-dd format pass in string. It should be same as the Start Date. E.g. -"2023-07-10"	String	Mandatory
$6	ClientRefId	Client reference id. length ≤ 20. E.g.- "ORTN00001120230710154525005"	String	Mandatory
$7	Param_b	""	String	Optional

Sample Request Body

{ "$1": "UAeps_txn_status_api", "$4": "2024-06-15", "$5": "2024-06-15", "$6": "416719000035", "$7": "" }

Response Body Parameters

Parameters	Parameter description	Data type
statusDesc	Status description of the transaction E.g. - "transaction success"	String
createdDate	Created is send in timestamp. E.g. - 1688984141950	Timestamp
updatedDate	Updated is send in timestamp. E.g. - 1688984145754	Timestamp
productCode	Product Code . E.g. - "mATM"	String
txnType	Operation type of transaction. E.g. - "mATM_CASH_WITHDRAWAL"	String
txnAmount	Transaction amount. E.g. - 100	String
txnDateTime	Date and time of transaction. E.g. - 1688984141950	String
customeridentIfication	Card number. E.g. - "xxxx-xxxx-xxxx-0818"	String
rrn	RRN Number. E.g. - "319115329358"	String
txnId	Unique id of the transaction. E.g. - "#1127905981926219776"	String
username	User Name. E.g. - "oasysapi"	String
clientRefId	Reference id the client. E.g. - “ 8287645478994 ”	String
statusCode	Transaction status code. E.g - 200	Integer

Sample Response Body

SUCCESS :

{ "status": 200, "message": "Success", "length": 1, "results": [ { "statusDesc": "GRPC client error", "createdDate": 1664191677624, "updatedDate": 1664191702262, "productCode": "UnifiedAEPS", "txnType": "AEPS_CASH_WITHDRAWAL", "txnAmount": 100, "txnDateTime": 1664191677624, "customeridentIfication": "xxxx-xxxx-0712", "status": "INITIATED", "rrn": "N/A", "txnId": "#1023918565599748097", "retailerUserName": "aepsTestR", "userName": "isutest", "clientreferenceid": "903550389071126", "param_b": null, "param_c": null } ] }

SUCCESS WITH NO DATA :

{ "message": "No record found in the Query", "length": 0, "Report": [], "status": 1 }

FAILED:

{ "status": 0, "message": "Query error: Unrecognized name: undefined at [12:29]" }

Detailed Status Codes

Code	Significance	Description
0	FAILED	Get error message in Response.
200	SUCCESS	Transaction response received with data.
1	SUCCESS	Transaction response with no data for required parameters

NOTE: The date and time stamp present across all endpoints in the document is in UTC timestamp format.