USSD Code Simulator

Test and preview USSD menu flows for mobile money, banking, and telecom services. Build custom flows or explore preset African service codes.

Live PreviewCustom FlowsAfrican Services
Preset USSD Services
Custom Flow Editor (JSON)

Understanding USSD in Africa

USSD (Unstructured Supplementary Service Data) is the backbone of digital financial services across Africa. Unlike smartphone apps that require internet connectivity and modern devices, USSD works on any GSM phone — including basic feature phones that cost as little as $10. This universality has made USSD the primary interface for mobile money services like M-Pesa, bank transfers, airtime purchases, and government services across the continent.

Africa has over 600 million mobile money accounts, with the majority accessed via USSD menus. Kenya's M-Pesa (*182#) processes over $50 billion annually through USSD. Nigeria's bank USSD codes (*737# for GTBank, *901# for Access Bank, *894# for First Bank) have become the primary banking interface for millions who never visit a branch. Ghana's *170# unified mobile money code serves MTN MoMo, Vodafone Cash, and AirtelTigo Money. South African banks offer comprehensive USSD banking — you can transfer money, buy airtime, pay bills, and check balances all without internet.

For developers building USSD services, testing flows is essential. A USSD session is essentially a state machine: the user dials a short code, receives a menu, responds with a number, and navigates through nested menus until they reach a terminal action. Sessions timeout after about 180 seconds, and the entire interaction must be text-based within the 182-character limit per screen. This simulator helps developers design, test, and preview USSD flows before deploying them to production, ensuring a smooth user experience on any phone.

USSD services in Africa are increasingly being supplemented by WhatsApp bots and app-based interfaces, but USSD remains critical for financial inclusion — reaching the ~60% of African mobile users who don't have regular internet access. Understanding USSD design principles (short menus, clear options, minimal steps to completion) is essential for any developer building for African markets.

Frequently Asked Questions

Do USSD codes work without internet?

Yes! USSD operates over the GSM signaling channel, separate from data networks. It works on any phone (even basic feature phones) without internet, WiFi, or data bundles. This is why it's the preferred channel for financial services in Africa where internet penetration is limited.

How do I build a USSD service?

You need: (1) A short code from your telecom provider. (2) A USSD gateway (Africa's Talking, Hubtel, or your MNO's API). (3) A server application that receives requests and returns menu responses. Popular frameworks include Python/Flask, Node.js, and PHP. The flow is: User dials code → Telco sends request to your server → You return menu text → User responds → Repeat until terminal screen.