Docs
Jusa API docs
Sell airtime, data and ZESA tokens from your till or app, and reward people, from one API.
Base URL https://jusa.localhost.co.zw/dev/v1. A test key (jusa_sk_test_…) reaches your sandbox and never
moves real money; a live key (jusa_sk_live_…) does. Version 2026-10-01.
Start
POS, tills and apps
Sell airtime, data and ZESAA sale from check to cash drawer, and what the cashier does in every state.10 minutes
Rewards quickstartReward a survey response in test mode, then go live.Sandbox
Test modeMagic numbers and meters for every outcome.Tools
SDKs and toolsEight SDKs (Java covers Kotlin) from our own registries, the CLI, Postman, OpenAPI and MCP.Agents
AI agents and MCPThe Agent Skill, llms.txt for any model, and the MCP server with a person in the loop.Concepts
Keys and authenticationsk, rk, pk and ak keys; scopes; caps; rolling a key.
ErrorsThe envelope, every code and every failure_code.
IdempotencyRetry anything without paying twice.
WebhooksSignatures, retries and the event catalogue.
Settlement and moneyWhat happens to a send and its money, state by state.
Dealer accountsFace value by default; a verified business buys below face and funds by cash collection.
Build
RecipesEvery use case, with the calls it takes.
Survey tools
KoboToolboxREST Services post each submission to a small relay that rewards it.Survey tools
SurveyCTOA form webhook posts each submission to a relay that rewards it.Survey tools
Google FormsAn Apps Script trigger rewards each response, no server of your own.Survey tools
TypeformA signed Typeform webhook, checked, then rewarded.Reference
API referenceEvery endpoint, its scope and its fields.
OpenAPI 3.1The document everything here is built from.
Postman collectionEvery request, with an Idempotency-Key where it needs one.
ChangelogWhat changed, by version.
llms.txtThese docs for a language model: an index, and
/llms-full.txt with every page.