How It Works

Step 1: Configure Your Endpoint

Enter your USSD endpoint details:

• Host URL: The full URL of your USSD endpoint (e.g., https://api.example.com/ussd)
• Method: Choose between GET or POST request methods
• Network Operator: Select the telecom network (AT, Glo, MTN, or Telecel)
• Phone Number: Enter a valid 10-digit phone number starting with 0
• Aggregator: Choose your USSD aggregator (Korba, Nsano, Nalo, Arkesel, or Africa's Talking)

Step 2: Enter USSD Code

In the "Enter USSD Code" field, input your USSD code. Examples:

• *721# - Initial request
• 1 - Menu selection response
• 2 - Another menu selection

The USSD code field will automatically clear after each request, allowing you to quickly send the next input.

Step 3: Send Request & View Response

Click the Send button to submit your USSD request. The simulator will:

• Forward your request to your endpoint
• Display the response in the output panel
• Clear the USSD code field for the next input

The output panel shows the raw response from your endpoint, helping you debug issues in real-time.

Step 4: Reset & Start Over

Use the Reset button to clear the session and start a fresh USSD flow. This will:

• Clear all input fields
• End the current USSD session
• Redirect you back to the simulator home

💡 Tips & Best Practices

• Ensure your endpoint is publicly accessible (or use ngrok for local testing)
• Test with different networks and aggregators to ensure compatibility
• Use meaningful phone numbers for testing (ensure they're valid 10-digit numbers)
• Monitor your endpoint logs to see the exact requests being sent
• Test both successful and error scenarios
• Remember that each Send request increments the session sequence number