Documentation · v1.6

Guide d'utilisation TontyGo

Tout ce qu'il faut savoir pour gérer vos tontines avec TontyGo — de la collecte des cotisations aux paiements Mobile Money.

📖 Introduction

TontyGo est une application de gestion de tontines conçue pour les agents commerciaux, les caissiers et les gérants au Togo. Elle permet de digitaliser entièrement le cycle de collecte : cotisations en espèces, paiements Mobile Money, impression de reçus et suivi en temps réel.

L'application est accessible :

InterfaceURLPublic cible
App mobile / webapp.tontygo.comAgents, caissiers, clients
Dashboard adminadmin.tontygo.comGérants, super-admin
API backendapi.tontygo.comIntégrations techniques

👥 Rôles utilisateurs

TontyGo distingue quatre rôles avec des droits différents :

🏢

Super Admin

Accès total à la plateforme, gestion des comptes, configuration globale.

admin.tontygo.com
👔

Agent commercial

Collecte les cotisations auprès des clients, valide les cases, initie les paiements Mobile Money.

app.tontygo.com
🏦

Caissier

Vérifie et valide les dépôts physiques des agents. N'a pas accès aux paiements Mobile Money.

app.tontygo.com
👤

Client

Consulte son livret, l'historique de ses cotisations et sa progression dans la tontine.

app.tontygo.com

🔐 Connexion à l'application

1

Ouvrir l'application

Depuis votre terminal Android, ouvrez app.tontygo.com dans le navigateur, ou lancez l'APK installé.

2

Saisir vos identifiants

Entrez votre email et votre mot de passe fournis par votre administrateur.

3

Accès au tableau de bord

Selon votre rôle, vous accédez directement à votre espace : collecte pour les agents, vérification pour les caissiers.

⚠️
Votre compte est créé par un administrateur. En cas de problème de connexion, contactez votre gérant ou écrivez à support@tontygo.com.

💰 Collecte des cotisations

La collecte se fait client par client. Chaque client a un code unique qui permet à l'agent de l'identifier rapidement.

1

Scanner ou rechercher le client

Scannez le QR code du client ou recherchez-le par nom / code unique dans la liste.

2

Sélectionner les cases à valider

Le livret du client affiche les cases disponibles pour la période en cours. Sélectionnez le nombre de cases à encaisser.

3

Choisir le mode de paiement

Espèces : encaissez physiquement et validez. Le dépôt apparaîtra chez le caissier pour vérification.
Mobile Money : initiez un paiement en ligne (voir section suivante).

4

Imprimer le reçu

Après validation, un reçu est généré automatiquement. Imprimez-le depuis votre terminal Sunmi, XZY ou tout autre terminal compatible.

📱 Paiement Mobile Money

TontyGo accepte les trois principaux opérateurs Mobile Money au Togo via la passerelle CinetPay :

🟡

Mixx by Yas

Anciennement Flooz · Yas Togo

🔵

Moov Money

Moov Africa Togo

🟢

GOZEM Money

Portefeuille GOZEM

Comment ça marche

1

L'agent sélectionne "Mobile Money"

Dans l'écran de paiement, choisissez le mode Mobile Money et l'opérateur du client.

2

Le client reçoit la demande

Une notification de paiement est envoyée sur le téléphone du client. Il confirme avec son code PIN Mobile Money.

3

Confirmation automatique

Dès que CinetPay confirme le paiement (IPN), la case est validée automatiquement — aucune action manuelle requise.

Les paiements Mobile Money sont séparés des espèces dans les rapports. Le caissier ne vérifie que les dépôts physiques — les paiements digitaux sont déjà validés.

🖨️ Impression du reçu

TontyGo est compatible avec plusieurs terminaux Android :

TerminalImprimanteConnexion
Sunmi V2 / T2Intégrée (ESC/POS)Automatique
Terminaux XZY / FYJIntégréeAutomatique
Autres AndroidBluetooth ESC/POSSélection dans l'app

Le reçu est imprimé automatiquement après chaque paiement validé. Il contient : nom du client, montant, numéro de case, date et référence de transaction.

🏦 Vérification des dépôts (Caissier)

Chaque dépôt en espèces d'un agent apparaît dans la file d'attente du caissier. La vérification se fait en deux étapes :

1

Consulter la liste des dépôts

L'onglet Dépôts en attente affiche tous les dépôts non encore vérifiés, avec le montant et l'agent concerné.

2

Compter et valider

Comptez les espèces physiques. Si le montant correspond, appuyez sur Valider. En cas d'écart, utilisez Signaler un problème.

⚠️
Les paiements Mobile Money n'apparaissent pas dans la file du caissier — ils sont validés automatiquement par CinetPay. Le caissier ne traite que les espèces.

🔑 Code unique client

Chaque client possède un code unique à 6 caractères. Ce code permet :

  • L'identification rapide sans recherche par nom
  • La vérification de l'identité lors d'un dépôt physique
  • L'accès au livret via l'application client

Le code est imprimé sur le reçu et visible dans le profil client de l'app.

📊 Dashboard Admin

Le dashboard administrateur est accessible sur admin.tontygo.com. Il offre une vue complète sur :

ModuleDescription
Vue d'ensembleStatistiques en temps réel : agents actifs, cotisations du jour, total collecté
AgentsCréation, modification et désactivation des comptes agents
ClientsListe des clients, livrets et historique des paiements
Produits / PacksConfiguration des offres de tontine (montant, durée, image)
Paiements Mobile MoneyHistorique et statut des transactions CinetPay
RapportsExport des données par période, agent ou produit

👔 Gestion des agents

1

Créer un compte agent

Dans le dashboard admin → Agents → Nouvel agent. Renseignez nom, email et mot de passe. L'agent reçoit ses identifiants pour se connecter.

2

Assigner des clients

Les clients sont attribués à un agent lors de leur création. Un agent ne voit que ses propres clients dans l'app.

3

Suivre la performance

La fiche agent affiche le total collecté, le nombre de clients actifs et l'historique des transactions.

Questions fréquentes

Un client n'a pas reçu sa notification de paiement Mobile Money

Vérifiez que le numéro Mobile Money renseigné dans son profil est correct. Si le problème persiste, contactez le support. Le paiement peut aussi être initié en demandant au client de composer le code USSD de son opérateur.

L'imprimante Bluetooth ne se connecte pas

Assurez-vous que le Bluetooth est activé sur le terminal. Dans l'app, allez dans Paramètres → Imprimante et sélectionnez votre appareil dans la liste. Si l'imprimante n'apparaît pas, appairez-la d'abord depuis les paramètres Bluetooth d'Android.

Un dépôt espèces n'apparaît pas chez le caissier

Le dépôt doit être soumis par l'agent (pas seulement enregistré). Vérifiez dans l'historique de l'agent que le statut est En attente. Si le statut est Brouillon, l'agent doit soumettre le dépôt.

Comment réinitialiser le mot de passe d'un agent ?

Dans le dashboard admin → Agents → fiche de l'agent → Réinitialiser le mot de passe. Un nouveau mot de passe provisoire est généré et peut être communiqué à l'agent.

L'application est lente ou affiche une erreur de connexion

Vérifiez la connexion internet du terminal. L'application nécessite une connexion active pour synchroniser les données. En cas d'erreur persistante, videz le cache du navigateur ou de l'APK et reconnectez-vous.

Besoin d'aide ?

Notre équipe est disponible du lundi au samedi pour répondre à vos questions.

📍 Adidogomé Wonyome, à 400m de l'église catholique — 04 BP 380 Lomé, Togo
Tél : +228 90 38 29 64 · +228 70 75 25 85 · +228 22 51 59 49