An important part of developing your application is testing to ensure that it works as expected.

Hubtel has provided a number of resources for Developers to test their USSD apps during development.

The following have been made available:

USSD Simulator: This is a mocker that simulates the interactions your application will typically with Hubtel.
Testing With Postman: Postman API client also presents a useful interface for testing the your USSD application. The Hubtel USSD API has a callback mechanism, hence you can use Postman to simulate the request and response interactions.

Testing With The USSD Mocker

You can easily test your application with our USSD mocker. It allows you to test your application from your localhost

  1. Just download the USSD mocker from Github and run either the ussd-mocker.bat   (for Windows) or ussd-mocker.sh   (for Linux).
  2. Navigate to http://localhost:8773   
  3. Provide your app details on the mocker home page.

NB: The mocker is in beta mode hence you may face issues using it. You can try the other testing options if this does not work for you.


Testing With Postman
You have to download and install the Postman Client app to be able to test with this approach.
If you're not familiar with Postman, you can learn more about it from these tutorials.
To initiate a USSD session, just POST the sample JSON below:


{
    "Mobile": "233541719387",
    "SessionId": "8883ba8b1e7348b8b566b4b3396575c2",
    "ServiceCode": "*737*300#",
    "Type": "Initiation",
    "Message": "1",
    "Operator": "mtn",
    "Sequence":1
}

To respond to a USSD session, POST the sample JSON below:

{
    "Mobile": "233541719387",
    "SessionId": "8883ba8b1e7348b8b566b4b3396575c2",
    "ServiceCode": "*737*300#",
    "Type": "Response",
    "Message": "1",
    "Operator": "mtn",
    "Sequence":2
}
Did this answer your question?