Send money to a bank account

Transfer funds from your Kiotapay wallet to a Kenyan bank account over Pesalink.

Bank codes

bankCode uses the format 00 + the bank's code — so a bank whose code is X3 is sent as 00X3. Codes are published in the KBA bank and branch list.

Double-check beneficiaryName against the account: a mismatch is the most common cause of a rejected transfer.

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.

bankCode*string

Bank code of the receiving account, in the format 00 + bank code — so bank code X3 is sent as 00X3. Codes are published in the KBA bank and branch list.

beneficiaryName*string

Name on the receiving account.

creditAccountNumber*string

Account number that receives the funds.

amount*number

Amount in Kenyan shillings.

narration?string

Additional information about the transfer.

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/bank/payout/new" \  -H "Content-Type: application/json" \  -d '{    "bankCode": "00X3",    "beneficiaryName": "Recipient User",    "creditAccountNumber": "01001735202370",    "amount": 1000,    "narration": "sendToAccount",    "callbackUrl": "https://merchant.example.com/api/webhooks/kiotapay",    "referenceId": "1234"  }'

{  "status": 201,  "message": "Success",  "data": {    "requestId": "8fa1fab3-a1d6-41fd-9199-d5517efc0d41",    "creditAccountNumber": "01001735202370",    "beneficiaryName": "Recipient User",    "amount": 1000,    "status": "PENDING"  }}

Send money to a bank account

Bank codes

Authorization

Request Body

Response Body

201application/json

400application/json

401application/json

Callbacks

transactionResultPOST{$request.body#/callbackUrl}

`application/json`

`application/json`

`application/json`