Voici comment intégrer le paiement par mobile money dans votre application
Si vous lisez cet article , vous savez qu’il est difficile d’obternir les Api mobile money au près de maisons de télécommunication, dans cet article je vous présente une alternative, Hover, un SDK qui permet d’automatiser n’importe quel processus USSD en arrière plan d’une application Android, le mobile money étant accessible par USSD, Hover s’avère une très bonne alternative aux Api mobile money fournis difficilement par les maisons de télécommunication et il ne vous prend que 30 minutes pour l’intégrer dans votre application.
Assez parler, développons une application qui envoie de l’argent à un numéro par Airtel Money.
N.B: Une connaissance en développement d’applications Android est nécessaire pour compléter ce tutoriel.
1. Enregistrement de l’application
Pour commencer, enregistrez votre application sur Hover. C’est enregistrement n’est pas aussi long que l’on pourrait le penser. Il se fait seulement en quelques étapes: créer un nouveau projet dans Android Studio en suite revenir sur usehover.com pour créer un compte si vous n’en avez pas encore.
Une fois connecté sur votre compte hover, ajoutez votre nouvelle application en cliquant sur “New app” , completez le nom de votre application et le package de votre application comme il apparait dans le fichier AndroidManifest.xml; Cliquez sur “Save App”, un token vous sera généré , copiez le quelque part car vous en aurez besoin un peut plus tard.
2. Créer une action.
En hover, une action répresente les étapes à suivre pour naviguer les menus USSD d’un opérateur de téléphonie mobile ou d’une banque. Dans notre cas ici une action c’est comment nous configurons le sdk Hover pour naviguer le menu USSD du processus de l’envoi de l’argent par Airtel Money Congo sur le telephone de l’utilisateur.
Comme vous pouvez le constater dans l’image ci-haut, une action est composée de différentes étapes, une étape peut consister d’un nombre pour des choix constants tels que la saisie de «1» pour accéder à Mon compte USD, une étape peut aussi être une variable pour les entrées qui changent au moment de l’exécution, telles que le montant à envoyer ; une étape peut aussi consister de PIN ici c’est quand on demande à l’utilisateur d’entrer son mot de passe. Quand une action contient une étape PIN l’utilisateur est invité à saisir son mot de passe lors de l’execution de l’action sur son telephone. Le mot de passe est crypté à l’aide du système Android Keystore, uniquement stocké pendant la durée de la session USSD et ne quitte jamais l’appareil de l’utilisateur.
Pour ajouter une action, sur votre compte à partir du menu actions, cliquez sur “new Action” et donnez un nom à votre action. Appelez votre action “Envoi argent” pour cet exemple, Selectionnez le pays et le reseau de telecommunication , puis entrez le root code, le root code c’est le code qu’on compose pour initier une session USSD. Par exemple pour effectuer une transaction sur airtel money Congo on commence toujour par composer *501#.
Une fois l’action definie avec toutes les étapes Clique sur “save” pour enregistrer votre action , un identifiant vous sera généré ,vous en aurez besoin lors de l’intégration du Sdk hover.
3. Ajouter Hover dans le projet.
Maintenant retour dans android studio pour finaliser notre project. Ajoutez Hover dans build.gradle niveau racine(root) comme ceci
allprojects {
repositories { mavenCentral()
maven { url "http://maven.usehover.com/releases" }
}
}
Dans votre build.gradle niveau projet (app-level) ajoutez le dependecy hover comme ceci
dependencies {
implementation 'com.hover:android-sdk:1.5.1'
}Dans votre fichier AndroidManifest.xml, remplacez “VOTRE API TOKEN” par le token généré lors de l’enregistrement de votre application sur hover
<application>
<meta-data
android:name="com.hover.ApiKey"
android:value="VOTRE API TOKEN"/>
</application>Enfin, initialisez hover dans votre MainActivity en appelant Hover.initialize() dans methode oncreate. il faut l’appeler seulement une fois dans votre application et en une seule place, ne pas le faire dans votre classe Application.
4. Execution de l’action
Finalement l’exécution de la session USSD dans votre application. Sur le onClickListner de votre bouton qui va déclencher le processus d’envoi d’argent , ajoutez le code chargé d’exécuter le processus d’envoi en mettant l’identifiant de votre action avec les valeurs de toutes le variable definie lors de la création de votre action, comme dans le code suivant
Maintenant, compilez et exécutez votre application. Lorsque le click de votre buton est déclenché, vous serez invité à fournir plusieurs autorisations d’exécution requises par Hover, qui sur la plupart des appareils ne doivent être effectuées qu’une fois par installation. Si tout se passe bien, vous serez invité à entrer votre code PIN, en suite vous verrez une bare de progression pendant que Hover exécute la session USSD en arrière-plan, à la fin de l’execution vous recevrez un message de confirmation.
Le code source de l’application est disponible ici
Nous avons démontré comment envoyer de l’argent par Airtel Money dircetement dans une application Android, mais cette approche peut être utilisée pour automatiser n’importe quel action USSD de n’importe quel opérateur mobile au quel vous pouvez penser.
N’hestitez pas à télecharger Eskke, une application qui reduit plus de 6 étapes que vous devez parcourir pour efffectuer vos transaction mobile money en un clique.
Très grand Merci 👏 👏 à nicole musimbi et eugene maliro pour la relecture.
