Guides d'installation, configuration et utilisation de nos plugins WordPress.
Choisissez le plugin dont vous souhaitez consulter la documentation
Guide complet du système de paiement préalable sécurisé pour Listeo
Le plugin Prepaid Booking for Listeo modifie le flux de réservation standard de Listeo pour garantir le paiement AVANT la création de la réservation.
Pas de paiement = pas de réservation. Fini les créneaux bloqués sans paiement !
Le client reste sur la même page. Pas de redirection vers le checkout WooCommerce.
Les commissions sont calculées et enregistrées automatiquement dans le wallet.
Fonctionne avec tous les autres plugins Listeo (Paiement Différé, Rejet & Refund...)
Le client sélectionne le créneau souhaité sur le listing et clique sur "Réserver".
Le client voit le récapitulatif + le formulaire de carte Stripe moderne. Il entre ses informations de carte.
Le paiement est traité par Stripe. En cas d'erreur, un message clair s'affiche en français.
Si le paiement est accepté : Commande WooCommerce + Réservation Listeo + Commission = créés automatiquement.
Le client est redirigé vers la page de confirmation. Emails envoyés au client et au vendeur.
Quand le plugin Deferred Payment for Listeo est activé :
Quand le plugin Deferred Payment for Listeo n'est PAS activé :
100% compatible ! Le plugin Rejet & Refund peut :
Le plugin traduit automatiquement 40+ codes d'erreur Stripe en messages clairs et actionnables en français.
❌ Votre carte a été refusée. Veuillez utiliser une autre carte.
💳 Fonds insuffisants. Veuillez utiliser une autre carte.
📅 Votre carte a expiré. Veuillez utiliser une carte valide.
🔒 Le code CVC est incorrect. Vérifiez les 3 chiffres.
+ 36 autres codes d'erreur traduits (do_not_honor, fraudulent, authentication_required, etc.)
Vérifiez que :
1. Le plugin est activé dans les paramètres
2. WooCommerce Stripe Gateway est activé et configuré
3. La réservation a un prix > 0 (les réservations gratuites n'affichent pas le formulaire)
Vérifiez que la commande est en statut "Terminée" (completed). Les commandes en statut "En cours" n'apparaissent pas. Le plugin marque automatiquement les nouvelles commandes comme "Terminées".
Si le plugin Paiement Différé est activé, l'argent est transféré APRÈS la fin de la réservation + le délai configuré. Vérifiez le tableau de bord du plugin Paiement Différé pour voir les transferts en attente.
Le vendeur doit connecter son compte Stripe via la page de profil. Allez dans User Panel → Profil et cliquez sur "Connecter avec Stripe".
Pour les réservations non instantanées (qui nécessitent l'acceptation du vendeur), le plugin peut maintenant effectuer une pré-autorisation au lieu d'un paiement direct, compatible avec Stripe et PayPal. Le client n'est débité que lorsque le vendeur accepte la réservation.
La pré-autorisation nécessite:
Stripe limite les pré-autorisations à 7 jours. Au-delà, la pré-autorisation est automatiquement libérée. C'est pourquoi le système configure automatiquement un délai maximum de 5 jours pour l'acceptation des réservations avec pré-autorisation (marge de sécurité).
La pré-autorisation est maintenant également disponible pour PayPal ! Fonctionnement identique à Stripe avec une limite de 29 jours au lieu de 7 jours.
Bien que PayPal autorise jusqu'à 29 jours de pré-autorisation, nous recommandons de conserver le même délai de 5 jours que Stripe pour assurer une expérience utilisateur cohérente entre les deux méthodes de paiement. Cela évite également les problèmes liés aux autorisations de longue durée.
Quand une réservation a une pré-autorisation (Stripe ou PayPal), un badge spécial s'affiche:
Ces badges indiquent au vendeur et au client que le montant est bloqué mais pas encore débité, avec la méthode de paiement utilisée.
Avec le plugin Subscription for Listeo, vous pouvez transformer vos forfaits vendeurs en abonnements mensuels ou annuels récurrents. Le paiement est géré directement par Stripe Billing, PayPal Subscriptions, WiPay ou 2Checkout, sans WooCommerce Subscriptions !
Paiements récurrents automatiques via Stripe Billing. Mode Direct ou WooCommerce.
Support complet de PayPal Subscriptions. Mode Direct ou WooCommerce.
Abonnements récurrents via WiPay pour les Caraïbes (Trinidad, Jamaïque, Barbade).
Support mondial via 2Checkout (Verifone). Mode Direct ou WooCommerce.
Permet aux vendeurs avec certains forfaits d'accepter le paiement en espèces.
Taux de commission personnalisés par forfait, y compris 0% pour les plans premium.
Revenus récurrents prévisibles. Suivez vos revenus mensuels et annuels.
Gestion automatique des renouvellements, échecs et annulations.
Allez dans Paramètres → Souscriptions Stripe, PayPal, WiPay & 2Checkout pour activer les passerelles d'abonnement. Assurez-vous que le plugin Subscription for Listeo est installé et activé.
Le système d'acompte permet au client de payer un pourcentage du total lors de la réservation (ex: 30%), puis de payer le solde restant plus tard (avant l'arrivée, le jour de l'arrivée, ou immédiatement après acceptation).
Configurez le pourcentage global (ex: 30%) ou laissez chaque vendeur définir son propre pourcentage par annonce.
Le jour de l'arrivée, X jours avant, ou immédiatement après acceptation.
Le client reçoit un email avec un lien de paiement pour régler le solde par carte ou PayPal.
Le vendeur marque le solde comme payé manuellement.
⚠️ Important:
Aucune commission ni payout n'est créé pour les espèces. Le vendeur reçoit l'argent directement du client.
Stripe débite automatiquement la carte du client à la date limite, sans intervention. Fonctionne uniquement avec les paiements Stripe.
Email de rappel envoyé X jours avant la date limite du solde avec le lien de paiement.
| Type de paiement | Commission | Payout vendeur | Wallet |
|---|---|---|---|
| 💳 Acompte (Stripe/PayPal) | ✅ | ✅ | Badge "💰 Acompte" |
| 💳 Solde en ligne | ✅ | ✅ | Badge "✅ Solde" |
| ⚡ Solde auto-charge | ✅ | ✅ | Badge "✅ Solde" |
| 💵 Solde en espèces | ❌ | ❌ | Vendeur reçoit directement |
Une page dédiée dans l'admin WordPress permet de :
Quand l'option "Contrôle via packages de souscription" est activée, le bouton de configuration d'acompte sur la page Mes Annonces n'apparaît que pour les vendeurs dont le package de souscription autorise la personnalisation d'acompte.
💡 Résultat : Les vendeurs avec un package Premium pourront configurer l'acompte sur leurs annonces, tandis que les vendeurs avec un package Basic utiliseront le pourcentage global défini par l'admin.
Les paramètres suivants sont enregistrés au moment de la réservation et ne changent pas si l'admin modifie les paramètres globaux :
En cas d'annulation de la réservation :
WiPay est une passerelle de paiement locale pour les pays des Caraïbes (Trinidad & Tobago, Jamaica, Barbados, etc.). Elle permet aux clients de payer par carte de crédit/débit locale, et aux vendeurs de recevoir des paiements dans leur devise locale (TTD, JMD, BBD, etc.).
Inscrivez-vous sur wipaycaribbean.com et créez un compte marchand.
Dans votre tableau de bord WiPay, récupérez votre Account Number et votre API Key.
Allez dans Paramètres → WiPay et entrez vos clés.
Activez le mode test et utilisez les cartes de test WiPay avant de passer en production.
Customer Pay: Le client paie les frais WiPay.
Merchant Absorb: Le marchand absorbe les frais.
Sélectionnez votre pays: TT (Trinidad), JM (Jamaica), BB (Barbados), etc.
Testez les paiements avec des cartes de test avant de passer en production.
Toutes les transactions sont sécurisées via l'API WiPay avec validation de signature.
| Caractéristique | WiPay | Stripe | PayPal |
|---|---|---|---|
| Région | 🇹🇹 Caraïbes | 🌍 Mondial | 🌍 Mondial |
| Devises locales | TTD, JMD, BBD | USD, EUR | USD, EUR |
| Pré-autorisation | ❌ | ✅ 7 jours | ✅ 29 jours |
| Paiement solde acompte | ✅ | ✅ | ✅ |
| Auto-charge | ❌ | ✅ | ❌ |
Les clients paient en TTD, JMD, etc. sans frais de conversion.
Accepte les cartes de débit/crédit locales qui ne fonctionnent pas sur Stripe.
Les fonds sont transférés directement vers les banques locales caribéennes.
2Checkout (Verifone) est une plateforme de paiement internationale qui permet d'accepter les paiements par carte dans plus de 200 pays. Idéal pour les marchés où Stripe n'est pas disponible.
Acceptez les paiements dans plus de 200 pays et territoires.
Supportez 45+ devises avec conversion automatique.
Certifié PCI DSS Level 1 pour la sécurité des transactions.
Remboursements automatiques via l'API REST 2Checkout.
Configurez les clés API directement dans le plugin.
Utilisez les clés du plugin WooCommerce 2Checkout Gateway.
Réservations instantanées et non-instantanées.
Dépôt + paiement du solde via lien.
Remboursements automatiques lors d'annulations.
Permettez aux vendeurs de configurer plusieurs méthodes de payout simultanément. Le système transfère automatiquement les gains selon la méthode de paiement utilisée par le client.
→ Transfert automatique via Stripe Connect vers le compte du vendeur
→ Payout automatique PayPal vers l'email du vendeur
→ Virement bancaire manuel via Admin Payouts
Dans le Wallet, les vendeurs voient une nouvelle section Multi-Payout qui leur permet de :
| Client paie avec | Vendeur configuré | Action payout |
|---|---|---|
| 💳 Stripe | ✅ Stripe Connect | Transfert automatique |
| 💳 Stripe | ❌ Pas de Connect | Commission unpaid → Manuel |
| 🅿️ PayPal | ✅ Email PayPal | Payout auto (si activé) |
| 🇹🇹 WiPay | - | Commission unpaid → Manuel |
| 🔐 2Checkout | - | Commission unpaid → Manuel |
| 💵 Cash | - | Commission unpaid → Manuel |
Le bouton standard "Make Payout" de Listeo est remplacé par un système intelligent qui affiche toutes les informations du vendeur et permet de choisir la méthode de payout appropriée.
Nom, email, montant total à payer, nombre de commissions en attente
Stripe Connect (ID compte), PayPal (adresse email), Virement bancaire (IBAN, BIC, etc.)
Tableau détaillé de toutes les commissions à payer avec numéro de commande, date, montant
Si le vendeur a configuré son email PayPal
Si le vendeur a configuré ses coordonnées bancaires
Cette fonctionnalité permet aux vendeurs de configurer leurs propres clés API de paiement (Stripe, PayPal, WiPay, 2Checkout). Les paiements sont alors traités directement sur le compte du vendeur, sans commission ni transfert.
Active "Enable Multi-Payout" dans les paramètres LPP
Coche "Allow custom gateways" dans le package vendeur
Le vendeur configure ses clés API dans "Mes Paiements"
Les clients paient directement le vendeur
Clés Publishable + Secret
Client ID + Secret
Numéro de Compte + Clé API
ID Vendeur + Clé Secrète
Si un paiement initial est fait via passerelle vendeur, le paiement du solde utilisera automatiquement les mêmes clés API. La page de paiement du solde affichera uniquement les méthodes configurées par le vendeur.
Le plugin Prepaid Booking for Listeo est entièrement traduisible et compatible avec Loco Translate pour faciliter la gestion des traductions.
Langue source du plugin
1930 chaînes traduites
Installez le plugin gratuit "Loco Translate" depuis Extensions → Ajouter.
Allez dans Loco Translate → Plugins → Prepaid Booking for Listeo.
Cliquez sur "New language" et sélectionnez votre langue (ex: Español, Deutsch, Português).
Utilisez l'éditeur Loco pour traduire les chaînes. Vous pouvez utiliser la traduction automatique puis affiner manuellement.
Sauvegardez la traduction. La nouvelle langue apparaîtra automatiquement dans les paramètres du plugin.
languages/ ├── listeo-paiement-prealable.pot ← Template (source pour nouvelles traductions) ├── listeo-paiement-prealable-fr_FR.po ← Français (fichier éditable) ├── listeo-paiement-prealable-fr_FR.mo ← Français (compilé) ├── listeo-paiement-prealable-en_US.po ← Anglais (fichier éditable) └── listeo-paiement-prealable-en_US.mo ← Anglais (compilé)
Le plugin recherche les traductions dans l'ordre suivant :
Les nouvelles langues créées avec Loco Translate sont automatiquement détectées et apparaissent dans le sélecteur de langue des paramètres du plugin. Aucune configuration supplémentaire n'est nécessaire.
La traduction anglaise est complète et bien traduite. Si vous créez une nouvelle traduction, vous pouvez copier les fichiers en_US.po/mo comme point de départ et les adapter à votre langue.
Notre équipe est disponible pour vous accompagner.