Get Single STK Collection

Get Single STK Collection API

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

---

Endpoint

GET /api/sandbox/v1/stk/single

---

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/v1/stk/single?requestId=43d23a1d-0476-4d49-a6eb-0a402c50d968' \
--header 'Content-Type: application/json'

Sample Response

{
    "status": 200,
    "message": "Success",
    "data": {
        "id": 1,
        "uuid": "43d23a1d-0476-4d49-a6eb-0a402c50d968",
        "merchantRequestId": "29115-34620561-1",
        "checkoutRequestId": "ws_CO_191220191020363925",
        "phoneNumber": "0745362174",
        "description": "Here is the description",
        "organisation": {
            "id": 2,
            "uuid": "4d6e1ea9-5ab8-496a-978f-7e9b2bce80c4",
            "name": "Maina Properties Limited Ke",
            "phoneNumber": "254745362174",
            "email": "[e-mail]",
            "uniqueReference": "4780606",
            "createdAt": "2025-01-24T13:35:12.151225",
            "updatedAt": "2025-01-24T13:35:12.151225"
        },
        "amount": 10,
        "status": "PENDING",
        "accountReference": "Here is the reference",
        "responseCode": 0,
        "responseDescription": "Success. Request accepted for processing",
        "customerMessage": "Success. Request accepted for processing",
        "callbackUrl": "https://kiotapay.co.ke",
        "createdAt": "2025-01-27T11:05:17.867373",
        "updatedAt": "2025-01-30T11:00:00.633493"
    }
}