Plateforme de documentation interactive

Inscription Scolaire
via USSD & PSP

Parcours Client
UX / UI Client
Simulateur USSD interactif avec scénarios : wallet unique, déjà payé, ID erroné, absence de wallet.
Lancer le simulateur
Technique
Workflow & API
Diagramme de séquence complet, étapes du processus et documentation des appels API avec exemples JSON.
Voir la documentation
Tunisie Télécom · CNTE · Paysmart EDP Banque La poste · 2026
PS
Paysmart
UX / UI Client — Simulateur USSD
Simulateur USSD • Client
Tunisie Télécom
🔋 87%

Paiement Scolaire

Sélectionnez un scénario

🎯 Scénarios

📋 Progression

PS
Paysmart
Workflow & API — Inscription scolaire via USSD

Inscription scolaire via USSD et PSP

Processus simplifié : *181*IDélève# → Détails inscription → Paiement

%%{init: {'sequence': {'showSequenceNumbers': true, 'actorFontSize': 14, 'actorFontWeight': 500, 'noteFontSize': 12, 'messageFontSize': 12}}}%% sequenceDiagram autonumber participant C as Client/Parent participant T as Telco participant PS as Paysmart (Gateway) participant EDP as EDP (Wallet) participant CNTE as CNTE Note over C, T: Étape 1: Saisie du code USSD C->>T: *181*ID_élève# Note over T, PS: Étape 2: Telco invoque l'API Paysmart T->>PS: Requête (MSISDN + ID_élève) PS->>CNTE: Consultation inscription (ID_élève) CNTE-->>PS: Détails inscription (Nom, Prénom, Montant, Statut) PS->>PS: Mapping MSISDN → Wallet par défaut alt Pas de Wallet associé PS-->>T: Statut: NO_WALLET T-->>C: Vous n'avez pas de wallet. Contactez l'agent de paiement le plus proche. Note over C, T: Fin session - Orientation agent else Wallet existe PS-->>T: Détails inscription + Wallet par défaut T-->>C: Élève: [Nom Prénom] Montant: [X] DT Statut: [PAYÉ/NON PAYÉ] Wallet: [Type] alt Inscription déjà payée Note over C, T: Fin session - Paiement déjà effectué else Inscription non payée Note over C, PS: Étape 2.2: Saisie PIN et/ou CIN C->>T: Saisie PIN (et CIN si requis) T->>PS: Requête paiement (PIN + éventuel CIN) Note over PS, EDP: Étape 3: Paysmart invoque Web Hook EDP PS->>EDP: Web Hook authentification & réservation EDP->>EDP: Validation PIN & vérification KYC/plafonds alt Authentification échouée EDP-->>PS: Erreur authentification PS-->>T: Échec paiement T-->>C: PIN incorrect ou wallet non autorisé else Authentification réussie EDP-->>PS: OK - Réservation effectuée (ID Réservation) Note over EDP, PS: Étape 4: Notification paiement EDP->>PS: Confirmation paiement (Webhook callback) PS->>CNTE: Mise à jour statut inscription PS-->>T: Notification succès paiement Note over T, C: Étape 5: Affichage message de fin T-->>C: Paiement réussi ! Inscription validée. Note over EDP, C: Étape 6: SMS de confirmation EDP-->>C: SMS: Paiement [Montant] DT Réf: [XXX] Élève: [Nom Prénom] end end end

Les 6 étapes du processus

Étape 1 : Saisie du code USSD

1

Saisie du code

Le parent compose *181*ID_élève# sur son mobile

Parent, Telco

Étape 2 : Appel API Paysmart et réponse

2

Telco → Paysmart

Le Telco invoque l'API de Paysmart avec MSISDN + ID_élève

Telco, Paysmart
2.1

Cas : Pas de wallet

Paysmart retourne l'absence de wallet → Le parent est invité à contacter l'agent de paiement le plus proche

Parent, Agent
2.2

Cas : Wallet existe

Paysmart retourne les détails de l'inscription + info wallet par défaut. Le parent saisit son PIN (et CIN si requis) → invocation API paiement

Parent, Paysmart

Étape 3 : Webhook EDP

3

Paysmart → EDP

Paysmart invoque le Web Hook de l'EDP pour :
✅ Authentifier le wallet
✅ Réserver l'inscription
✅ Initier le paiement

Paysmart, EDP

Étape 4 : Notification du paiement

4

PSP → Paysmart → CNTE & Telco

Le PSP notifie Paysmart du paiement. Paysmart notifie à son tour :
✅ CNTE (mise à jour statut)
✅ Telco (pour affichage)

PSP, Paysmart, CNTE, Telco

Étape 5 : Affichage message au parent

5

Telco → Parent

Le Telco affiche le message de confirmation de paiement sur l'écran USSD

Telco, Parent

Étape 6 : SMS de confirmation

6

PSP → Parent

Le PSP envoie un SMS de confirmation au parent avec les détails du paiement

PSP, Parent

📋 Récapitulatif des 6 étapes :
1. Parent saisit *181*ID_élève#
2. Telco invoque API Paysmart → retour détails inscription + info wallet (2.1 si pas wallet → orientation agent ; 2.2 si wallet existe → saisie PIN/CIN et appel API paiement)
3. Paysmart invoque Web Hook EDP pour authentifier, réserver et initier paiement
4. PSP notifie Paysmart → Paysmart notifie CNTE et Telco
5. Telco affiche message de confirmation au parent
6. PSP envoie SMS de confirmation au parent

✓
Tunisie Télécom
Prêt