USSD on *388# · MTN · Airtel · Zamtel

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

Reach every phone in Zambia — no app, no smartphone required. Developers start with a free 5-day proof-of-concept — 120 sessions included, shortcode issued instantly, no approval wait — then extend from K350/week or K1,200/month (excl. VAT). 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, end to end. Create an account and verify your email — your shortcode is issued instantly, free, with a 5-day proof-of-concept and 120 sessions included. Point it at your HTTPS endpoint: we POST JSON, you reply JSON.

POST /your/ussd  →  { "session_id": "...", "user_input": "1" }
reply 200       →  { "response_string": "Welcome",
                     "continue_session": true }
  • Simple JSON API & live sandbox
  • Test console & full docs
  • Works across MTN, Airtel & Zamtel
  • No payment or approval to start — live the same day

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 — self-service developers are live the same day.

1
Onboard

Sign Up & Activate

Register and verify your email — that is all. Your API keys and a live *388*N# shortcode are issued automatically with a free 5-day POC, no payment and no approval queue.

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.

The Platform

Everything You Need, In One Portal

Traffic across all three operators, a browser simulator that dials your real shortcode, and reliability figures you can hold us to.

ussd.ontech.co.zm/dev
Developer dashboard showing 30-day sessions, requests and unique users, with traffic split across Airtel, MTN and Zamtel and a daily usage chart.

Traffic at a glance

Sessions, requests, unique callers and errors — broken down per operator, updated as calls land.

ussd.ontech.co.zm/dev/sandbox
USSD sandbox with an on-screen handset showing a live menu, alongside controls for shortcode, operator, caller number and test mode.

Test without a SIM

Dial your own menu from the browser — straight to your callback, or through the live gateway. Never counts against your trial.

ussd.ontech.co.zm/dev/sla
Reliability view showing overall success rate, request volume, P95 and P50/P99 latency, plus per-operator success rates for Airtel, MTN and Zamtel.

Reliability you can check yourself

Success rate and P95 latency per operator and per shortcode — the same numbers our SLA is measured against.

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

{
  "session_id": "17822920860361322",
  "msisdn": "260970000000",
  "user_input": "388*4",
  "is_new_request": true
}
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)
session_id — unique ID for the whole USSD dialog. Use it to correlate the steps of one session. You don't echo it back.
is_new_request"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 session_id. There are no status, state, or Freeflow (FC/FB) codes — the entire lifecycle is is_new_request 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:
    { "session_id": "S-7781", "user_input": "388*4", "is_new_request": true,
      "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:
    { "session_id": "S-7781", "user_input": "1", "is_new_request": false,
      "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.

Pricing

Transparent, Volume-Based Pricing

Start with a free proof-of-concept, extend week by week, and scale onto volume pricing when you're ready. No per-operator charges, no hidden setup costs.

Get started Free POC
K0 5 days · 120 sessions

Sign up, verify your email, and your *388*N# shortcode is issued instantly — free. Prove your concept with 120 real sessions over 5 days, then extend week by week, paid by mobile money.

Plans — after your POC
3-digit — e.g. *388*101# K350/wk up to 1,000 sessions
2-digit — e.g. *388*55# K500/wk up to 1,700 sessions
3-digit — monthly K1,200/mo up to 10,000 sessions
2-digit — monthly K1,800/mo up to 10,000 sessions
All prices exclude VAT. Sessions do not roll over — each cycle starts fresh. Only 80 two-digit extensions exist.
  • Live *388*N# shortcode
  • API key & secret
  • All three operators
  • Sandbox & simulator
Then pay per session
Usage
K0.138 per session

Entry rate. At the highest volumes your effective rate falls to about K0.0007 per session. Bands are progressive — each rate applies only to the sessions inside its band, so your bill never jumps at a threshold.

  • Prepaid or postpaid
  • Top up by mobile money
  • Monthly invoicing available
  • Live usage dashboard
To stay active — volume plans
10,000 sessions / month
3-digit code — minimum K1,200/mo
2-digit code — minimum K1,800/mo

A shortcode occupies limited national numbering whether or not it carries traffic, so inactive codes are not free to hold — and two-digit codes are the scarcest of all, which is why their minimum is higher. This applies once you move onto per-session volume billing — not to the free POC, and not to weekly or monthly plans.

Each minimum is exactly 10,000 sessions at that code’s rate — K0.12 for a 3-digit code, K0.18 for a 2-digit — so there is no cliff. You simply pay whichever is greater, your usage or the minimum. All prices exclude VAT.

Volume bands

Monthly sessions across all your shortcodes. Rates shown are per session within each band.

Monthly sessions Rate in band Total at band ceiling
First 50,000K0.138K6,900
Next 50,000K0.092K11,500
Next 400,000K0.0115K16,100
Up to 2 millionfrom K0.0115K34,500
Up to 10 millionfrom K0.0023K57,500
Above 10 millionK0.0029 down to K0.0001Talk to us
Rates shown apply within each band, not to your whole volume — so your effective rate is the blend across every band you reach. All prices in Zambian Kwacha, exclusive of 16% VAT. Very high volumes are quoted individually — get in touch.
Get your shortcode

Need a dedicated shortcode, custom routing or an enterprise SLA? Book a demo.

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.
Self-service developers are live the same day: register and verify your email, and your shortcode is issued automatically with a free 5-day proof-of-concept and 120 sessions included — no payment or approval needed to start. Building and testing your menus in the simulator is usually the longest part. Organisations needing a dedicated shortcode or custom routing should book a demo.
No. USSD works on any GSM handset with no internet connection or app install — that's what makes it ideal for nationwide reach.
Usage is metered per session and billed on a volume band scale — the more sessions you run, the lower your effective rate. You can pay prepaid (buy a bundle of sessions up front, topped up by mobile money) or postpaid (invoiced monthly in arrears). See Pricing for the full breakdown.
Nothing. Every developer starts with a free 5-day proof-of-concept: verify your email and your *388*N# shortcode is issued instantly, with 120 sessions included across all three operators, plus API credentials and sandbox access — no payment, no approval wait. When the POC ends, extend by mobile money. Weekly: K350 for up to 1,000 sessions on a 3-digit code, K500 for up to 1,700 on a 2-digit code. Monthly: K1,200 or K1,800 for up to 10,000 sessions. All prices exclude VAT, and sessions don't roll over — each cycle starts fresh. See Pricing.
Yes. To keep a shortcode active you need at least 10,000 sessions a month, or a minimum monthly charge of K1,200 applies instead. Those are the same figure — 10,000 sessions at the entry rate of K0.12 is exactly K1,200 — so there is no jump at the threshold: you pay whichever is greater, your actual usage or the minimum. A shortcode ties up limited national numbering whether or not it carries traffic, which is why dormant codes are not free to hold.
Yes. Prepaid clients buy a bundle of sessions up front by mobile money and draw them down as traffic runs, with low-balance alerts by SMS before the balance is exhausted. Postpaid clients are invoiced monthly in arrears against the same volume bands. Prepaid suits new and seasonal services; postpaid suits steady, predictable traffic.
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.
More from Ontech

One team, a whole toolkit for Zambian business

Explore the other platforms built by Ontech Solutions.

Ready to Launch Your USSD Service?

Developers — sign up and your shortcode is live the same day, with a free 5-day POC and 120 sessions included. Organisations — book a demo and we'll get your *388# service live in days.