🔒Paiement 100 % sécurisé 🕐Support 24/7 🌍FedaPay & Stripe — Mobile Money & cartes

MANAGER

Guide du gestionnaire

En tant que gestionnaire, vous êtes le client payant : vous créez et paramétrez vos groupes de tontine, gérez vos participants, suivez les cotisations, relancez les retards, validez les paiements hors-ligne, libérez les décaissements, animez votre communauté et lisez votre propre facturation. Vos données sont totalement isolées de celles des autres gestionnaires.

🔑Accès

Connectez-vous à l'espace Gestionnaire avec votre compte Keycloak (rôle MANAGER). Votre tenantId est injecté depuis votre jeton — il vous rattache automatiquement à vos seules données.

Créer et paramétrer un groupe de tontine

Un groupe rassemble les paramètres d'une tontine. À la création, vous définissez :

Paramètre Valeurs Description
Montant de cotisation contributionAmount Somme due par chaque participant à chaque tour.
Devise XOF, EUR, USD… Détermine aussi le routage de paiement (XOF ⇒ FedaPay, EUR/USD ⇒ Stripe).
Cycle daily · weekly · monthly · quarterly · semiannual · annual · free Rythme des échéances. En mode free, vous saisissez vos propres dates (customDates[]).
Mode de bénéficiaire draw · fixed · auction Tirage au sort, ordre fixe, ou enchère pour désigner qui encaisse chaque tour.
Pénalités de retard flat | pct Montant fixe ou pourcentage appliqué automatiquement à une cotisation en retard.
Date de début & tours startDate, rounds Point de départ et nombre de tours (souvent égal au nombre de participants).
🔁Modes de bénéficiaire

Draw : à chaque tour, le bénéficiaire est tiré au sort parmi ceux qui n'ont pas encore reçu. Fixed : l'ordre est défini à l'avance (rotationPosition de chaque adhésion). Auction : les participants enchérissent, le plus offrant encaisse le tour (l'écart alimente le groupe).

Le statut du groupe évolue : active → suspended → closed. Le moteur de cycle calcule automatiquement les échéances (dueDate) de chaque tour et déclenche les rappels ; il applique aussi les pénalités et fait passer une cotisation impayée à l'échéance en overdue.

Créer des participants & des adhésions

Un participant est une personne (nom, email, téléphone) rattachée à votre tenant. Une adhésion relie un participant à un groupe : c'est une relation N:N — une même personne peut appartenir à plusieurs de vos groupes, chacun avec sa propre position de rotation.

  1. Créez le participantRenseignez nom complet, email et téléphone. Son statut démarre à invited.
  2. Ajoutez-le à un groupeCréez l'adhésion et fixez la rotationPosition si le mode est fixed.
  3. Envoyez l'invitationLe participant reçoit un lien (email/SMS), crée son accès et passe active.
⚠️Limites du forfait

Le nombre de groupes actifs et de participants est plafonné par votre forfait (maxGroups, maxParticipants). Si vous atteignez la limite, passez à un palier supérieur avec l'aide de RMS.

Faire tourner plusieurs tontines en parallèle

Rien ne vous limite à un seul groupe. Vous pouvez opérer plusieurs tontines simultanément — chacune avec son montant, son cycle, sa devise et son mode de bénéficiaire propres. Le tableau de bord regroupe vos groupes avec, pour chacun : le tour en cours (currentRound), le solde du fonds (fundBalance), le prochain bénéficiaire et le taux de cotisations payées.

💡Astuce

Un participant partagé entre plusieurs groupes n'est saisi qu'une fois : réutilisez la même fiche participant et créez simplement une nouvelle adhésion pour chaque groupe.

Suivre les cotisations & relancer les retards

À chaque tour, une cotisation est due par participant. Son statut passe par :

pending→ declared→ paid | overdue | waived

Le moteur envoie automatiquement des rappels avant échéance et signale les retards. Depuis la vue « Cotisations » d'un groupe, filtrez sur overdue pour relancer les retardataires (notification / broadcast).

Valider un paiement hors-ligne

Pour les règlements en espèces ou en Mobile Money hors passerelle, le participant déclare son paiement — la cotisation passe declared (jamais créditée automatiquement). Vous, gestionnaire du tenant propriétaire, la validez.

  1. Le participant déclareMéthode, référence éventuelle, note. Statut ⇒ declared.
  2. Vous vérifiezConfirmez la réception réelle des fonds.
  3. Vous validez ou rejetezConfirmer ⇒ paid, commission prélevée, reçu généré, fonds crédité du net. Rejeter ⇒ retour à pending/overdue. Chaque action est journalisée (audit) avec votre identité.
🛑Validation humaine obligatoire

Un paiement déclaré ne crédite jamais le fonds tout seul. Seul un gestionnaire du tenant propriétaire peut le confirmer — c'est votre garde-fou contre les fausses déclarations.

Libérer le décaissement au bénéficiaire

Quand toutes les cotisations d'un tour sont paid (ou waived), le moteur marque le tour complet et prépare le décaissement (Payout) pour le prochain bénéficiaire.

scheduled→ released| failed
  1. Le tour se complèteDécaissement scheduled pour le bénéficiaire désigné.
  2. Vous libérezEnregistrez la méthode et la référence du versement ; le statut passe released et releasedAt est horodaté.
  3. TraçabilitéUne entrée d'audit est écrite : chaque franc entrant (cotisations) → commission (prélevée) → sortant (décaissement) est traçable.

Animer la communauté des participants

Au-delà de la mécanique financière, une tontine est une communauté. Sikaflow vous aide à l'animer :

📢 Annonces

Publiez des messages à tout un groupe : rappels, changements de règles, félicitations au bénéficiaire du tour.

📅 Événements / réunions

Planifiez les rencontres de la tontine ; les participants les voient dans leur espace.

📣 Broadcasts

Envoyez un message ciblé (email/SMS) — par exemple à tous les retardataires d'un tour.

Lire ma facturation

Chaque mois, RMS vous adresse une facture (INVOICE#<yyyy-mm>) en deux lignes :

Le PDF de la facture est disponible dans votre espace dès que RMS la passe en issued. Statuts : draft → issued → paid / overdue.