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

URL: To be shared later

 

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": "UMatm_txn_status_api_common", "$4": "2023-07-10", "$5": "2023-07-10", "$6": "ORTN00001120230710154525005" }

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
status	Status of the transaction. E.g. - "AUTH_DECLINE"	String
transaction_status_code	Transaction Status Code. E.g. - 3	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": "Suspected Fraud Decline", "createdDate": 1688984141950, "updatedDate": 1688984145754, "productCode": "mATM", "txnType": "mATM_CASH_WITHDRAWAL", "txnAmount": 100, "txnDateTime": 1688984141950, "customeridentIfication": "xxxx-xxxx-xxxx-0818", "status": "AUTH_DECLINE", "transaction_status_code": 3, "rrn": "319115329358", "txnId": "#1127905981926219776", "retailerUserName": "ORTN000011", "userName": "oasysapi", "clientreferenceid": "ORTN00001120230710154525005", "param_b": null, "param_c": null } ] }

Success with no Data :

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

Failed:

Note: The following is a BigQuery error for any type mismatch or misleading data. For this issue, please contact our developers for resolution.

 

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

 

Failed (Incorrect First Parameter):

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

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.