Guide Revendeurs¶
Qu'est-ce qu'un revendeur Funbooker ?¶
Un revendeur est un partenaire qui vend des cartes cadeaux et des bons d'activité Funbooker directement depuis sa propre plateforme (site web, application, point de vente).
Contrairement à l'affilié qui redirige les visiteurs vers Funbooker, le revendeur finalise la vente sur sa plateforme et appelle l'API pour générer le produit (carte cadeau ou bon).
Pourquoi utiliser l'API plutôt que des codes pré-générés ?¶
Certains partenaires (comme Gladdy) fonctionnent historiquement avec des séries de codes pré-générés : Funbooker fournit un lot de codes à l'avance, et le partenaire les distribue au fil des ventes.
Ce modèle a des limites importantes :
| Codes pré-générés | API Partner (temps réel) | |
|---|---|---|
| Génération | Lot de codes fourni à l'avance | Code généré à chaque vente |
| Expiration | Date fixe pour tout le lot | 1 an à partir de la date d'achat réelle |
| Stock | Risque de rupture ou de surplus | Pas de stock à gérer |
| Annulation | Difficile à tracer | Annulation via API (DELETE) |
| Suivi | Manuel | Automatique via partnerReference |
| Montant | Fixe au moment de la génération | Libre à chaque vente (1 à 300 EUR) |
graph LR
subgraph "Ancien modèle : codes pré-générés"
A1[Funbooker génère N codes] --> A2[Envoi du lot au partenaire]
A2 --> A3[Le partenaire distribue les codes]
A3 --> A4["Date d'expiration fixe pour tous"]
end
subgraph "Nouveau modèle : API temps réel"
B1[Client achète sur le site partenaire] --> B2[Appel API /giftcard/create]
B2 --> B3[Code généré instantanément]
B3 --> B4["Expiration = date d'achat + 1 an"]
end
L'API garantit que chaque client reçoit une date d'expiration correcte, calculée à partir du moment exact de son achat.
Prochaines étapes¶
- Cartes cadeaux — créer et annuler des cartes cadeaux monétaires.
- Bons d'activité — créer des bons liés à une activité spécifique.
- Suivi comptable — réconciliation et organisation des ventes.
- Bonnes pratiques — conseils pour optimiser votre intégration.