USSD on *388# · MTN · Airtel · Zamtel

Launch a *388# USSD service — live in days.

Reach every phone in Zambia — no app, no smartphone required. Developers integrate with a simple JSON API and a live sandbox. Organisations go live across all three operators through one gateway, with billing and analytics built in.

View the API docs
Trusted across Airtel MTN Zamtel

For Developers

Self-serve. Create an account, get keys, and point a *388*N# shortcode at your HTTPS endpoint. We POST JSON, you reply JSON.

POST /your/ussd  →  { "sessionID": "...", "input": "1" }
reply 200       →  { "response_string": "Welcome",
                     "continue_session": true }
  • Simple JSON API & live sandbox
  • Test console & full docs
  • Works across MTN, Airtel & Zamtel

For Organisations

We handle it for you. Reach every customer on any handset — banks, government, utilities, NGOs — no app and no smartphone needed. Live in days.

  • One gateway, all three operators
  • Routing, billing & analytics included
  • Dedicated onboarding & support

Trusted by leading organizations across Zambia

Airtel MTN NAPSA Natsave Investrust Madison Life Izwe

Everything You Need

Powerful tools to manage, monitor, and optimize your USSD gateway services from a single dashboard.

Real-time Dashboard

Monitor active sessions, response times, and service health with live updates and visual indicators.

Advanced Analytics

Deep insights with daily, weekly, and monthly reports. Export data in CSV or JSON for further analysis.

Route Configuration

Manage shortcode routes, callback URLs, and service endpoints with an intuitive configuration panel.

USSD Simulator

Test USSD journeys across Airtel, MTN, and Zamtel without needing a physical handset.

Transaction Logs

Search, filter, and export transaction logs with real-time streaming and advanced filtering.

Service Health

Automated health checks with alerts for service degradation, timeouts, and endpoint failures.

Industries

One Gateway for Every Sector

From mobile money to citizen services, organizations across Zambia reach every handset — smartphone or not — through *388#.

Banking & Fintech

Balance checks, transfers, and mini-statements over secure USSD sessions — no app or data bundle required.

Telecom & MNOs

Self-service menus for airtime, bundles, and subscriptions across Airtel, MTN, and Zamtel.

Insurance

Micro-insurance enrollment, premium payments, and claims status accessible from any phone.

Agriculture

Market prices, input ordering, and advisory services delivered to farmers in rural areas.

Government

Citizen registration, service requests, and notifications reaching every constituent.

Healthcare

Appointment booking, health tips, and survey collection through simple menu flows.

Platform

Everything to Run USSD at Scale

A complete toolkit — from session routing to billing — in one management console.

Session Routing

Smart shortcode routing with failover across all operators.

Menu Builder

Design multi-level USSD journeys without writing code.

Analytics

Live dashboards for sessions, funnels, and drop-off.

Billing & Rates

Per-session billing, client rates, and invoicing built in.

Simulator

Test full journeys per network without a handset.

Transaction Logs

Searchable, exportable logs with real-time streaming.

Webhooks & API

Connect your services with REST callbacks and keys.

Developer Portal

Self-service onboarding, API keys, and shortcodes.

How It Works

Live in Three Phases

From registration to production traffic — most integrations go live in days, not months.

1
Onboard

Register & Get Keys

Sign up on the developer portal, get your API keys, and request a shortcode under *388#.

2
Build

Design Your Menus

Build and test your USSD flows in the simulator, then wire up callbacks to your services.

3
Launch

Go Live & Monitor

Switch to production across all MNOs and watch real-time analytics, logs, and SLA health.

Developers

USSD Integration — JSON API

Point your *388*N# service at any HTTPS endpoint. For every keypress the OnTech gateway POSTs JSON to your URL, and you reply with JSON. That is the entire contract.

Request — what OnTech POSTs to you
POST https://your-service/ussd
Content-Type: application/json

{
  "sessionID": "17822920860361322",
  "msisdn": "260970000000",
  "input": "388*4",
  "isnewrequest": "1"
}
Response — what you must return
HTTP 200
Content-Type: application/json

{
  "response_string": "Welcome to My Service\n1. Check balance\n2. Buy bundle",
  "continue_session": true
}
Request fields (what OnTech sends you)
sessionID — unique ID for the whole USSD dialog. Use it to correlate the steps of one session. You don't echo it back.
isnewrequest"1" on the first request of a session, "0" on every request after. Sent as a string.
input — what the subscriber entered (the dialed code on the first hit, e.g. 388*4; their keypress thereafter).
msisdn — the subscriber's phone number. These four fields are the entire request — there is no mno, shortcode, request_id or session_data.
Response fields (your reply)
response_string — the exact text shown on the subscriber's handset. Required.
continue_sessiontrue keeps the session open for the next input (a menu); false shows a final message and ends the session. Required.
Session model: a dialog is keyed by sessionID. There are no status, state, or Freeflow (FC/FB) codes — the entire lifecycle is isnewrequest coming in and the boolean continue_session going out. Send continue_session: false to end the session.
Return both response fields. Success is HTTP 200 with JSON. Plain-text protocols such as Africa's Talking CON/END are not accepted — a non-JSON body or a missing field results in “Service response error” for the caller.
Example — a two-screen session
Subscriber dials *388*4#, picks option 1, session ends
SCREEN 1  —  subscriber dials *388*4#
  → OnTech POSTs:
    { "sessionID": "S-7781", "input": "388*4", "isnewrequest": "1",
      "msisdn": "260970000000" }
  ← you return:
    { "response_string": "Welcome to ACME\n1. Check balance\n2. Buy bundle",
      "continue_session": true }            // menu stays open

SCREEN 2  —  subscriber presses 1
  → OnTech POSTs:
    { "sessionID": "S-7781", "input": "1", "isnewrequest": "0",
      "msisdn": "260970000000" }
  ← you return:
    { "response_string": "Your balance is K12.50.\nThank you for using ACME.",
      "continue_session": false }           // final screen, session ends
3
MNOs Supported
99.9%
Platform Uptime
388
Primary Shortcode
24/7
Monitoring
Security

Enterprise-Grade by Default

Your sessions, transactions, and subscriber data are protected at every layer of the gateway.

Token-Based Access

Short-lived JWTs with automatic refresh and role-based access control across every console.

Encrypted in Transit

All traffic between operators, the gateway, and your services is served strictly over TLS.

Full Audit Trail

Every session and admin action is logged, searchable, and exportable for compliance.

GDPR Tooling

Built-in data-subject request handling and retention controls for subscriber privacy.

SLA Monitoring

Continuous health checks with alerting on latency, timeouts, and endpoint failures.

Anomaly Detection

Automated flagging of unusual traffic patterns to catch abuse and fraud early.

Shortcodes

Your Shortcode, Your Way

Already own a code, want your own, or want to launch today under *388# — Ontech supports all three, across Airtel, MTN and Zamtel.

Bring your own shortcode

Already have a dedicated USSD shortcode? Ontech connects it to the gateway and routes it to your service across every network — you keep full ownership of the code.

We help you acquire one

Want your own dedicated *XYZ# code? Ontech guides you through acquisition and provisioning with the regulator (ZICTA) and the mobile operators, and handles the technical setup end to end.

Launch under *388#

Go live fast on a shortcode sub-string under Ontech's *388*N# space, with your own branded menus and submenus — no dedicated-code lead time or cost.

Enterprise SLA

Bank-Grade SLA & 24/7 Support

The service commitments regulated banks and mobile operators expect — guaranteed uptime, round-the-clock monitoring, and a defined escalation path with response times you can put in a contract.

99.9%
Uptime guaranteeMonthly, contractually backed
24/7/365
Monitoring & supportLive NOC, every day of the year
15 min
Critical responseSeverity-1 acknowledgement
In-country
Hosted in ZambiaData residency & local support
SeverityDefinitionResponseResolution targetCoverage
Sev-1 CriticalService down or payments failing across a network15 minutes4 hours24×7×365
Sev-2 HighMajor function degraded; a single MNO or shortcode affected30 minutes8 business hours24×7×365
Sev-3 MediumMinor or partial impact with a workaround available4 business hours2 business daysBusiness hours
Sev-4 LowQuestion, configuration change, or enhancement request1 business dayScheduledBusiness hours

Business hours 08:00–17:00 CAT, Mon–Fri. Severity-1 and -2 incidents are covered around the clock. Response and resolution targets, service credits, and dedicated staffing are formalised in your enterprise agreement.

24/7 NOC & proactive monitoring

Our Network Operations Centre watches every session, latency reading and endpoint around the clock, with automated alerting and failover across Airtel, MTN and Zamtel before you notice.

Dedicated account & technical manager

Enterprise customers get a named account manager and technical contact, quarterly service reviews, and a direct escalation line — not a shared ticket queue.

Priority incident hotline

A 24-hour incident hotline and dedicated support inbox for Severity-1/2 events, backed by a documented escalation matrix through engineering to management.

Contractual SLAs & service credits

Uptime, response and resolution commitments written into a signed SLA, with service credits when a target is missed — the accountability regulated institutions require.

Business continuity & DR

Redundant infrastructure, encrypted backups and tested disaster-recovery procedures keep your *388# service available through incidents and maintenance windows.

Compliance-ready reporting

Full audit trails, uptime and performance reports, and data-retention controls — delivered on the cadence your auditors and regulators expect.

Need the SLA in writing for procurement? Talk to enterprise support info@ontech.co.zm +260 211 448 275
FAQ

Frequently Asked Questions

The gateway routes USSD sessions across all three Zambian MNOs — Airtel, MTN, and Zamtel — under the shared *388# shortcode space, with automatic failover.
Most teams go live within days. Register on the developer portal, build your menus in the simulator, connect your callback URL, and request production access.
No. USSD works on any GSM handset with no internet connection or app install — that's what makes it ideal for nationwide reach.
The platform meters usage per session and supports configurable client rates, credits, and automated invoicing from the billing console.
Enterprise customers get a bank-grade, contractually backed SLA: a 99.9% monthly uptime guarantee, 24/7/365 NOC monitoring, and a severity-based response matrix (Sev-1 acknowledged within 15 minutes, round the clock) with service credits if targets are missed. You also get a named account manager, a priority incident hotline, and a documented escalation path. See the SLA & Support section, or email info@ontech.co.zm for the full agreement.
Yes. The built-in simulator and sandbox let you walk through complete USSD journeys per network without a physical handset or production traffic.
The console gives you self-service dashboards for traffic, success rates, latency and uptime, per-session transaction logs that are searchable and exportable, and billing/usage reports. The same data is available programmatically through the API, so you can pull stats into your own BI or client dashboards.
Yes. USSD menus are just the text your service returns, so you can present menus in English or any local language — and switch language dynamically per session based on the subscriber's choice or profile.
Standard GSM USSD applies: roughly 160 characters per screen, and each session is a short, menu-driven exchange that stays open only while the subscriber is interacting. The gateway keeps continue_session true to advance menus and false to end — so deep flows are built as a sequence of concise screens rather than one long page.
Enterprise customers get a defined escalation path, not a single inbox: L1 support desk (email + priority hotline) → L2 platform engineering → your named account managermanagement for Severity-1 events. Sev-1 and Sev-2 incidents are covered 24/7. Reach the team at info@ontech.co.zm or +260 211 448 275.

Ready to Launch Your USSD Service?

Developers can start building for free right now. Organisations — book a demo and we'll get your *388# service live in days.