# Transaction Status txnId API
**API for checking the transaction status using txn id**
| Endpoint |
| ------------------------------------------------------------------------------------------------------------------------------------ |
| **Request:****GET /couapp/transactions/payment/byTxnId?txnId=fdd28ccc-90bd-4719-8adf-26e085d18d54** |
**Request Parameters**
**The various parameters are explained below:**
| Parent Property/Element | Property/Element Name | Mandatory | Data Type | Description |
| -------------------------------------- | --------------------- | --------- | --------- | ------------------------------------------------------------------------------------------------------------------------------ |
| \[ROOT] (No parent property / element) | txnId | M | UUID | Txn id is unique id which is generated while initiating the bill payment request, it can be get from the bill paymentresponse. |
**Response Parameters**
**The various parameters are explained below:**
| Parent Property/Element | Property/Element Name | Mandatory | Data Type | Description |
| -------------------------------------- | ---------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------- |
| \[ROOT] (No parent property / element) | txnId | M | UUID | Machine-generated Unique ID for a transaction, used internally |
| | refId | M | Alphanumeric | |
| | txnNpciId | C | Alphanumeric | |
| | orderId | M | String | |
| | billId | M | | |
| | userType | M | | |
| | userId | M | Unique ID assigned to the Agent by NPCI | |
| | txnAmount | M | Total Transaction Amount for the Bill | |
| | totalTxnAmount | M | Actual bill amount inclusive of all charges | |
| | billerName | M | Name of the Biller assigned by NPCI | |
| | billerCategory | M | Category of the Biller | |
| | billerId | M | Unique ID assigned to the Biller by NPCI Fixed length - 14 | |
| | clientReqId | M | Unique ID assigned for each transaction, to be used internally | |
| | offUsPay | M | Flag indicating if it is an electronic ON-US or OFF-US transaction | |
| | splitPay | M | Flag indicating if the bill is paid using two different payment modes | |
| | quickPay | M | Flag indicating if the payment is initiated without a fetch or not | |
| | paymentMode | M | | |
| | custConvFee | M | | |
| | currency | M | Defines the currency in which the payment is initiated. 356 stands for INR | |
| | requestedIp | M | IP address of the initiating Server | |
| | customerMobNo | M | | |
| | macAddress | M | | |
| | splitPayAmount | M | | |
| | couCustConvFee | M | | |
| | settlementVerification | M | Flag indicating if Settlement Verification is enabled for the transaction | |
| | fundTxnType | M | | |
| | reason | M | | |
| | amountTags | M | | |
| | customerParamsDAOS | M | | |
| | paymentInformation | M | | |
| | customerParamsDAO | M | | |
| | planId | M | | |
| | planType | M | | |
| | status | M | Status of the Operation Posible values : BILL\_PAYMENT\_REQUESTED, BILL\_PAYMENT\_INITIATED, BILL\_PAYMENT\_SUCCESS, BILL\_PAYMENT\_FAILED | |
| | actionType | C | Type of Bill Payment. Possible Values: BILL\_FETCH QUICKPAY BILL\_VALIDATE | |
| | userId | M | Agent id Fixed length - 20 | |
| | creationDate | M | ISO 8601 Timestamp for the Bill Creation date | |
| | modifiedDate | M | ISO 8601 Timestamp for the Bill Modification date | |
| | createdEpochDate | M | UNIX Epoch Timestamp for the Bill Creation date | |
| | modifiedEpochDate | M | UNIX Epoch Timestamp for the Bill Modification date | |
| agentFundTransfer | fundTxnReferenceId | M | | |
| | fundTxnRemarks | M | | |
| | fundTxnDate | M | | |
| | fundUTR | M | | |
| | fundRespRemarks | M | | |
| | agentNpciId | M | | |
| | txnRefId | M | | |
| | fundStatus | M | Status of fund transfer Possible values: FUND\_TRANSFER\_SUCCESS, FUND\_TRANSFER\_FAILED | |
| generalResp | statusCode | M | 200- SUCCESS Other than 200-Failure | |
| | status | M | String | It is either “Success” or failure |
| | message | M | String | Contains the reason message for failure / success |
**Json Formatted Response Example**
```json
{
"transactionDAO": {
"txnId": "fdd28ccc-90bd-4719-8adf-26e085d18d54",
"refId": "ukpeZdOmtQCK4ByLFatdrWhtIiucPIXigYF",
"txnNpciId": "FE411343V3mFjMC0aqOp",
"orderId": "DFW9GM5B65WV88XMKG9815KQ",
"actionType": "VALIDATE_PAY",
"billId": "c9670952-ebd7-487a-b6ea-49f2b4d4a718",
"userType": "organization",
"userId": "FE41FE42BNK519012345",
"txnAmount": 9900,
"totalTxnAmount": 9900,
"billerId": "HUNG00000NATJL",
"billerCategory": "Subscription",
"billerName": "Hungama Music",
"clientReqId": null,
"offUsPay": "NO",
"splitPay": "NO",
"quickPay": "NO",
"paymentMode": "Cash",
"custConvFee": 0,
"currency": "356",
"status": "BILL_PAYMENT_SUCCESS",
"requestedIp": "10.11.2.4",
"customerMobNo": "8281970523",
"macAddress": null,
"splitPayAmount": 0,
"couCustConvFee": 0,
"settlementVerification": false,
"fundTxnType": "WALLET_TRANSFER",
"reason": null,
"amountTags": [],
"customerParamsDAOS": [],
"paymentInformation": [],
"customerParamsDAO": [
{
"paramsId": "78dd4417-726f-4f45-a671-4ead120417e2",
"name": "Mobile Number",
"value": "8281970522",
"type": null
},
{
"paramsId": "0bc3c1b3-019a-4cf3-863b-4455d0eac80c",
"name": "Email ID",
"value": "jithesh@digiledge.in",
"type": null
},
{
"paramsId": "8a810c5c-d8ad-4092-98a5-a98e20b6e7d2",
"name": "Id",
"value": "2862",
"type": null
}
],
"creationDate": "2021-12-09T10:51:08.278329",
"modifiedDate": "2021-12-09T10:51:15.040695",
"createdEpochDate": 1639047068,
"modifiedEpochDate": 1639047075,
"planId": null,
"planType": null
},
"agentFundTransfer": {
"fundTxnReferenceId": "DFW9GM5B65WV88XMKG9815KQ",
"fundTxnRemarks": "BBPS-AGENT/fdd28ccc-90bd-4719-8adf-26e085d18d54",
"fundTxnDate": "2018-04-10 14:36:09.404068",
"fundTxnAmt": 9900,
"fundUTR": "801218794476",
"fundRespRemarks": "SUCCESS",
"agentNpciId": "FE41FE42BNK519012345",
"txnRefId": "fdd28ccc-90bd-4719-8adf-26e085d18d54",
"fundStatus": "FUND_TRANSFER_SUCCESS"
},
"generalResp": {
"statusCode": "200",
"status": "success",
"message": "Successfully transaction retrieved by txnId",
"remarks": ""
}
}
```