Status Check
Status Check
Description :
This API endpoint is used to check current status of the transaction
Endpoint URL :Request Parameters
| Request Parameter | Data Type | Default Value | Required | Description | Change Date | Change Description |
|---|---|---|---|---|---|---|
| token | string | Yes | API access token for user authentication. [To known more about token Click Here] |
|||
| refid | string | Yes | Your Unique Reference id when provide on transaction |
Request Example
token=02c4aa7315a0778abb7095c944a1f09b&refid=35468234578
Responses (JSON)
{
"txnid": "T20230901074017FLCN",
"status": "SUCCESS",
"mobileno": "9439756978",
"amount": "107",
"operatorcode": "BSNL",
"operator_name": "BSNL",
"refid": "35468234578",
"operatorid": "6534882923",
"message": "SUCCESS",
"remainamount": "13897.94"
}
- STATUS : SUCCESS
- Description: Transaction successfully completed.
- 'txnid' (string): "transaction id of transaction"
- 'status' (string): "status of transaction"
- 'customer_id' (string): "customer id of transaction"
- 'amount' (string): "amount of transaction"
- 'operatorcode' (string): "operator code of transaction"
- 'request_time' (string): "time of request of transaction"
- 'response_time' (string): "time of response of transaction"
- 'refid' (string): "refid of transaction"
- 'operatorid' (string): "utr of transaction"
- 'message' (string): "message of transaction"
- 'remainamount' (string): "remain amount after transaction"
{"txnid": "T20230901071207OPRQ", "status": "PENDING", "customer_id": "9434271405", "amount": "97", "operatorcode": "BT", "operator_name": "BSNL", "request_time": "2023-09-01 07:16:57", "response_time": "2023-09-01 07:17:01", "refid": "35468234578", "operatorid": "6534870098", "message": "Transaction under proccess", "remainamount": "14384.135"}
- STATUS : PENDING
- Description: Transaction under proccess.
- 'txnid' (string): "transaction id of transaction"
- 'status' (string): "status of transaction"
- 'customer_id' (string): "customer id of transaction"
- 'amount' (string): "amount of transaction"
- 'operatorcode' (string): "operator code of transaction"
- 'request_time' (string): "time of request of transaction"
- 'response_time' (string): "time of response of transaction"
- 'refid' (string): "refid of transaction"
- 'operatorid' (string): "utr of transaction"
- 'message' (string): "message of transaction"
- 'remainamount' (string): "remain amount after transaction"
{"txnid": "T20230901071207OPRQ", "status": "FAILED", "customer_id": "9434271405", "amount": "97", "operatorcode": "BT", "operator_name": "BSNL", "request_time": "2023-09-01 07:16:57", "response_time": "2023-09-01 07:17:01", "refid": "35468234578", "operatorid": "6534870098", "message": "Transaction Failed", "remainamount": "14384.135"}
- STATUS : FAILED/REFUND
- Description: Transaction failed due to any reason.
- 'txnid' (string): "transaction id of transaction"
- 'status' (string): "status of transaction"
- 'customer_id' (string): "customer id of transaction"
- 'amount' (string): "amount of transaction"
- 'operatorcode' (string): "operator code of transaction"
- 'request_time' (string): "time of request of transaction"
- 'response_time' (string): "time of response of transaction"
- 'refid' (string): "refid of transaction"
- 'operatorid' (string): "utr of transaction"
- 'message' (string): "message of transaction"
- 'remainamount' (string): "remain amount after transaction"
{"status": "UNKNOWN", "message": "Unable to check transaction status"}
- STATUS : UNKNOWN
- Description: A specific error message.
- 'status' (string): "UNKNOWN"
- 'message' (string): "Unable to check transaction status"
Note
- The API endpoint should be accessed via a GET request.
- Please always update your transaction with status key and SUCCESS, PENDING, FAILED, REFUND value.
- Implement proper error handling on the client side to display user-friendly error messages based on the 'status' and 'message' fields in the response.
- You can check transaction status of the current & last month only.