fbpx

Discover our new campaign management platform. Learn more

section-9134a21

API-USSD

section-1
1 Scope

LAM USSD est une solution pour intégrer son système d’information au numéro court #2121# of LAfricaMobile.
This document describes and explains how to use this API.

section-2
2 Account settings
2.1 Prerequisites

To use this API, you need a valid account.
When creating you account Lafricamobile will give you :
- A login ( also named accountid)
- A password
This identifier / password pair is used as a parameter in the API.
The customer will have to provide an url which will allow LAfricaMobile to integrate the menu of these different operations

2.2 Variables used in the documentation

In this document, we use values below. The true values will be given by our technical team or by your own configuration.
Some of them may not be used according to your needs.
Document test values :
- login=fred
- password=xpasswordx
- URL LAFRICAMOBILE = https://ussd.lafricamobile.com:3443/session
- URLPARTENAIRE = https://votre-entreprise.com/index.php
You have to replace these values by your own means during your tests.

section-3
3 Menu
3.1 Example

section-4
4 Use XML to display the menu

To display the menu you will need the file:
index.php which contains the php code that will generate the XML for the menu display

4.1 The index.php file

This file contains the php code that will generate the xml file.
Each tag <a> va être interprétée comme une option du menu et chaque balise va s’accompagner un fichier php exemple (Consultation solde -> solde.php).
The parameter $msisdn contains the user's phone number:

4.2 The XML generated by index.php file

4.3 Example: balance consultation
4.3.1 Balance consultation menu

4.3.2 Solde.php file

4.3.3 The XML generated by solde.php

4.3.4 updatesolde.php file

4.3.5 The XML generated by updatesolde.php

section-5
5 Sécurity : the 5 basic pillars

=> Data integrity

--Restriction of the number of identification tests to avoid brute force attacks

=> Responsibility of people

--Traceability of connections with archived logs

--Centralized and secure authentication

=> Privacy

--Authentication interface to access the platform with an ultra-secure password

=> Availability

Real-time and permanent monitoring of portal availability
with proven tools like NAGIOS

=> SSL/TLS

--Protection of data confidentiality

--Encryption of transactions on the platform