Ticket WiFi Zone Documentation d implementation complete
Documentation Officielle

Propulsez votre WiFi Zone avec le paiement mobile

Ticket WiFi Zone transforme votre connexion internet en une source de revenus automatique. Monétisez votre hotspot en quelques minutes grâce aux paiements Mobile Money (Orange, MTN, Moov, Wave, etc.) et offrez une expérience fluide à vos clients.

Le concept
Paiement Mobile sans Internet Le client achète son ticket même s'il n'a plus de forfait, grâce à une autorisation spéciale sur votre routeur (Walled Garden).
Automatisation
Livraison instantanée Dès que le paiement est validé, le client reçoit son code WiFi directement sur son écran. Plus besoin de vendre des tickets papier à la main !
Formation
Tutoriel Vidéo Complet Suivez pas à pas la configuration complète, de l'inscription à la première vente en vidéo.
Etape 1

Créer votre compte Partenaire

L'aventure commence ici. L'inscription est rapide et gratuite. Votre pays de résidence configurera automatiquement votre devise locale et les passerelles de paiement adaptées à votre marché.

1

Inscription sur la plateforme

Rendez-vous sur ticketwifizone.com. Remplissez le formulaire avec votre nom, email et surtout votre numéro Mobile Money (Orange, MTN, etc.) qui servira pour vos futurs retraits de gains.

2

Validation de l'email

Consultez votre boîte aux lettres et cliquez sur le lien de confirmation. Cette étape sécurise votre compte et débloque l'accès à votre tableau de bord personnel.

3

Exploration du tableau de bord

Bienvenue chez vous ! C'est ici que vous suivrez vos revenus en temps réel, gérerez vos zones WiFi et demanderez vos retraits d'argent.

Sécurité Garantie

Vos données et vos revenus sont protégés par nos protocoles de sécurité. Vos gains sont stockés sur votre compte jusqu'à votre demande de retrait.

Configuration Auto

Dès l'inscription, tout est prêt pour votre pays. Pas de réglages complexes, nous nous occupons de la liaison avec les opérateurs mobiles.

Support Dédié

Notre équipe est à votre disposition par WhatsApp et par mail pour vous accompagner dans votre croissance.

Commissions : Ticket WiFi Zone retient une commission de 15% sur chaque ticket vendu pour assurer le fonctionnement et la maintenance du service. Il n'y a aucun autre frais (pas de frais de retrait, pas d'abonnement mensuel, aucun frais caché).

Tutoriel video : regardez la configuration complete sur YouTube pour suivre chaque etape visuellement, de la creation de compte jusqu a la vente du premier ticket.

Etape 2

Déclarer votre Zone WiFi

Une "Zone WiFi" représente un lieu physique (hôtel, restaurant, quartier, boutique). Vous pouvez gérer autant de zones que vous le souhaitez depuis un seul compte.

Paramètres de la Zone
Nom de la Zone
Un nom clair pour vos clients (ex: "WiFi_Gare_Centrale"). Il apparaîtra sur leur interface de paiement.
Contact Support
Votre numéro de téléphone pour que les clients puissent vous appeler s'ils ont une question sur place.
Lien Direct (Optionnel)
L'adresse IP de votre routeur pour permettre une connexion automatique après l'achat.

Outils de Vente Inclus

Pour chaque zone créée, la plateforme génère automatiquement :

  • Un QR Code unique à imprimer et coller sur vos murs.
  • Un Lien de paiement public à partager sur WhatsApp ou Facebook.
  • Un Code d'intégration pour votre portail captif MikroTik.

Bon a savoir : vous pouvez creer plusieurs WiFi Zones depuis le meme compte promoteur — une par hotspot ou par lieu d exploitation. Chaque zone a son propre lien et son propre stock de tickets.

Etape 3

Gérer vos Tarifs et votre Stock

Vous gardez le contrôle total sur vos prix. Les tickets (codes WiFi) sont importés depuis votre routeur vers la plateforme qui se charge de les vendre pour vous.

Flexibilité des Prix

Créez vos propres offres : 100 FCFA pour 1h, 500 FCFA pour la journée, etc. Vous fixez vos marges en toute liberté.

Importation Simple

Exportez vos codes depuis Winbox (format CSV) et importez-les en un clic. La plateforme les distribuera un par un sans jamais faire de doublon.

Suivi des Stocks

Recevez des alertes quand votre stock de tickets est bas pour ne jamais rater une vente.

Format du fichier CSV (Exemple)
Username,Password
zone001,123456
zone002,654321
zone003,985214

Distribution Sécurisée

Notre moteur d'assignation atomique garantit qu'un code WiFi vendu n'est **plus jamais réutilisé**. Même avec 100 ventes simultanées, chaque client reçoit un code unique et valide.

Conseil d exploitation: garder toujours une marge de stock par tarif. La plateforme signale deja les bas niveaux de tickets, mais la meilleure experience client reste d anticiper les reimports CSV avant rupture.

Etape 4

Configuration du Routeur MikroTik

C est l etape technique indispensable. Pour que vos clients puissent payer par Mobile Money sans avoir de forfait internet actif, votre routeur doit autoriser les domaines de Ticket WiFi Zone et des passerelles de paiement.

Important : Vous devez configurer le Walled Garden. Sans cela, le client sera bloqué par le routeur dès qu il tentera d ouvrir la page de paiement.

Le Script Universel Prêt-à-l'emploi

Plutôt que de configurer chaque adresse manuellement, nous avons créé un script automatique qui s occupe de tout. Il suffit de le copier et de le coller dans le terminal de votre routeur.

Ouvrir le Guide et le Script Rapide

Avantages du script :

  • Configuration en moins de 10 secondes
  • Inclus tous les agrégateurs (Orange, MTN, etc.)
  • Mise à jour automatique des domaines
  • Aucun risque d erreur de frappe
Aperçu du Walled Garden (Général)
/ip hotspot walled-garden
add dst-host="*ticketwifizone.com*" comment="twz-auto-wg"
add dst-host="*galaxieteam.com*" comment="twz-auto-wg"
add dst-host="*pawapay.io*" comment="twz-auto-wg"
add dst-host="*fedapay.com*" comment="twz-auto-wg"
add dst-host="*moneroo.io*" comment="twz-auto-wg"
add dst-host="*ligdicash.com*" comment="twz-auto-wg"
add dst-host="*paydunya.com*" comment="twz-auto-wg"
Aperçu du Walled Garden (IP List)
/ip hotspot walled-garden ip
add action=accept dst-host=checkout.moneroo.io comment="twz-auto-wg"
add action=accept dst-host=paydunya.com comment="twz-auto-wg"
Option 1 - Boutons simples
Code d integration standard
Depuis "Mes WiFi", le bouton "Code d integration" fournit un bloc HTML simple avec deux boutons: acheter un ticket et recuperer mon ticket.
Quand l utiliser
Quand votre portail captif existe deja et que vous voulez seulement y inserer les boutons TWZ sans refaire tout le `login.html`.
Option 2 - Portail complet / KYC
Generateur de `login.html`
Le dashboard peut aussi prendre votre `login.html` original et produire une version enrichie, notamment pour la conformite KYC.
Quand l utiliser
Quand vous voulez une integration plus profonde, avec identification utilisateur, OTP et registre legal avant l acces final.

Pourquoi la page mobile existe

Certains agregateurs ne renvoient pas toujours proprement le client vers le portail captif. La plateforme affiche alors une page d attente qui sonde `/api/payment-status/{orderId}` jusqu a confirmation.

Retour marchand retardataire

Le polling peut aussi confirmer le paiement via API meme si le webhook ou le retour navigateur est lent, notamment pour PayDunya, YengaPay et PawaPay.

Recuperation du ticket

Le lien `recuperationView` permet au client de retrouver son ticket par numero de telephone si jamais il ferme la page trop tot.

Etape 5

Pays Disponibles

Ticket WiFi Zone est présent dans de nombreux pays. La plateforme s'adapte automatiquement à la devise et aux méthodes de paiement locales.

Pays Devise Statut
BENIN BENIN
XOF Actif
BURKINA FASO BURKINA FASO
XOF Actif
CAME ROUN CAME ROUN
XAF Actif
CONGO CONGO
XAF Actif
COTE D'IVOIRE COTE D'IVOIRE
XOF Actif
GABON GABON
XAF Actif
GHANA GHANA
GHS Actif
GUINEE CONAKRY GUINEE CONAKRY
GNF Actif
KENYA KENYA
KES Actif
LESOTHO LESOTHO
LSL Actif
MADAGASCAR MADAGASCAR
MGA Bientôt
MALI MALI
XOF Actif
NIGER NIGER
XOF Actif
OUGANDA OUGANDA
UGX Actif
RD CONGO RD CONGO
CDF Actif
RWANDA RWANDA
RWF Actif
SENEGAL SENEGAL
XOF Actif
SIERRA LEONE SIERRA LEONE
SLE Actif
TANZANIE TANZANIE
TZS Actif
TCHAD TCHAD
XAF Bientôt
TOGO TOGO
XOF Actif
ZAMBIE ZAMBIE
ZMW Actif

Votre pays ne figure pas dans la liste ? Contactez notre support technique pour demander une intégration prioritaire.

Tests

Recette terrain (Acceptance Testing)

Une bonne installation doit être testée en conditions réelles. Cette étape permet de valider que tout le tunnel d'achat fonctionne sans accroc pour vos clients.

1

Préparation

Vérifiez que votre compte est actif, que votre WiFi Zone est créée et qu'un stock de tickets est importé.

2

Test Portail

Connectez-vous au hotspot avec un téléphone (données mobiles coupées) et vérifiez que le portail s'affiche automatiquement.

3

Test Paiement

Lancez un achat et vérifiez que la page de paiement Mobile Money s'ouvre. C'est ici que le "Walled Garden" est mis à l'épreuve.

4

Test de Réception

Après le paiement, vérifiez que le client reçoit son ticket en moins de 10 secondes sur son écran.

5

Test Récupération

Vérifiez que le client peut retrouver son ticket en saisissant son numéro de téléphone en cas de fermeture accidentelle de la page.

Définition d'une implémentation complète : un nouveau pays peut être activé, un promoteur peut ouvrir une zone, importer son stock, encaisser un paiement depuis un smartphone non connecté à internet, livrer le ticket et retrouver la vente dans l'historique sans intervention manuelle.

FAQ

Questions Fréquentes (FAQ)

Retrouvez ici les réponses aux questions les plus posées par nos partenaires pour une exploitation sereine.

Pourquoi le paiement ne s'ouvre pas alors que le client est bien sur le hotspot ?

Le routeur n'autorise probablement pas encore tous les domaines nécessaires dans le Walled Garden. Commencer par vérifier `ticketwifizone.com` puis les domaines des agrégateurs utilisés et leurs hosts directs de checkout.

Que se passe-t-il si le client paie mais ne revient pas sur la plateforme ?

Le projet a déjà des mécanismes de secours : webhook, vérification API et page mobile avec polling. Le client peut aussi retrouver son ticket via le lien de récupération par numéro de téléphone.

Peut-on activer plusieurs pays avec des agrégateurs différents ?

Oui. Le comportement est piloté par la table `pays`. Chaque promoteur hérite du flux associé à son pays. Il faut donc documenter pays par pays la devise, l'indicatif, le taux CFA, l'agrégateur et les clés actives.

Ai-je besoin d'internet pour configurer le routeur ?

Oui, pour télécharger le script et importer les tickets. En revanche, une fois configuré, le client peut payer sans forfait mobile personnel grâce aux règles Walled Garden.

Le module VPN est-il requis pour vendre des tickets ?

Non. Le VPN est un module séparé, utile surtout pour l'administration distante des routeurs MikroTik. Il a déjà sa propre documentation complète.

Quelles sont les commissions prélevées par la plateforme ?

La plateforme retient une commission de 15% sur chaque ticket vendu. Il n'y a aucun autre frais : pas de frais de retrait, pas d'abonnement mensuel et aucun frais caché.

Le module de conformité KYC est-il obligatoire ?

Non, c'est un module optionnel. Son activation dépend de la réglementation en vigueur dans chaque pays. Pour l'utiliser, le promoteur doit acheter des crédits OTP pour l'envoi des codes de vérification par SMS. Notez que grâce à la reconnaissance d'appareil, un client récurrent ne consomme aucun crédit supplémentaire lors de ses prochaines connexions.