Skip to main content

​
Paybill Transaction Status API

This API retrieves the status of a specific Paybill transaction based on the requestId.

​
Endpoint

GET /api/sandbox/v1/paybill/status

​
Base URL

https://api.kiotapay.co

​
Query Parameters

ParameterTypeDescriptionRequired
requestIdstringThe unique identifier for the specific transaction.✅

​
Request Headers

KeyValueRequiredDescription
Content-Typeapplication/json✅Specifies that the request body is in JSON format.
AuthorizationBearer <your-token>✅API authentication token. Replace <your-token> with a valid JWT.

​
Example Request

​
cURL Command

curl --location --request GET 'https://api.kiotapay.co/api/sandbox/v1/paybill/status?requestId=4f88dd2e-c4b4-4a3f-9605-1679686a6641' \
--header 'Content-Type: application/json'
Sample Body 
{
    "status": 200,
    "message": "Success",
    "data": {
        "accountNumber": "22442244",
        "businessNumber": "2232334",
        "requestId": "4f88dd2e-c4b4-4a3f-9605-1679686a6641",
        "amount": 1000.0,
        "status": "PENDING"
    }
}