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 Test Codes: You can request for a free code on your account. Free codes have a subcode greater than 100,000.
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 A Test Code

  • To test with a test code, you're required to request for a test code from your Unity account.
  • This code has to be in the range of 100,000. Eg. a sub-code should be in the range of *714*100788#. Your request would have to be approved by any of Hubtel's Support for it to be active.
    Once the code is active you can host and map your USSD application and test your applications accordingly.

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?