Get Paybill Transaction Status

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

Parameter	Type	Description	Required
requestId	string	The unique identifier for the specific transaction.	✅

---

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.

---

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