Request Method :: POST

Description:The Transaction Status Enquiry API allows the system to check the real-time status of a transaction using a unique transaction reference or ID. It helps determine whether a transaction is successful, pending, or failed, and is typically used for reconciliation or to update the customer on their payment status.

Headers

---

Content-Type: application/JSON

header_secrets:  To be shared during integration by ISU Team

pass_key:  To be shared during integration by ISU Team

Request Body Parameters

Parameters	Description	Min Length	Max Length	Data type	Mandatory/Optional
productCode	Product Code. E.g. UPI	1	50	String	Mandatory
TxnDate	Date of transaction (YYYY-MM-DD). E.g. 2025-04-10	10	10	String	Mandatory
clientRefId	Unique client reference ID needs to be generated by partner/Merchant for each new transaction associate with Transaction. E.g. FIQ9666053226371	10	19	String	Mandatory

Sample Request Body

---

{ "productCode": "UPI", "txnDate": "2025-04-10", "clientRefId": "FIQ9666053226371" }

Encrypted Sample Request Body

---

{ "RequestData": "x2v2eJV2ohLK98EIXxV+LWsa4Y1vIIkfBiIUwb3Vb3nVv4LW7QfNjDnyli7+7Qv4CRUcGX5/LufM2uX5BXCRHSibCjMDH+TZfOeTtYIV3Ls8lBnklXsMA9wulOq6Lhk5" }

Response Body Parameters

Parameters	Description	Min Length	Max Length	Data type
length	No. of transactions status posted against given client reference id.	NA	NA	String
message	Response Message	1	10	String
results	Contains the following	NA	NA	Array
statusDesc	Status Description	1	50	String
createdDate	Date of Transaction Creation (timestamp)	10	30	String
updatedDate	Date of Transaction Update (timestamp)	10	30	String
productCode	Product Code (e.g., UPI)	1	10	String
paymentMode	Payment Mode (e.g., UPI_INTENT)	1	10	String
txnAmount	Transaction amount for which transaction is initiated	1	10	String
txnDateTime	Transaction Timestamp	10	30	String
payerVPA	Payer UPI ID	1	100	string
status	Status of Transaction	1	10	string
rrn	Bank Reference Number	1	40	String
txnId	Transaction ID	18	18	string
userName	Name of the Payer	1	50	String
clientRefId	Unique client reference needs to be generated by partner/Merchant for each transaction	10	19	String
param_a	Optional Parameter A	0	100	String
param_b	Optional Parameter B	0	100	String
param_c	Optional Parameter C	0	100	String
status	Status Code	1	3	String

Sample Response Body

---

SUCCESS:

{ "length": 1, "message": "Success", "results": [ { "clientRefId": "#FIQ9666053226371", "createdDate": 1744308468778, "param_a": "FIQ9666053226371", "param_b": null, "param_c": null, "payerVPA": "payer@upi", "paymentMode": "UPI_INTENT", "productCode": "UPI", "rrn": "NSL00000000000000543005212830921904", "status": "SUCCESS", "statusDesc": "Successfully credited", "txnAmount": 1.95, "txnDateTime": 1744308468778, "txnId": "#543005212830921904", "updatedDate": 1744308652720, "userName": "qauser" } ], "status": 200 }

SUCCESS(Encrypted):

---

{ "ResponseData": "2HYKlQyKLiebhu9Xrb8Pql4Ura3iqK9ut1mBrF5ewpAZrv2UtZzqkbP84g9je+MMNabhm3/Dsg1xyDIda8hITqFAxy3r6sWeSq0sKWTvgcD6J+gScjgAmPFHSfAN9T/N+zCRlMw9pIlc1iWAk8IZiVA0OZc7qAUk7RsvoETLuiyA2oycW70ieK+FQsALaupJ1AAMH5y6QX298aRPagYXlgSvtJbS++mCARSumCymB9TqDLV8EZjcDz8SLmqPXq0pL42ouyp4W/JOD1M4pf1A7pojcLM0RssRMPpKTRX0h3CExJjPHR8zPEBeO+2YreBrQYmogPCC4wPrpmixcM63aVEitDF748E+v+8L5W18bIazfxDmQ5fLv9xAcFAH7ZT2IRhBEMfdaU5tUVkRT7VpEDJ/dWrtxq+wxShqZnb+0DUwv/IvS1y4aUeQUAy/EMb83tlh+0eQqDCivdsPWPfQF3HAMjtjke0564F7rCusVSU1T/etlBAtERs+8uYASdVpQRM5TckcdC1hO7CpxH5wjWKX2DLqontEDqTLm1bpqtDbizBfUyvA5NtIuk2yWEjP7WEyy4L3tIBk3WrmwEUaaLvQVA1v1LGlsE1rtsMSYm1kt0mOD/HBbS5O1P5yfOCW+A2RhRtKSuosSD8wa/SDnw==" }

SUCCESS With No Data:

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

 

FAILED:

Error from Passport Verification API:

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

Status Codes

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