Réservation en ligne via WordPress + FedaPay
Configurer le plugin WordPress et le paiement en ligne FedaPay pour les réservations directes.
Teranga PMS fournit un plugin WordPress pour permettre aux clients de réserver et payer directement depuis votre site internet via FedaPay (Mobile Money, carte bancaire, etc.).
Prérequis
- Un site WordPress (v5.0+)
- Un compte FedaPay (app.fedapay.com)
- Une clé API Teranga PMS (demandez au SuperAdmin)
Installation du plugin
- Copiez le dossier
wordpress/teranga-booking/dans votre répertoirewp-content/plugins/ - Dans WordPress : Extensions → Extensions installées → Activer « Teranga Booking »
- Allez dans Réglages → Teranga Booking
Configuration
| Champ | Description |
|---|---|
| URL API Teranga PMS | L’adresse de votre API (ex: https://api.mon-hotel.teranga.app) |
| Clé API Teranga | Fournie par le SuperAdmin (format tpms_...) |
| Clé publique FedaPay | Depuis votre dashboard FedaPay (pk_live_... ou pk_sandbox_...) |
| Clé secrète FedaPay | Depuis votre dashboard FedaPay |
| Environnement | sandbox pour tester, live pour la production |
| Page de confirmation | URL vers laquelle rediriger après paiement (ex: /merci) |
Configurer le webhook FedaPay
- Connectez-vous à app.fedapay.com
- Allez dans Paramètres → Webhooks → Ajouter
- URL :
https://api.votre-hotel.teranga.app/api/webhooks/fedapay - Événement :
transaction.approved - Enregistrez
Ajouter le formulaire à une page
- Créez une page WordPress (ex: « Réserver »)
- Ajoutez le shortcode :
[teranga_booking] - Publiez la page
Parcours client
- Le client visite la page de réservation sur votre site
- Il remplit le formulaire (nom, chambre, dates, email, téléphone)
- Il clique sur Payer et réserver avec FedaPay
- La popup FedaPay s’ouvre : il choisit son moyen de paiement (MTN Mobile Money, Moov Money, carte Visa/Mastercard…)
- Paiement validé → la réservation est automatiquement créée dans Teranga PMS avec une facture marquée Payée
- Le client est redirigé vers la page de confirmation
Vérification côté PMS
- La réservation apparaît dans Réservations avec la source CHANNEL_MANAGER
- La facture est automatiquement générée et marquée Payée
- Le paiement est enregistré avec la méthode FEDAPAY et la référence de transaction
Intégration avec BA Book Everything (existant)
Si votre site utilise déjà le plugin BA Book Everything avec FedaPay, utilisez le plugin Teranga BA Sync à la place du formulaire standalone :
- Installez le plugin
teranga-ba-syncdans WordPress - Allez dans Réglages → Teranga BA Sync
- Configurez l’URL API et la clé API Teranga
- Mapping des chambres : associez chaque ID d’objet BA Book Everything au numéro de chambre dans Teranga PMS
- Trouvez les IDs dans BA Book Everything → All Items (colonne ID)
- Exemple :
{"23": "101", "45": "102", "67": "201"}
- Choisissez le moment de synchronisation :
- Paiement reçu (recommandé) : dès que FedaPay confirme le paiement
- Commande complétée : après toutes les étapes de validation
Le plugin fonctionne automatiquement : chaque réservation payée sur BA Book Everything est envoyée à Teranga PMS avec la facture et le paiement déjà enregistrés. Les annulations sont aussi propagées.
L’historique des synchronisations est visible dans la page de configuration du plugin.