USSD
- User dials USSD code
- Mobile Operator forwards request to Bonga
- Bonga forwards the request via GET to client
- Client processes request responds in plain text
- Bonga forwards request to mobile operator
- User receives menu response
Processing USSD requests
METHOD – GET URL – Provided by the client The Bonga USSD application will make a GET request to the client’s exposed URL with the parameters listed When the user dials the code and whenever they respond to a menu flow.
| Parameter | Description | Type |
|---|---|---|
| mobile_number | Phone Number | string |
| session_id | Session Identifier | string |
| message | User Input | string |
| service_code | USSD Code | string |
| network | Mobile Network Operator of phone number | string |
- message – This will be empty when the user first dials the USSD code, subsequent user input within the session will be concatenated delimited with an asterisk ( * ).
Client Application Responses
USSD being a session based technology, when a user dials the USSD Code or responds to a menu the provided url will receive a call with the above parameters.
Respond beginning with :
CON - If the USSD session is ongoing e.g.s CON Welcome to our service
END - If you want to end the USSD session e.g END Your request has been received