Documentation Index
Fetch the complete documentation index at: https://developer.kiotapay.co/llms.txt
Use this file to discover all available pages before exploring further.
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. | ✅ |
| 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'
{
"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": "maina@gmail.com",
"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"
}
}
