Documentation
Guide complet EduBoost - Particuliers et entreprises
Pour les particuliers
Acheter un ticket
Participer à la tombola EduBoost est simple. Chaque ticket donne droit à une participation au tirage au sort. Le prix est de 1 FCFA par ticket.
- 1Rendez-vous sur www.eduboost.tg et cliquez sur Particulier
- 2Saisissez votre numéro Togocom (préfixes 70-73, 78-79, 90-93) et la quantité souhaitée
- 3Sélectionnez MIXX by YAS comme méthode de paiement
- 4Confirmez le paiement via la notification USSD sur votre téléphone
- 5Vos codes tickets sont générés et envoyés par SMS
- 1Sélectionnez Crédit YAS comme méthode de paiement
- 2Un code OTP est envoyé sur votre numéro pour confirmer qu'il vous appartient
- 3Saisissez le code OTP reçu par SMS
- 4Le montant est débité de votre crédit et vos tickets sont envoyés par SMS
La vérification OTP est obligatoire car le crédit est débité directement du numéro.
Consulter mes tickets
Retrouvez tous vos tickets de tombola, quelle que soit la méthode d'achat ou le canal utilisé.
- 1Rendez-vous sur www.eduboost.tg/mes-tickets
- 2Saisissez votre numéro de téléphone (8 chiffres)
- 3Recevez un code OTP par SMS et confirmez votre identité
- 4Tous vos tickets (web, SMS, USSD, cadeaux reçus) sont affichés
Pour les entreprises
Acheter un pack de tickets à offrir
Achetez des tickets en gros pour les distribuer à vos employés, clients ou partenaires. Après paiement, vos tickets sont imprimés et livrés physiquement à votre adresse.
MIXX by YAS
Mobile Money Togocom
Credit YAS
Airtime Togocom
Bon chèque
Code EDB-CHQ-XXXXXX
- 1Créez votre compte entreprise sur www.eduboost.tg
- 2Depuis le Tableau de bord, choisissez la quantité et la méthode de paiement
- 3Confirmez le paiement - vos tickets sont générés et un PDF est envoyé par email/SMS
- 4Les tickets imprimés sont livrés physiquement à votre adresse (48-72h)
Distribuer vos tickets
Après achat, plusieurs canaux de distribution sont disponibles depuis votre espace entreprise.
Partager par lien individuel
Générez un lien unique par ticket. Le bénéficiaire clique, saisit son numéro et reçoit le ticket directement sur son téléphone.
- • Idéal pour une distribution nominative (email, WhatsApp, SMS)
- • Le bénéficiaire peut être suivi dans la section Enrollements
- • Liens partageables depuis la page commande → onglet Restant
Demander une impression physique
Faites imprimer vos tickets sous forme de bons physiques livrés à votre adresse (48-72h).
- • Idéal pour les événements, salons, distributions en boutique
- • Les tickets sont déduits de votre stock à la demande d'impression
- • Accessible depuis Demander impression dans votre espace
QR code mutualisé
Un QR code unique partagé entre plusieurs entreprises. Chaque scan attribue un ticket à l'entreprise suivante en rotation (round-robin).
- • Idéal pour des événements communs (foires, conférences)
- • Chaque entreprise définit son quota de tickets
- • Affichage grand public : le QR peut être imprimé sur une affiche
- • Accessible depuis QR mutualisé dans votre espace
Intégrer dans votre système via API
Émettez des tickets directement depuis votre backend via l'API partenaire EduBoost.
- • Idéal pour une distribution automatisée (site e-commerce, CRM, ERP)
- • Nécessite une clé API secrète à ne jamais exposer côté client
- • Voir le guide d'intégration complet
Suivre les enrollements
Un enrollement = un bénéficiaire qui a activé son ticket (saisi son numéro de téléphone). Vous pouvez consulter tous les enrollements depuis votre espace entreprise.
- Filtrer par canal (lien partagé, QR, API serveur)
- Rechercher par numéro de téléphone
- Voir le code ticket attribué à chaque bénéficiaire
- Accéder depuis Les enrollements dans votre espace
Intégrer l'API partenaire
L'API partenaire permet d'émettre des tickets EduBoost directement depuis votre backend. Chaque appel consomme 1 ticket de votre quota et l'attribue au numéro bénéficiaire. Ne jamais appeler depuis le navigateur ou une app mobile - votre clé API serait exposée.
Prérequis
- Compte entreprise certifié sur www.eduboost.tg
- Pack de tickets acheté avec un stock disponible
- Clé API générée depuis Espace entreprise → API serveur
- Quota alloué (déduit de votre stock à l'activation de la clé)
Émettre un ticket
https://api.eduboost.tg/gift/partner/v2/tickets/issueHeaders
Content-Type: application/json
Body (JSON)
"phone": "90123456", // numéro bénéficiaire (8 chiffres, Togocom)
"ref_id": "votre-ref-unique-123" // idempotence (optionnel)
}
Réponse 200 OK
"ticket_code": "12004271",
"phone": "90123456",
"sms_sent": true, // SMS envoyé au bénéficiaire
"remaining_quota": 149
}
Codes d'erreur
| HTTP | Code | Signification |
|---|---|---|
| 401 | UNAUTHORIZED | Clé API invalide ou manquante |
| 400 | INVALID_PHONE | Numéro invalide (doit être Togocom) |
| 429 | QUOTA_EXCEEDED | Quota épuisé - rechargez votre stock |
| 409 | DUPLICATE_REF | ref_id déjà utilisé (idempotence) |
| 503 | SERVICE_UNAVAILABLE | Service temporairement indisponible |
Exemples de code
curl -X POST https://api.eduboost.tg/gift/partner/v2/tickets/issue \ -H "X-Api-Key: votre_cle_api_secrete" \ -H "Content-Type: application/json" \ -d '{ "phone": "90123456", "ref_id": "commande-42" '}
Bonnes pratiques de sécurité
- Ne jamais inclure la clé API dans le code frontend (React, Vue, mobile)
- Ne jamais committer la clé dans un dépôt Git public
- Stocker la clé dans une variable d'environnement serveur
- Restreindre les IPs autorisées dans votre espace (section IPs autorisées)
- Utiliser
ref_idpour l'idempotence (éviter les doublons en cas de retry)