Core Business APIs


POST /api/UssdAccountOpening/Review
Connection: Keep-Alive
Content-Length: 271
Content-Type: application/json; charset=utf-8
Accept: application/json
Expect: 100-continue
Host: ussd.flutterwave.com
ApiKey: 0BED8AADBD66101E891EEE16A1145197A550E2297809EEE570D839CBF574178D42E53BED34ABF765117E719F348094262EA5
ApiCode: FLUTTER

Post data:
{
	"mobile":"2348039590420",
	"status":"",
	"message":"",
	"data":[
		{"SKey":"FIRSTNAME","SVal":"John"},
		{"SKey":"LASTNAME","SVal":"Smith"},
		{"SKey":"GENDER","SVal":"1"},
		{"SKey":"DOB","SVal":"1980-10-26"},
		{"SKey":"REFCODE","SVal":"998"}],
	"session":"SESS1D9DLNDDQSJ2",
	"serviceCode":"*901#"
}

All posts come with the following fields

  • mobile: The customer's mobile phone number
  • status: null
  • message: null
  • data: a collection of SKey and SVal, which is the data collected from interaction with the customer
  • session: this is the unique string identifying the current USSD session
  • serviceCode: this is the USSD string the customer dialled.


For responses, send the same model back. With 00 as status for success and 99 for failed.

The message field should contain data that you want to display to the user.