4N-TN-001BANCAIRE· En vigueur · Banque et paiements
OTP bancaire en Tunisie : livrer le code à temps
La Banque Centrale de Tunisie supervise les banques et les établissements de paiement, ainsi que le paiement mobile interopérable lancé en 2022. Paiement par carte en ligne, virement depuis l'application, ajout d'un bénéficiaire : le système de la banque génère un code à usage unique puis appelle l'API REST 4notify pour le livrer par SMS.
SMSPushE-mail
Un code qui arrive après son expiration fait échouer le paiement et génère un appel au centre de relation client. La banque reste responsable de la sécurité du parcours et des données qui y circulent.
Envoi vers les abonnés de Tunisie Telecom, Ooredoo Tunisie et Orange Tunisie, les trois opérateurs mobiles du pays.
Textes applicables
- Loi n° 2016-48 du 11 juillet 2016 relative aux banques et aux établissements financiersCadre de l'agrément et de la supervision des établissements bancaires par la BCT.
- Loi n° 2016-35 du 25 avril 2016 fixant le statut de la Banque Centrale de TunisieMissions de la BCT, dont la surveillance des systèmes de paiement.
- Loi organique n° 2004-63 du 27 juillet 2004Protection des données à caractère personnel, dont le numéro du client.
Mode opératoire
- 1Le code naît à la banqueLe système de la banque génère et vérifie le code ; 4notify ne fait que livrer le message.
- 2Appel API sécuriséJeton JWT obtenu en client_credentials, puis POST /api/v1/sms avec le numéro et le texte.
- 3Bascule entre routes SMSSi une route échoue, 4notify passe automatiquement sur une autre route configurée.
- 4État de livraisonChaque message a un état consultable dans le panneau et par l'API.
Appel type à l'API
{
"canal": "sms",
"destinataire": "+216XXXXXXXX",
"expediteur": "MaBanque",
"message": "MaBanque : code de validation 730518 pour votre paiement de 245,500 TND. Valable 3 min.",
"reference_interne": "PAY-2026-11-19-1184"
}Message type
SMS
BIAT : code de validation 730518 pour votre paiement de 245,500 TND. Valable 3 min. Ne le communiquez à personne.
Points de contrôle
- ✓Code généré et vérifié dans le système de la banque
- ✓Jeton JWT conservé côté serveur
- ✓Montant en TND (trois décimales) dans le message de paiement
- ✓État de livraison surveillé pour les codes non reçus
L'avantage 4notify
Une seule API pour le SMS, le push et l'e-mail, avec bascule automatique entre routes SMS et suivi de livraison par message.
Foire aux questions
4notify crée-t-il les codes OTP ?
Non. Le code est créé et contrôlé par la banque ; 4notify transporte uniquement le SMS, le push ou l'e-mail.
4notify est-il connecté au switch de paiement mobile ?
Non. C'est le système de la banque ou de l'établissement de paiement qui appelle l'API REST 4notify.