Pay a till

Move money from your Kiotapay wallet to another business's till number.

The response returns immediately with a PENDING status and a requestId. The final outcome is delivered to your callbackUrl.

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 till (shortcode) the money moves to.

accountNumber?string

Account number to associate with the payment. Up to 13 characters.

Lengthlength <= 13

amount*number

Amount in Kenyan shillings.

remarks?string

Additional information carried with the transaction. Up to 100 characters.

Lengthlength <= 100

occasion?string

Purpose of the transaction. Up to 100 characters.

Lengthlength <= 100

callbackUrl*string

A publicly reachable endpoint accepting POST, where the result 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/till" \  -H "Content-Type: application/json" \  -d '{    "businessNumber": "12345",    "accountNumber": "435567676",    "amount": 100,    "remarks": "Here are the remarks",    "occasion": "Here is the occasion",    "callbackUrl": "https://kiotapay.co.ke",    "referenceId": "1234"  }'

{  "status": 201,  "message": "Success",  "data": {    "requestId": "89720296-239a-4391-9ecd-c4ca4d2eded0",    "accountNumber": "435567676",    "businessNumber": "12345",    "amount": 100,    "status": "PENDING"  }}

Pay a till

Authorization

Request Body

Response Body

201application/json

400application/json

401application/json

Callbacks

transactionResultPOST{$request.body#/callbackUrl}

`application/json`

`application/json`

`application/json`