Bank Payouts

Get a single bank payout

GET
/api/sandbox/v1/bank/payout/single

Fetch one bank payout by its requestId.

Note this endpoint returns data as an array containing a single payout, not a bare object.

Authorization

bearerAuth
AuthorizationBearer <token>

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

In: header

Query Parameters

requestId*string

The unique ID of the transaction, returned when it was created.

Formatuuid

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/api/sandbox/v1/bank/payout/single?requestId=cd3e5b37-8f23-465e-a720-b2a78f2b62c1"
{  "status": 200,  "message": "SUCCESS",  "data": [    {      "uuid": "98b66546-0a83-4209-b037-adf5fb78d5ca",      "organisation": {        "id": 2,        "uuid": "4d6e1ea9-5ab8-496a-978f-7e9b2bce80c4",        "name": "Maina Properties Limited Ke",        "phoneNumber": "254745362174",        "email": "maina@gmail.com",        "uniqueReference": "4780606",        "createdAt": "2025-01-24T13:35:12.151225",        "updatedAt": "2025-01-24T13:35:12.151225"      },      "channel": "PESALINK",      "amount": 10,      "kiotapay_amount": 0,      "transaction_fee": 0,      "transaction_amount": 0,      "bankCode": "1032",      "beneficiaryName": "Recipient User",      "creditAccount": "0550179520670",      "currency": "KES",      "direction": 0,      "narration": "sendToAccount",      "transactionReference": "20c4397b-4549-42f6-a1c1-5f91d32590ae",      "receiverPhoneNumber": "254728762287",      "requestId": null,      "status": "PENDING",      "statusCode": null,      "statusDesc": null,      "originalRequestID": null,      "endToEndID": null,      "callbackUrl": "https://merchant.example.com/api/webhooks/kiotapay",      "errorCode": null,      "errorDesc": null,      "createdAt": "2025-04-15T18:48:41.228574",      "updatedAt": "2025-04-15T18:48:41.228574"    }  ]}