Try the API and the feedback widget before you pay a single shilling.
- 100 free tokens on your first API key
- Full access to every endpoint
- Publishable keys for the web widget
- Balance, usage, keys & topup endpoints — free
- Priority support
The real cost. Top up anytime and every paid request spends exactly one token.
- 1 token = 1 request = TZS 1
- Top up from TZS 1,000 to TZS 200,000
- Instant credit via M-Pesa, Airtel or Tigo
- Tokens refunded when a request fails
- No subscription. Never expires.
High-volume customers get higher rate limits and bulk rates.
- Raised daily request caps
- Bulk token discounts
- Dedicated support & SLA
- Contract & invoice billing
- Same 1 token pricing otherwise
# How billing works
TumaMaoni API uses prepaid tokens instead of a subscription — you only ever pay for the requests you actually make.
Create an API key
Sign up, open the developer portal and create a key. You get 100 free tokens immediately.
Make requests
Every paid request debits exactly 1 token (TZS 1). Failed requests are refunded automatically.
Top up when low
Buy from TZS 1,000 with mobile money. Payment confirmed, balance updates instantly.
# Token prices
One transparent price for every paid request. Management endpoints are always free.
| Item | Price | Notes |
|---|---|---|
| PAIDPaid API request | 1 token | Debited per request, refunded on 4xx/5xx failures |
| PAIDToken price | TZS 1 | 1 token = TZS 1 = 1 request means 1000 requests for TZS 1k |
| FREEFree grant | 100 tokens | Credited automatically when you create your first API key |
| FREEWallet & key management | Free | Balance, usage, keys and topup endpoints never cost tokens |
| FREEFeedback widget | 1 token per submission | Same 1-token cost as the API — counted when feedback is submitted |
Top up limits
| Item | Value |
|---|---|
| Topup packages | TZS 3,000 (3,000 tokens) and TZS 10,000 (10,000 tokens) |
| Payment methods | Pay online with card / mobile money on Selar; tokens are credited once an admin verifies your payment |
| Low balance alert | Email when your balance drops below 500 tokens |
Quick topup amounts
| Amount | Tokens | Requests |
|---|---|---|
| TZS 3,000 | 3,000 | 3,000 |
| TZS 10,000 | 10,000 | 10,000 |
4xx or 5xx status, the token is refunded to your wallet immediately — you never pay for errors.# Rate limits
Each API key has a daily request budget that resets at midnight (Tanzania time). Limits apply per key, not per account.
| Key type | Daily limit |
|---|---|
| Secret | 1,000 requests / day |
| Publishable | 100 requests / day |
Zero-token endpoints (keys, balance, usage, topup) count toward your daily cap too, but never cost tokens.
# FAQ
Do tokens expire?
No. Tokens you buy never expire, so you can top up whenever it suits you and use them at your own pace.
What happens when I run out of tokens?
Paid requests return a 402 Insufficient tokens error with a topup_url you can send your user to. Your app never has to hard-code the topup page.
Do I get a refund if a request fails?
Yes. Tokens are charged when a paid request begins and refunded automatically if it ends with a 4xx or 5xx status. Refunds appear in your token history.
Which payment methods are supported?
Pay online through Selar using your debit/credit card or mobile money. After you pay, an admin verifies the payment and credits the tokens to your wallet.
Is there a free plan?
Yes — creating your first API key grants 100 free tokens, and balance, usage, keys and topup endpoints are always free. You only pay per paid request you make.
Can I get a higher rate limit?
Yes. On the Scale plan we raise your daily request caps, offer bulk discounts and give you dedicated support. Just get in touch.
Start building today
Create your account, get 100 free tokens and make your first request in under two minutes. No credit card, no commitment.