CIVICASH

Comment fonctionnent les plateformes

Guide de la recette : ce que fait chaque plateforme, comment se déroulent un dépôt et un retrait, et comment mener les essais.

En bref

CIVICASH permet aux joueurs de JOLIBET de déposer et de retirer de l'argent par mobile money (Orange Money, MTN Mobile Money, Moov Money et Wave), en Côte d'Ivoire.

Pendant la recette, un simulateur de JOLIBET joue le rôle du partenaire : on peut tout essayer sans toucher au vrai site de paris.

Les plateformes

Joueur

Chatbot de dépôt

La page que le joueur ouvre depuis le lien envoyé par JOLIBET. Elle lui dit quel montant envoyer et à quel numéro, recueille la preuve de son paiement et lui montre, en direct, que son dépôt est confirmé.

chatbot.civipay.pro

Agents

Application agent (Android)

Deux rôles dans une même application : le relais, qui lit les messages des opérateurs sur le téléphone du compte marchand et les transmet ; et la console, où l'agent traite les retraits et vérifie les dépôts.

Superviseurs et administrateurs

Dashboard

Le poste de pilotage : transactions, mouvements, soldes des comptes, téléphones, alertes, journal, rapprochement quotidien, sous-traitants et administration.

dashboard.civipay.pro

JOLIBET

API partenaire

Le point d'entrée technique de JOLIBET : il crée les dépôts et les retraits, suit leur état et reçoit une notification signée quand ils aboutissent.

api.civipay.pro

Recette

Simulateur de JOLIBET

Une page qui se comporte comme JOLIBET : elle crée des dépôts et des retraits, donne le lien du chatbot et montre les notifications reçues de CIVICASH.

simulateur.civipay.pro

Le parcours d'un dépôt

  1. JOLIBET crée la demande. Le joueur demande un dépôt sur JOLIBET, qui le transmet à CIVICASH et reçoit un lien de paiement pour le joueur.
  2. Le joueur ouvre le chatbot et choisit son réseau. Il lit les conditions (délai pour payer, frais en cas de remboursement) puis choisit Orange, MTN, Moov ou Wave. Pour Wave, il indique le numéro qui va payer.
  3. Il envoie le montant exact au numéro affiché. Le chatbot affiche le numéro marchand et le montant ; le joueur paie depuis son téléphone, comme d'habitude. Aucun code secret ne lui est jamais demandé.
  4. Il annonce son paiement et en donne la preuve. Il appuie sur « J'ai payé » et ajoute la capture d'écran du SMS de son opérateur. Le chatbot lit la référence sur la capture et lui demande de la confirmer ; si la capture est illisible, il la tape. Pour Wave, la capture est facultative.
  5. Le téléphone du compte marchand reçoit le message de l'opérateur. L'application relais le lit et le transmet à CIVICASH, de façon chiffrée et signée.
  6. CIVICASH rapproche les deux. Même référence (ou, pour Wave, même numéro payeur), montant exact, bon compte, dans le délai : le dépôt est confirmé automatiquement. S'il manque quelque chose (montant différent, message absent…), il passe « à vérifier » par un agent.
  7. Tout le monde est prévenu. JOLIBET reçoit la notification et crédite le compte du joueur ; le chatbot affiche la confirmation en direct et le joueur reçoit un SMS.

Le parcours d'un retrait

  1. JOLIBET demande le retrait. Avec le montant, le réseau et le numéro du joueur à payer.
  2. CIVICASH choisit le compte qui paiera. Un compte marchand du même réseau qui a le solde nécessaire, en commençant par ceux des sous-traitants. Le montant y est réservé : deux retraits ne comptent jamais sur le même argent.
  3. Un agent valide. Au-delà d'un seuil, un superviseur doit donner une seconde approbation : jamais la même personne pour les deux.
  4. L'agent paie depuis le téléphone du compte. L'application lui indique le numéro et le montant à saisir dans l'application de l'opérateur.
  5. Le message de débit confirme le paiement. Le relais lit le SMS de l'opérateur et CIVICASH marque le retrait comme payé. Pour Wave, qui n'envoie pas de message, l'agent confirme avec l'identifiant de l'opération.
  6. JOLIBET et le joueur sont prévenus. JOLIBET reçoit la notification ; le joueur reçoit un SMS.

Le dashboard, page par page

PageÀ quoi elle sert
Vue d'ensembleL'activité du jour : dépôts, retraits, files d'attente, alertes.
TransactionsTous les dépôts et retraits, avec leur fiche : historique, paiements, captures du joueur, SMS envoyés, décisions.
MouvementsLes paiements lus par les téléphones : ceux qui ne correspondent à aucune demande, les sorties à justifier.
Comptes et soldesChaque compte marchand, son solde et son contrôle ; relevés de solde, opérations de trésorerie.
Relais et appareilsLes téléphones relais : état, enrôlement par QR code, comptes rattachés, révocation.
AlertesCe qui demande une action : relais silencieux, écart de solde, paiement sans confirmation…
JournalToutes les actions et toutes les connexions, en lecture seule ; export pour contrôle.
RapprochementChaque jour, les opérations comptées chez JOLIBET, chez CIVICASH et chez les opérateurs, et les écarts à expliquer.
Sous-traitantsLes partenaires qui tiennent des comptes : fonds détenus, plafonds, commissions, relevés périodiques.
AdministrationAgents, comptes marchands, partenaires, barèmes de commission, paramètres.

Qui voit quoi

L'application agent

Le relais

Installé sur chaque téléphone qui porte la SIM d'un compte marchand. Il lit les SMS des opérateurs et les notifications de Wave Business, les garde dans une file chiffrée s'il n'y a pas de réseau, et les envoie à CIVICASH dès que possible. Les messages qui contiennent un code secret ne sont jamais transmis.

Sur un téléphone relais : le laisser allumé, chargé et connecté, et ne jamais effacer à la main les notifications de Wave Business.

Un téléphone est enrôlé depuis le dashboard (Relais et appareils) en scannant un QR code ; on y rattache ensuite le ou les comptes marchands de ses SIM.

La console

L'agent s'y connecte avec son adresse, son mot de passe et un code à 6 chiffres. Il y trouve la file des retraits à valider et à payer, les dépôts à vérifier, les fiches détaillées et les alertes, mises à jour en direct.

Sécurité, en pratique

La recette, étape par étape

La recette se fait sur les vraies plateformes, avec le simulateur à la place de JOLIBET. Elle sert à tout essayer, puis à décider ensemble de ce qu'il faut simplifier.

  1. Premier administrateur. Il active son compte, choisit son mot de passe et enregistre son code dans une application d'authentification.
  2. Agents. L'administrateur les invite depuis Administration → Agents ; chacun active son compte de la même façon.
  3. Comptes marchands. On déclare les numéros marchands de chaque réseau (Administration → Comptes marchands).
  4. Téléphones relais. On installe l'application sur chaque téléphone de compte marchand, on l'enrôle par QR code et on y rattache ses comptes.
  5. JOLIBET simulé. On crée le partenaire dans Administration → Partenaires ; le simulateur est ensuite branché dessus.
  6. Les essais. Depuis le simulateur : un dépôt Orange avec capture ; un dépôt Wave ; un dépôt au mauvais montant (il doit passer « à vérifier ») ; un retrait, avec et sans seconde approbation. On regarde à chaque fois le chatbot, le dashboard et l'application.
  7. Le bilan. On note ce qui a été difficile ou lent, pour décider des simplifications.

Pendant la recette, les SMS aux joueurs sont simulés : ils sont préparés et tracés, mais pas encore envoyés. Ils partiront pour de vrai une fois le compte d'envoi branché.

Glossaire

Compte marchand
Un compte mobile money de CIVICASH (ou d'un sous-traitant) sur lequel les joueurs paient et depuis lequel les retraits sont payés.
Relais
Le téléphone qui porte la SIM d'un compte marchand et transmet à CIVICASH les messages de l'opérateur.
Mouvement
Une entrée ou une sortie d'argent sur un compte marchand, lue dans un message ou saisie par un agent.
Référence
L'identifiant d'une opération donné par l'opérateur dans son SMS ; il relie le paiement du joueur à sa demande.
Rapprochement
Le fait de relier un paiement reçu à une demande (même référence, même montant, bon compte).
Chaîne de solde
Le contrôle que chaque nouveau solde annoncé par l'opérateur suit bien le précédent : un message manquant ou faux se voit aussitôt.
Sous-traitant
Un partenaire qui tient des comptes marchands pour CIVICASH, rémunéré par commission.
Seconde approbation
La validation d'une autre personne, obligatoire au-delà d'un certain montant.