Questions/Réponses
Dernière mise à jour le 27/07/2022 à 21:32
Afficher/Masquer tout
- Qu'est-ce que
MPay?
- MPay est un service de suivi en temps réel
des transferts d'argent que vous recevez via Mobicash et Orange Money au Burkina
Faso.
Vous pouvez également effectuer des transferts vers
des numéros parmi les contacts stockés sur votre smartphone.
Enfin vous pouvez, à distance, envoyer des SMS (campagne marketing par SMS,
identification d'un numéro de téléphone, authentification
à double facteur,...) ou faire exécuter à votre
smartphone des codes USSD (transfert d'argent, recharge d'unites ou de
connexion internet,...).
- A qui s'adresse
MPay?
- MPay s'adresse à tout détenteur
de porte-monnaie électronique.
En tant qu'individu, vous avez ainsi la possibilité d'effectuer des
transferts ou d'en télécharger des archives au format Microsoft
Excel (très utile pour tenir une comptabilité).
En tant que développeur, vous pouvez, grâce à l'API,
vérifier l'effectivité d'un
paiement avant d'autoriser l'accès à un service, une information,
un bien... ou encore,
envoyer un SMS depuis votre site web ou application mobile, ou exécuter un code
USSD. Les sites web payants
et les boutiques en lignes en sont les premières applications pratiques.
- Quel est
l'intérêt de MPay?
- L'intérêt est la
simplicité de mise
en oeuvre: utiliser les contacts de votre smartphone limite les risques d'erreur au
moment du transfert; l'archivage, comme mentionné plus haut, est très
utile pour tenir une comptabilité.
Enfin, pour les développeurs, vous pouvez acheter une carte SIM
comme n'importe quel client et déployer votre service. Fini les
innombrables démarches: vous pouvez avoir une idée le soir à
22h et un prototype prêt à l'emploi le lendemain à 6h.
En outre, MPay unifie la gestion des paiements Mobicash et Orange Money en une seule API.
- Comment fonctionne
le service MPay?
-
Le service MPay s'articule autour de trois composants:
- un serveur central qui enregistre vos transferts. C'est sur ce serveur que vous vous
inscrivez et consultez la liste de vos opérations via votre navigateur internet
ou via l'API; (dans le tiers supérieur du schéma ci-contre)
- une application Android qui reçoit les transferts d'argent
en provenance de vos clients et les enregistre sur le serveur susmentionné
(le smartphone avec l'appli MPay sur le schéma)
- (facultatif) un client web, à installer sur votre site web afin de
faciliter la gestion des paiements de vos utilisateurs (au milieu à droite sur le
schéma).
Le fonctionnement illustré par le schéma est le suivant:
- Votre client consulte votre site web, choisit les articles qui
l'intéressent et constitue son panier. Il peut le faire avec un ordinateur
de bureau, une tablette ou un smartphone.
- Au moment de payer, il effectue un transfert Mobicash ou Orange Money de son
téléphone vers votre téléphone à vous
(téléphone sur lequel vous avez installé l'application
Android MPay)
- MPay, sur votre smartphone, reçoit le transfert et l'enregistre
sur le serveur MPay
- Votre site web peut à présent consulter la liste des transferts
enregistrés et vérifier qu'il a bien reçu le montant
indiqué par votre client
- Si le paiement est validé, votre site web peut autoriser
l'accès à l'information (par exemple, un article de journal
en ligne) ou enclencher le processus de livraison (s'il s'agit d'un
bien physique)
Notez bien que le transfert d'argent se fait entre le téléphone
de votre client et le vôtre. L'application MPay ne fait
que l'enregistrer sur son serveur. En conséquence, vos clients
n'ont pas besoin d'être des abonnés MPay; il paient en
se servant de Mobicash et Orange Money auxquels ils ont déjà
souscrit. Et surtout, MPay ne détient aucunement vos fonds.
Vous pouvez les gérer à votre guise. Il n'y a pas de procédure
d'accès à votre argent, de frais de retrait (autre que ceux des
opérateurs Télécom) ou de coût caché si par
exemple vous souhaitez abandonner le service.
Bien sûr, d'autres cas d'utilisation existent: vous pouvez
simplement avoir une activité commerciale ordinaire et être
payé par transfert mobile; dans ce cas, vous ne vous intéressez
qu'à la possibilité de tirer des relevés pour votre
comptabilité. Ou bien vous souhaitez tout juste vous faciliter les
transferts d'argent vers vos amis et prenant leur numéro de
téléphone dans votre répertoire plutôt que de les
taper manuellement (ce qui est source d'erreur).
- Comment utiliser
l'application android MPay?
- Au lancement de l'application, entrez
vos information de connexion et démarrez le moniteur.
A ce moment, MPay va lire les SMS déjà reçus des
opérateurs et les envoyer progressivement à nos serveurs.
Cela peut prendre un certain temps en fonction du volume de vos transactions.
Toutefois, l'application traitera en priorité tout
SMS qui arrive pendant cette opération potentiellement longue.
- Qu'est-ce que
le moniteur?
- Le moniteur est un composant de
l'application Android. C'est en fait lui qui réceptionne
les SMS de confirmation des opérations, et qui communique avec
l'API. Il n'est en revanche pas utilisé pour effectuer
des transferts.
Conséquence: vous n'avez pas besoin de le
démarrer pour pouvoir envoyer de l'argent à un proche,
ou pour télécharger un relevé. En revanche, pour
alimenter la liste des opérations contenues dans vos relevés,
il faut ce celui-ci tourne.
Lorsque le moniteur démarre, il consulte les SMS qui ont pu
arriver depuis la dernière fois où il a été
arrêté et les transfère à nos installations.
Si les relevés sont tout ce que vous souhaitez, vous pouvez vous
permettre de ne démarrer le moniteur qu'épisodiquement
(une fois par semaine, par exemple).
Mais si vous souhaitez alimenter la liste en continu (pour être
certain au moment de télécharger un relevé que celui-ci
est exhaustif), ou si vous souhaitez utiliser l'API, le moniteur
doit fonctionner en permanence.
Note: lorsque le moniteur est démarré, il affiche une petite
icône dans la barre de notification (
).
Tant que cette icône est présente, vous pouvez même
quitter l'application, le moniteur continue son travail.
- Quel
est le contenu du fichier Relevé?
- Le relevé est disponible en
deux formats: PDF, pour usage direct, et Microsoft Excel pour retraitement.
Le fichier Excel contient deux feuilles, une par opérateur. Sont
rappelées les dates du relevé et l'opérateur.
Vient ensuite le tableau des opérations (une opération par ligne)
avec les colonnes suivantes (certaines colonnes sont masquées pour que
le tableau puisse tenir sur une page en largeur):
A: ID interne de l'opération
B: l'identifiant de la transaction chez l'opérateur
C: le montant créditeur de la transaction
D: le montant débiteur de la transaction
E: le montant des frais de la transaction
F: statut de l'opération (OK, Pending) (colonne masquée)
G: la date de l'opération
H: la date de l'opération, au format texte, pour éviter les erreurs
d'arrondi de la colonne G
I: le SMS d'origine, tel que reçu de l'opérateur (colonne masquée)
J: numéro de téléphone de l'expéditeur
K: nom de l'expéditeur (colonne masquée)
L: numéro de téléphone du destinataire
M: nom du destinataire (colonne masquée)
N: le type d'opération: transfertReception, transfertEnvoi, chargement,… (colonne masquée)
O: le solde à l'issue de l'opération
P: le solde calculé cette fois à partir du solde après l'opération précédente auquel on a additionné le montant de l'opération actuelle. Ceci a pour but de repérer facilement une opération qui n'aurait pas été enregistrée. (colonne masquée)
- Quels sont les
prérequis pour l'utilisation de l'application android MPay?
- Il vous faudra:
- un smartphone tournant sous Android 6.0 (Marshmallow) ou supérieur
(Android 8 est recommandé),
de préférence double puce (une pour chaque opérateur);
Android 4 est supporté si on sacrifie certaines fonctionnalités
comme la gestion double puces
- une puce SIM avec un portemonnaie électronique associé
pour chaque opérateur
- une connexion internet (pour la communication avec nos serveurs)
- du crédit de communication (pour les envois de SMS)
- Qu'arrive-t-il
si je reçois un transfert pendant que MPay est fermé, que mon
téléphone est éteint, ou que je n'ai pas de connexion
internet?
- Au démarrage du moniteur, MPay
traite tous les SMS
qui auraient pu arriver depuis la dernière exécution. Vous ne risquez
donc pas de manquer une transaction. Et s'il n'y a pas de connexion
internet, l'application stocke les information des transferts reçus et
les envoie à nos serveurs dès que celle-ci est rétablie.
- L'application
mobile MPay existe-t-elle sur iOS?
- Non. Le modèle de sécurité
d'iOS ne permet pas à une application tierce d'accéder aux SMS,
or c'est sur cet élément que repose toute l'architecture.
- Comment utiliser le client
web ?
- Le documentation du client web MPay se trouve
sur la page dédiée.
- Puis-je utiliser MPay
ailleurs qu'au Burkina Faso?
- Possible, si les SMS de confirmation vous
parviennent toujours. Mais cela n'a pas été testé.
- MPay fonctionne-t-il
avec d'autres portemonnaies électroniques, au Burkina ou ailleurs?
- Non. Seuls Mobicash et Orange Money sont
supportés. Si en théorie, il devrait être possible
d'élargir la compatibilité à d'autres opérateurs,
cela n'a pas (encore) été envisagé.
- Dois-je réserver
un smartphone exclusivement pour MPay? Puis-je utiliser mon smartphone pendant que
l'application mobile est ouverte?
- Non, vous n'avez pas besoin de monopoliser
une appareil rien que pour l'application. En fait, le contraire est même
recommandé: installer MPay sur le téléphone que vous utilisez
au quotidien vous permettra de vous rendre compte immédiatement de tout
problème qui pourrait survenir: déchargement de la batterie,
épuisement du crédit de communication ou de la connexion
internet...
- Quels sont les
tarifs?
- L'inscription est gratuite. Elle donne
accès au service de base.
Le service complet (exports Excel illimités, utilisation de l'API)
et sans publicité nécessite un abonnement payant aux tarifs suivants:
- 1 mois: 10001F
- 6 mois: 55000F
- 1 an: 100000F
Rappel: votre inscription vous donne un accès complet pendant
7 jours afin de
pouvoir évaluer le service
Les inscriptions et les
abonnements se font sur les
pages dédiés.
- Qu'est-ce
qu'un code promo? Un code affilié?
- Un code promo, comme son nom
l'indique, est un code qui vous donne droit à une réduction
sur vos (ré)abonnements. Il est à saisir au moment de votre
inscription, ou sur la page
d'infos compte avant de procéder à
l'abonnement.
Au moment de votre premier abonnement, vous devenez affilié, et un
code affilié vous est attribué. Ce code affilié est un code
promo que vous pouvez communiquer à toute personne intéressée
par MPay: cette personne aura droit à un réduction sur
son abonnement, tandis que vous-même toucherez une commission sur ledit
abonnement.
N'hésitez donc pas à répandre l'information!
- Quelles sont les
permissions demandées par l'application mobile?
- L'application nécessite
l'accès à internet, à l'état du
téléphone (pour les noms des puces SIMs) et bien sûr aux SMS
déjà reçus ou entrants. Elle doit également pouvoir lancer des
appels (pour exécuter des codes USSD) et envoyer des SMS. Enfin, un service
d'accessibilité (le lecteur USSD de MPay) doit être activé
afin de recevoir le résultat de l'exécution des codes USSD que vous
pouvez envoyer via l'API.
- Puis-je utiliser un
même compte sur plusieurs smartphones?
- Le schéma conseillé est 1 compte,
un smartphone double puce, et 2 SIMs (une par opérateur).
Rien ne vous empêche d'utiliser le même compte sur plusieurs
smartphones, mais dans ce cas, vous n'aurez aucune indication du numéro
sur lequel vous avez reçu un paiement donné, vu que toutes les
informations seront stockées au même endroit; tout le travail de
comptabilité en sera d'autant plus difficile. De même pour
l'API: elle ne pourra jamais communiquer qu'avec le dernier
moniteur à avoir démarré.
- Qu'est-ce que
l'URL de rappel? Comment l'utiliser?
- L'URL de rappel est une URL qui sera
appelée (par la méthode HEAD) à chaque fois qu'une
opération est enregistré sur votre compte. Elle permet à
votre application/site web d'être notifié de toute nouvelle
transaction. Ainsi, vous pouvez agir de manière proactive (par exemple en
prorogeant la souscription d'un utilisateur dont vous auriez reconnu le numéro).
L'URL de rappel est indiquée/modifiée sur la
page d'informations de votre compte. Toute occurrence de la
chaine %ID% sera remplacée par l'identifiant de
l'enregistrement qui vient d'être créé.
Exemple: http://www.example.com/rappel.php?identifiant=%ID%
Si vous recevez un paiement et qu'un enregistrement est créé
avec l'identifiant 365, l'URL invoquée sera
http://www.example.com/rappel.php?identifiant=365
A charge pour vous à présent d'interroger le service
MPay via l'API pour obtenir les
informations du transfert.
Note: Le client web MPay peut vous
faciliter grandement la tâche.
- J'ai envoyé
un code USSD à l'application via l'API, mais il n'a pas
été exécuté.
- Cela peut arriver si vous avez Android 10
(ou supérieur) et avez installé l'application à partir
du Google Play.
A partir d'Android 10, une application qui s'exécute en
tâche de fond ne peut plus démarrer une activité. Or
c'est par ce procédé que MPay exécute les codes
USSD reçus via l'API. Et Google Play ne publie plus d'application
qui ciblerait une version d'Android antérieure à la 10.
La solution est d'installer l'application mobile à partir de
la page téléchargement. Cette version n'étant pas
publiée sur Google Play peut cibler Android 8 et donc conserver le
comportement antérieur, même sur Android 10.
- J'ai envoyé
des codes USSD à l'application via l'API, mais je n'ai pas obtenu
le résultat de leur exécution.
- Vérifiez, dans les paramètres
d'accessibilité de votre smartphone, que le service "Lecteur USSD de
MPay" est bien activé. C'est lui qui interagit avec le serveur USSD
de l'opérateur Télécom et vous permet de recevoir sa
réponse.
- A quoi servent les
URL raccourcies?
- Une URL raccourcie est une URL (relativement)
courte qui fonctionne comme un raccourci vers une URL plus longue. Si vous connaissez
des services tels que Bitly ou
TinyUrl, c’est de cela qu’il s’agit.
L’objectif est donc d’obtenir une URL plus courte, plus facile à
saisir (ou à retenir) pour un être humain, mais également plus
facile à transférer par exemple dans un SMS où le nombre de
caractères est limité.
MPay offre un service d’URL raccourcies via le domaine msoft.bf. Ainsi, votre
URL https://www.ceci.est.mon.sous.domaine.com/avec/un/chemin/tres/long/vers/une/page/tres/cool/de/mon/site/web/personnel?avec=tous&ses=parametres&esoteriques=requis&ou=non
peut être
raccourcie en https://msoft.bf/AZERTYU
Votre compte MPay vous donne droit à 50 URL raccourcies.
Afficher/Masquer tout