Get STK Transaction Status

Get STK Transaction Status API

This API retrieves the status of a single STK transaction using the provided requestId.

---

Endpoint

GET /api/sandbox/v1/stk/status

---

Base URL

https://api.kiotapay.co

---

Query Parameters

Parameter	Type	Description	Required
requestId	string	The unique identifier for the specific transaction.	✅

---

Request Headers

Key	Value	Required	Description
Content-Type	application/json	✅	Specifies that the request body is in JSON format.
Authorization	Bearer <your-token>	✅	API authentication token. Replace <your-token> with a valid JWT.

---

Example Request

cURL Command

curl --location 'https://api.kiotapay.co/api/sandbox/api/v1/stk/status?requestId=43d23a1d-0476-4d49-a6eb-0a402c50d968' \
--header 'Content-Type: application/json'

Sample Response

{
    "status": 200,
    "message": "Success",
    "data": {
        "requestId": "43d23a1d-0476-4d49-a6eb-0a402c50d968",
        "status": "PENDING",
        "amount": 10,
        "phoneNumber": "0745362174"
    }
}