TukuPay Docs

Your account

Balances and wallets

Every wallet on the account, its balance and what is available to spend.

GET/v1/balancesSigned · read

SeeSigning requestsKeys and scopesErrors

const { wallets } = await tukupay.balances();

available is the balance less what is set aside (for example payouts waiting for approval). Use wallet_id wherever an endpoint asks for a wallet.

GET/v1/walletsSigned · read

SeeSigning requestsKeys and scopesErrors

GET/v1/wallets/{walletId}Signed · read

SeeSigning requestsKeys and scopesErrors

{
  "id": 7,
  "name": "Main Wallet",
  "alias": "TKW12345",
  "provider": "sasapay",
  "account_number": "…",
  "is_primary": true,
  "is_active": true,
  "currency": "KES",
  "balance": "12500.00",
  "available": "12000.00",
  "created_at": "2026-10-01T08:00:00.000Z"
}

GET /wallets answers a list of these. A wallet that is not on the account is 404 wallet_not_found.

POST/v1/walletsSigned · wallets

SeeSigning requestsKeys and scopesErrors

Opens another wallet on the account, within the wallet provider's limits: name, purpose, nature_of_business, physical_address. In the sandbox nothing is opened and the answer is { simulated: true, id: null, … }.