Transaction Status Enquiry

Description:: This API will fetch the transaction details according to the provided request mentioned below.

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	Param B. To be used by the client as per requirement, length ≤ 20. E.g. - "branch1"	String	Optional
$8	Param_c	Param C. To be used by the client as per requirement, length ≤ 20. E.g.- "loanID1234"	String	Optional

Sample Request Body

---

{ "$1": "Matm_txn_status_api", "$4": "2022-10-20", "$5": "2022-10-31", "$6": "82682", "$7": "branch1", "$8": "loanID1234" }

Response Body Parameters

Parameters	Parameter description	Data type
status	Transaction status code. E.g - 200	Integer
message	Corresponding message of the status. E.g. - Success	String
length	Number of records displayed. E.g - 1	Integer
results	Displays the transaction record
statusDesc	Status description of the transaction. E.g. - "Suspected Fraud Decline"	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
retailerUserName	Retailer’s user name. E.g. - "ORTN000011"	String
username	User Name. E.g. - "oasysapi"	String
clientreferenceid	Reference id the client. E.g. - "ORTN00001120230710154525005"	String
param_b	To be used as per client. E.g.- "branch1"	Alphanumeric String
param_c	To be used as per client. E.g.- "loanID1234"	Alphanumeric String

Sample Response Body

SUCCESS :

{ "status": 200, "message": "Success", "length": 1, "results": [ { "statusDesc": "failed to build balance enquiry request", "createdDate": 1666943087743, "updatedDate": 1666943087950, "productCode": "MATM2", "txnType": "MATM2_BALANCE_ENQUIRY", "txnAmount": 0, "txnDateTime": 1666943087743, "customeridentIfication": "xxxx-xxxx-xxxx-xxxx", "status": "FAILED", "rrn": null, "txnId": "#1035459100709756928", "retailerUserName": "itpl", "userName": "demo", "clientreferenceid": "82682", "param_b": "branch1", "param_c": "loanID1234" } ] }

SUCCESS WITH NO DATA :

{ "status": 1, "message": "Transaction response with no data for required parameters", "length": 0, "results": [] }

FAILED:

NOTE : This is a BigQuery error for any type mismatch or misleading data. For this issue please contact ourdevelopers for solution.

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

FAILED (Wrong First Parameter):

{ "status": 0, "message": "First parameter is Wrong. Kindly provide the correct one" }

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.