Questions/Réponses

Dernière mise à jour le 13/09/2023 à 23:20

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'unités 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:

1. 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.
2. 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)
3. MPay, sur votre smartphone, reçoit le transfert et l'enregistre sur le serveur MPay
4. 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
5. 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 notre page téléchargement. Cette version n'étant pas publiée sur Google Play, elle peut cibler Android 8 et ainsi 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.