Get Payments Wallet Balance
Query your payments wallet balance
GET
https://upesipay.com/api/v2/payment_channels/{channel_id}
Headers
| Parameter | Type | Description |
|---|---|---|
| Authorization* | String | Basic auth token |
Query Parameters
| Parameter | Type | Description |
|---|---|---|
| channel_id* | Integer | Your wallet payment channel ID |
Responses
200 OK
{
"id": 16823,
"transaction_type": "CustomerBuyGoodsOnline",
"channel_type": "wallet",
"account_id": 5234,
"short_code": "553125",
"account_number": "5234",
"description": "SASAPAY WALLET",
"is_active": true,
"balance_plain": {
"last_balance": 4700,
"balance": 4700,
"last_reference": "cost_TBH2D54JQA"
},
"created_at": "2026-01-02T15:39:14.5238Z",
"updated_at": "2026-01-02T06:29:28.485494Z"
}Notes
You can withdraw funds held in your payments wallet to MPESA, Airtel Money, T-Kash, or Bank Accounts. Use the balance returned in this API to manage your wallet effectively and determine available funds for withdrawal.
Try It Out
Please set your authentication token in the sidebar to test this API.
URL Path Parameters
(Appended to the endpoint URL path)
Headers
Code Samples
curl -X GET \
'https://upesipay.com/api/v2/payment_channels/16823'