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 financiers
    Cadre 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 Tunisie
    Missions de la BCT, dont la surveillance des systèmes de paiement.
  • Loi organique n° 2004-63 du 27 juillet 2004
    Protection des données à caractère personnel, dont le numéro du client.

Mode opératoire

  1. 1
    Le code naît à la banque
    Le système de la banque génère et vérifie le code ; 4notify ne fait que livrer le message.
  2. 2
    Appel API sécurisé
    Jeton JWT obtenu en client_credentials, puis POST /api/v1/sms avec le numéro et le texte.
  3. 3
    Bascule entre routes SMS
    Si une route échoue, 4notify passe automatiquement sur une autre route configurée.
  4. 4
    État de livraison
    Chaque 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.
Créer un compteVoir le Carnet

Autres pages du Carnet

← Retour à 4notify Tunisie