4N-SN-001BANCAIRE· En vigueur · Banque et paiements
OTP bancaire et mobile money au Sénégal par SMS
Au Sénégal, l'argent circule autant par Wave et Orange Money que par les comptes bancaires. Chaque paiement sensible se confirme par un code à usage unique : le système de la banque ou de l'émetteur de monnaie électronique génère ce code puis appelle l'API REST de 4notify pour le livrer par SMS, push ou e-mail.
SMSPushE-mail
Les règles de la BCEAO sur les services de paiement et la monnaie électronique s'appliquent à toute l'UEMOA. Un code de confirmation qui arrive en retard ou sur une route douteuse, c'est un client bloqué au guichet ou un fraudeur qui en profite : la livraison fait partie de la sécurité.
Livraison vers les abonnés d'Orange (Sonatel), de Yas (ex-Free Sénégal) et d'Expresso, les trois opérateurs mobiles du Sénégal.
Textes de référence
- Règlement n° 15/2002/CM/UEMOACadre des systèmes de paiement dans l'UEMOA, dont les paiements électroniques.
- Instruction BCEAO n° 001-01-2024Services de paiement dans l'UMOA ; base du paiement instantané PI-SPI, lancé le 30 septembre 2025.
- Instruction BCEAO n° 008-05-2015Conditions d'exercice des émetteurs de monnaie électronique.
Comment ça marche
- 1Le code naît dans votre systèmeLa banque ou le wallet génère l'OTP et fixe sa durée de validité. 4notify ne génère aucun code : il reçoit le texte à livrer.
- 2Appel à l'API RESTVotre serveur s'authentifie en JWT (client_credentials) et envoie le message à POST /api/v1/sms, avec le numéro au format +221.
- 3Bascule entre routes SMSSi une route SMS configurée échoue, 4notify bascule automatiquement sur la suivante ; push ou e-mail peuvent être envoyés par la même API.
- 4Suivi de livraisonL'état de chaque message est consultable dans le panneau et via l'API ; vos journaux réglementaires restent dans votre propre système.
Requête envoyée à l'API
{
"canal": "sms",
"destinataire": "+221770000000",
"expediteur": "MaBanque",
"message": "MaBanque : votre code est 584120. Valable 5 min. Ne le communiquez jamais.",
"reference": "virement-2026-11-19-0412"
}Exemple de message
SMS
Ecobank : votre code de validation est 584120. Valable 5 minutes. Ne le communiquez à personne, même à un agent.
Liste de contrôle
- ✓OTP généré et horodaté par le système de la banque ou du wallet
- ✓Appels à l'API 4notify authentifiés en JWT (client_credentials)
- ✓Au moins deux routes SMS configurées pour la bascule automatique
- ✓État de livraison suivi dans le panneau ou via l'API
Ce qui fait la différence
Une seule API pour les codes de la banque comme du wallet, avec bascule automatique entre vos routes SMS et un état de livraison par message.
Questions fréquentes
4notify se connecte-t-il directement à Wave ou Orange Money ?
Non. C'est votre système qui appelle l'API REST de 4notify ; il n'existe pas de connecteur natif avec les wallets.
Comment savoir si l'OTP est arrivé ?
L'état de livraison de chaque message est visible dans le panneau et via l'API ; en cas d'échec, la bascule automatique essaie une autre route SMS configurée.