Pay a paybill

Move money from your Kiotapay wallet into another business's paybill — utilities, suppliers, statutory payments.

Unlike a till payment, accountNumber is required: it identifies which account under the recipient's paybill the money belongs to.

Authorization

bearerAuth

AuthorizationBearer <token>

The access_token returned by POST /api/v1/get-token.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

businessNumber*string

The recipient's paybill number.

accountNumber*string

The account number under the recipient's paybill.

amount*number

Amount in Kenyan shillings.

remarks?string

Additional information about the transaction.

occasion?string

Purpose of the transaction.

callbackUrl*string

A publicly reachable endpoint accepting POST, where confirmation is delivered.

Formaturi

referenceId?string

Your own system's request ID.

Response Body

`application/json`

Callbacks

curl -X POST "https://example.com/api/sandbox/v1/paybill" \  -H "Content-Type: application/json" \  -d '{    "businessNumber": "2232334",    "accountNumber": "22442244",    "amount": 1000,    "remarks": "Here are the remarks",    "occasion": "Here is the occasion",    "callbackUrl": "https://kiotapay.co.ke",    "referenceId": "1234"  }'

{  "status": 201,  "message": "Success",  "data": {    "requestId": "8fa1fab3-a1d6-41fd-9199-d5517efc0d41",    "accountNumber": "22442244",    "businessNumber": "2232334",    "amount": 1000,    "status": "PENDING"  }}

Pay a paybill

Authorization

Request Body

Response Body

201application/json

400application/json

401application/json

Callbacks

transactionResultPOST{$request.body#/callbackUrl}

`application/json`

`application/json`

`application/json`