Skip to content

Products

Agent float: one balance, every rail

For platforms serving mobile-money agents (wakalas). Each agent gets one nTZS float that pays any mobile wallet, any Lipa Namba on any network, and any biller, all from a single balance, with no per-network float placement and no counterparty to find. You set the retail price; your margin is configured on your account.

Access: requires the wakala capability and approved KYB. And read Limits below before planning a rollout: each float is capped as one sandbox participant.
What this is not: moving float between networks is already free and instant via TIPS, and we don't compete with that. The value is the transactions an agent turns away today (bills, bank transfers, any-network tills) out of one balance. Price for new revenue, not cheaper revenue.
Sandbox limitValue
Per transaction1,000,000 TZS
Per float, per day2,000,000 TZS
Per float, 30 days60,000,000 TZS
Participants total100
Each float counts as one participant. A second sub-wallet is another participant, not extra headroom. A busy agent turns over more than 2,000,000 a day, so these limits do not yet support production volume: phase one is a named pilot cohort, and that cohort's evidence is what supports raising them. Limit errors carry limit, requested and usedInPeriod so you can render “agent limit reached” properly.
1 · Provision a float per agent
POST /api/v1/partners/sub-wallets
{ "label": "Agent 042, Kariakoo" }
// → { id, address, label }   ← keep id against your agent record
2 · Disburse: pass subWalletId instead of userId
// Pay a bill (LUKU, GEPG, water, TV…)
POST /api/v1/spend/quote
{ "subWalletId": "…", "kind": "bill",
  "amountTzs": 20000, "utilityCode": "LUKU", "utilityRef": "01234567890" }
POST /api/v1/spend        { …same…, "quoteId": "…" }

// Pay a merchant till on any network
POST /api/v1/spend/quote  { "subWalletId": "…", "kind": "lipa",
                            "amountTzs": 5000, "payNumber": "61115582" }

// Pay out to a customer's mobile wallet
POST /api/v1/withdrawals/quote
{ "subWalletId": "…", "amountTzs": 50000, "phoneNumber": "0744277496" }

// Everything else is identical to the user-funded flow: same quotes,
// same fees, same errors. Quotes bind to the float they were priced for,
// and failures revert to the float, never to a user wallet.