USSD Gateway Formats
The USSD Simulator supports all major telecom aggregator webhook protocols across Africa and international gateways.
The USSD Simulator supports all major telecom aggregator webhook protocols across Africa and international gateways.
Simple JSON format with sessionId, input, and continueSession boolean flag.
POST /ussd
Content-Type: application/json
{
"sessionId": "10000000000001",
"phoneNumber": "233244123456",
"input": "*920#",
"newSession": true
}
JSON structure with sessionID, userData, and continueSession boolean flag.
POST /ussd
Content-Type: application/json
{
"sessionID": "10000000000001",
"userID": "test_user_1",
"newSession": true,
"msisdn": "233244123456",
"userData": "*920#",
"network": "MTN"
}
Standard URL-encoded form parameters with cumulative text strings and CON / END plain text responses.
POST /ussd
Content-Type: application/x-www-form-urlencoded
sessionId=10000000000001&phoneNumber=233244123456&serviceCode=*920#&text=1
JSON payload with uppercase parameters and MSGTYPE continuation boolean.
POST /ussd
Content-Type: application/json
{
"SESSIONID": "10000000000001",
"USERID": "test_user_1",
"MSGTYPE": true,
"MSISDN": "233244123456",
"USERDATA": "*920#",
"NETWORK": "MTN"
}