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/UEMOA
    Cadre des systèmes de paiement dans l'UEMOA, dont les paiements électroniques.
  • Instruction BCEAO n° 001-01-2024
    Services de paiement dans l'UMOA ; base du paiement instantané PI-SPI, lancé le 30 septembre 2025.
  • Instruction BCEAO n° 008-05-2015
    Conditions d'exercice des émetteurs de monnaie électronique.

Comment ça marche

  1. 1
    Le code naît dans votre système
    La 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.
  2. 2
    Appel à l'API REST
    Votre serveur s'authentifie en JWT (client_credentials) et envoie le message à POST /api/v1/sms, avec le numéro au format +221.
  3. 3
    Bascule entre routes SMS
    Si 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.
  4. 4
    Suivi de livraison
    L'é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.
Créer un compteVoir les Dossiers

Autres Dossiers

← Retour à 4notify Sénégal