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.
Single Till Transaction API
This API retrieves the details of a specific till transaction based on the requestId provided.
Endpoint
GET /api/sandbox/v1/till/single
Base URL
https://api.kiotapay.co
Query Parameters
| Parameter | Type | Description | Required |
|---|
requestId | string | The unique ID of the request for the till 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. |
Interactive API
Example Curl Request
curl --location 'https://api.kiotapay.co/api/sandbox/v1/till/single?companyId=4d6e1ea9-5ab8-496a-978f-7e9b2bce80c4&requestId=20f6da4c-f1fa-4af0-9e5c-72c4e7ac8f57'
{
"status": 200,
"message": "Success",
"data": {
"id": 1,
"amount": 1000.0,
"uuid": "20f6da4c-f1fa-4af0-9e5c-72c4e7ac8f57",
"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"
},
"accountNumber": "435567676",
"businessNumber": "12345",
"remarks": "Here are the remarks",
"occasion": "Here is the occasion",
"originatorConversationId": "10721650-d5f0-4dac-8d17-cb3b74df34c8",
"conversationId": "AG_20230420_2010759fd5662ef6d054",
"callbackUrl": "https://kiotapay.co.ke",
"createdAt": "2025-01-24T17:10:30.65054",
"updatedAt": "2025-01-24T17:10:30.65054",
"status": "PENDING",
"responseCode": 0,
"receiverName": null,
"transactionReceipt": null,
"responseDescription": "Accept the service request successfully."
}
}
