Handle Requests

Learn about the payload structure Sendexa sends to your server.

INCOMING POST

application/json

Request Payload

When a user interacts with your USSD application, we send a POST request with the following JSON body.

JSON

{
  "sessionId": "ussd_sess_987654321",
  "phone": "233555539152",
  "network": "MTN",
  "serviceCode": "*123#",
  "type": "continue",
  "input": "1",
  "timestamp": "2024-01-15T10:30:05Z"
}

Field Definitions

Field	Description
sessionId	Unique ID for the current USSD session.
phone	The user's mobile number in international format.
type	`new`: User just dialed code. `continue`: User entered input.
input	The text or number the user entered (null for 'new').