Till Status API

This API allows a company to fetch the status of a specific till transaction using the requestId.

Endpoint

GET /api/sandbox/v1/till/status

Base URL

https://api.kiotapay.co

Query Parameters

Parameter	Type	Description	Required
✅
`requestId`	`string`	The unique ID of the request for which the status is being checked.	✅

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.

Interactive API

Example Curl Request

curl --location 'https://api.kiotapay.co/api/sandbox/v1/auth/spending/till/status?companyId=4d6e1ea9-5ab8-496a-978f-7e9b2bce80c4&requestId=20f6da4c-f1fa-4af0-9e5c-72c4e7ac8f57'

Sample Response

{
    "status": 201,
    "message": "Success",
    "data": {
        "accountNumber": "435567676",
        "businessNumber": "12345",
        "requestId": "20f6da4c-f1fa-4af0-9e5c-72c4e7ac8f57",
        "amount": 1000.0,
        "status": "PENDING"
    }
}

Authentication

Checkout

Mobile Money (B2C)

Mobile Money (C2B & STK Push)

Business Payments (Till)

Business Payments (Paybill)

Bank Collections

Bank Payouts

Virtual Accounts

Errors

Till Status API

Till Status API

Endpoint

Base URL

Query Parameters

Request Headers

Interactive API

Example Curl Request

​Till Status API

​Endpoint

​Base URL

​Query Parameters

​Request Headers

​Interactive API

​Example Curl Request

Till Status API

Endpoint

Base URL

Query Parameters

Request Headers

Interactive API

Example Curl Request