
The API-first, wallet-native, compliance-audited insurance referral platform for Uganda's licensed agents. Onboard against the 2,594-agent IRA registry, credit net commissions in one atomic wallet transaction, and let ZFA admins reconfigure fees, tax and investment rates from the same authenticated surface.
One API surface: agent onboarding, referral pipeline, commission calculation, wallet ledger, investments, claims, disputes, regulator reporting, and everything that has to be audit-safe under Ugandan financial regulation.
251 hardcoded system permissions; every one of the 380 endpoints is gated. A build-time lint blocks unguarded routes.
Agents' approved commissions credit an on-platform wallet β net of ZFA-configurable fees, tax and levies. Fixed-term + call investments compound daily.
ZFA admins publish fees, WHT, membership and levies via the API. Each rule has scope, targeting and versioning; the engine applies them in priority order.
End-to-end policy lifecycle with pro-rata cancellation, endorsements, 9-state claim workflow and 60/30/7-day renewal sweeps.
Hash-chained audit trail with a daily verifier, DSAR export/erase, SIEM push, regulator record-request workflow, sanctions/PEP screening.
Every currently-licensed insurance agent from the IRA of Uganda's 30 June 2026 register is available for fast-track account creation.
Every endpoint takes the same shape: authenticate, present the right permission, get a RESTful JSON response. Full flow below.
POST /api/v1/auth/login with your seeded admin credentials β returns access + refresh tokens.
POST /api/v1/agents/register β the platform pre-fills licence data from the IRA register on the entered IRA number.
POST /api/v1/referrals β a commission row is auto-created; approving it credits the agent's wallet net of active deductions.
Every state change writes a hash-chained audit event. A nightly verifier walks the chain and pages on tamper. Every write is under a permission the security lint enforces at build time.
Every audit_event carries previousHash, currentHash, andchainSeq. Verifier runs daily at 01:00 UTC.
A mismatched hash writes audit.chain.verify.tamper_detected and pages compliance. Runbook lives at /runbooks/incident.
HMAC-signed cursor-based push to your SIEM. GDPR-adjacent DSAR export + right-to-erase endpoints ready for regulator requests.