Till Status API

Endpoint to fetch the status of a till transaction using the requestId .

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"
    }
}