📚 Documentation

Documentation

Guides d'installation, configuration et utilisation de nos plugins WordPress.

← Tous les plugins
💳

Paiement Différé for Listeo

Version 2.0.0

Documentation - Guide complet

Tout ce que vous devez savoir sur le système de paiement différé avec Stripe Connect

1

À quoi sert ce plugin ?

Le plugin Deferred Payment for Listeo résout un problème crucial pour les plateformes de réservation :

❌ Le problème par défaut

Par défaut, Listeo transfère IMMÉDIATEMENT les fonds au vendeur dès qu'un paiement est effectué. Cela signifie :

  • L'argent quitte votre compte Stripe immédiatement
  • Il est impossible de rembourser un client si besoin
  • Le vendeur reçoit l'argent AVANT même que la réservation commence
  • Aucune protection contre les annulations ou litiges

✅ La solution avec ce plugin

Le plugin intercepte le processus de paiement et retient les fonds jusqu'à ce que la réservation soit terminée + un délai configurable :

  • L'argent reste sur VOTRE compte Stripe admin
  • Vous pouvez rembourser un client à tout moment
  • Le vendeur reçoit l'argent APRÈS la fin de la réservation + délai
  • Protection complète contre les fraudes et litiges

🎯 Cas d'usage parfaits

🏠

Location de biens

Appartements, maisons, villas - Le vendeur reçoit l'argent après la fin du séjour

🎉

Réservation d'événements

Mariages, séminaires, fêtes - Paiement après l'événement

🚗

Location de véhicules

Voitures, bateaux, motos - Protection contre les dommages

📅

Services sur rendez-vous

Coiffeurs, médecins, coachs - Paiement après prestation

2

Comment ça fonctionne ?

Le système fonctionne en 4 étapes automatiques :

1

💳 Client effectue un paiement

Le client réserve un listing et paie via Stripe. Le webhook Stripe notifie votre site.

Action du plugin : Intercepte le webhook AVANT Listeo Core (priorité 1 vs 9)

2

🛡️ Blocage du transfert immédiat

Le plugin marque la commande avec listeo_pending_transfer = yes et empêche Listeo Core de transférer les fonds.

Résultat : L'argent reste sur VOTRE compte Stripe admin

3

⏰ Attente de la fin de réservation + délai

Le plugin surveille la commande. Il attend que :

  • Date de fin de la réservation soit passée
  • Délai configuré (0-90 jours) soit écoulé

Exemple : Réservation du 15 au 17 déc + délai 2 jours = Transfert le 19 déc

4

💸 Transfert automatique au vendeur

Une fois les conditions remplies, le cron automatique (toutes les X heures) effectue le transfert Stripe vers le compte du vendeur.

Calcul : Montant total - Commission plateforme = Montant vendeur

📊 Schéma du flux de paiement

👤 Client
Paie 360€
→
🏦 Admin
Reçoit 360€
⏰
⏳ Attente
Fin + délai
→
🏪 Vendeur
Reçoit 280€ (-22%)
3

Configuration initiale

Suivez ces étapes pour configurer le plugin correctement :

1 🔑 Activer votre licence

Sans licence valide, le plugin ne peut pas fonctionner.

  1. Allez dans Deferred Payment → Licence
  2. Entrez votre clé de licence (format: LIS-P-XXXX-XXXX-XXXX)
  3. Cliquez sur "Activer la licence"
  4. Vérifiez que le statut affiche "✅ Licence active"

⚠️ Important : Si vous n'avez pas de licence, le plugin sera automatiquement désactivé.

2 💳 Configurer Stripe Connect dans Listeo

Le plugin nécessite que Stripe Connect soit correctement configuré.

  1. Allez dans Listeo Core → Paramètres → Stripe Connect
  2. Activez Stripe Connect : Activate Stripe Connect = Activate
  3. Choisissez le mode : Test (pour tester) ou Live (production)
  4. Remplissez les 3 clés Stripe selon le mode :
    • Client ID - Depuis Stripe Dashboard → Connect → Settings
    • Secret Key - Depuis Stripe Dashboard → Developers → API Keys
    • Webhook Secret - Depuis Stripe Dashboard → Developers → Webhooks
  5. Cliquez sur "Save Changes"

💡 Astuce : Testez toujours en mode TEST avant de passer en LIVE !

3 ⚙️ Configurer les paramètres

Définissez comment et quand les transferts seront effectués.

  1. Allez dans Deferred Payment → Paramètres
  2. Activer le paiement différé : Cochez la case
  3. Délai de paiement : Choisissez 0-90 jours après la fin de réservation
  4. Intervalle du cron : Toutes les X heures (recommandé: 12h)
  5. Cliquez sur "Enregistrer les modifications"

✅ Vérification de la configuration

Retournez sur Deferred Payment → Tableau de bord et vérifiez que :

  • Licence : ✅ Valide (Lifetime/Pro)
  • Plugin activé : ✅ Oui
  • Listeo Core : ✅ OK
  • WooCommerce : ✅ OK
  • Stripe Connect : ✅ Configuré
  • Prochaine exécution : Date/heure affichée
4

Paramètres disponibles

Découvrez tous les paramètres configurables du plugin :

✅ Activer le paiement différé

Type : Case à cocher (Oui/Non)

Description : Active ou désactive le système de paiement différé. Quand désactivé, Listeo fonctionne normalement (transfert immédiat).

⚠️ Note : Ne peut être activé que si la licence est valide et toutes les dépendances sont OK.

⏰ Délai de paiement (jours)

Type : Nombre entier (0 à 90 jours)

Description : Nombre de jours à attendre APRÈS la fin de la réservation avant de transférer les fonds au vendeur.

💡 Exemples :

  • 0 jour : Transfert le jour même de la fin de réservation
  • 2 jours : Transfert 2 jours après la fin
  • 7 jours : Protection d'une semaine pour gérer les litiges

🕐 Intervalle du cron (heures)

Type : Nombre entier (minimum 1 heure)

Description : Fréquence à laquelle le système vérifie et traite les paiements en attente.

⚙️ Recommandations :

  • 12 heures : Équilibre parfait (2 fois par jour)
  • 6 heures : Plus fréquent pour beaucoup de réservations
  • 24 heures : Si peu de réservations

🌍 Langue de l'interface

Type : Sélection (Français / English / Auto)

Description : Choisissez la langue d'affichage du plugin (indépendant de la langue WordPress).

5

Utilisation quotidienne

Comment utiliser le plugin au quotidien :

📊 Tableau de bord

Le tableau de bord est votre centre de contrôle principal. Vous y trouverez :

  • Statistiques globales - Nombre de commandes en attente, montant total bloqué
  • État du système - Licence, activation, dépendances
  • Liste des commandes en attente - Avec date de transfert prévue
  • Derniers transferts - Historique récent

👀 Surveiller les paiements en attente

Dans la section "Commandes en attente de transfert", chaque ligne affiche :

🔵 En cours

Réservation en cours, transfert après la fin + délai

🟡 Délai

Réservation terminée, en attente du délai

🟢 Prêt

Prêt pour transfert, traitement au prochain cron

🟣 Transféré

Transfert effectué avec succès

▶️ Exécuter les transferts manuellement

Vous n'avez pas besoin d'attendre le cron automatique. Vous pouvez lancer l'exécution manuellement :

  1. Allez sur le Tableau de bord
  2. Cliquez sur le bouton vert "▶️ Exécuter maintenant"
  3. Le système traite TOUTES les commandes prêtes
  4. Un popup affiche les statistiques de traitement

💡 Astuce : Vous pouvez aussi exécuter le transfert d'une seule commande en cliquant sur l'icône ▶️ à côté de chaque ligne.

📜 Consulter l'historique

Accédez à Deferred Payment → Historique pour voir :

  • Tous les transferts effectués
  • Les tentatives échouées avec message d'erreur
  • Les logs système (info, warnings)
  • Les IDs de transfert Stripe pour vérification

Vous pouvez supprimer les logs inutiles (info) ou tous les logs si besoin.

6

Notifications par email

Le plugin peut envoyer automatiquement des notifications par email aux vendeurs lors des transferts de paiement.

📧 Fonctionnalités des emails

  • Email de succès : Envoyé au vendeur quand son paiement est transféré
  • Email d'échec : Envoyé au vendeur ET à l'admin en cas de problème
  • Template professionnel : Design moderne utilisant les paramètres WooCommerce
  • Prévisualisation : Visualisez les emails avant envoi
  • Email de test : Testez l'envoi avant mise en production

⚙️ Configuration des emails

Accédez à Deferred Payment → Emails pour configurer :

  1. Activer les notifications : Active/désactive l'envoi des emails
  2. Alerter l'admin en cas d'échec : L'administrateur reçoit une copie si un transfert échoue
  3. Sujet - Paiement réussi : Personnalisez le sujet de l'email de succès
  4. Sujet - Échec du transfert : Personnalisez le sujet de l'email d'échec

🔤 Variables disponibles dans les sujets

Utilisez ces variables pour personnaliser dynamiquement les sujets des emails :

{booking_id}

Numéro de réservation

{order_id}

Numéro de commande

{vendor_name}

Nom du vendeur

{listing_name}

Nom de l'annonce

{amount}

Montant total

{date}

Date du jour

💡 Exemple : 💰 Paiement reçu pour votre réservation #{booking_id}

🔗 Intégration avec WooCommerce

Les emails utilisent automatiquement les paramètres de WooCommerce :

  • Nom de l'expéditeur - Depuis WooCommerce → Paramètres → Emails
  • Adresse email - L'adresse "De" des emails WooCommerce
  • Logo - L'image d'en-tête configurée dans WooCommerce
  • Pied de page - Le texte de pied de page WooCommerce
  • Couleurs - Les couleurs du thème email WooCommerce

⚙️ Pour modifier ces paramètres : Allez dans WooCommerce → Paramètres → Emails

📝 Contenu des emails

Les emails contiennent automatiquement :

✅ Email de succès

  • Salutation personnalisée
  • Montant net reçu
  • Détails de la réservation
  • Détails financiers
  • Commission plateforme
  • Référence du transfert Stripe
  • Bouton vers le tableau de bord

❌ Email d'échec

  • Salutation personnalisée
  • Message d'erreur détaillé
  • Détails de la réservation
  • Détails financiers
  • Information que l'équipe est informée
  • Copie envoyée à l'administrateur

🧪 Tester les emails

Avant de mettre en production, testez vos emails :

  1. Allez dans Deferred Payment → Emails
  2. Cliquez sur "📤 Envoyer un test"
  3. Entrez votre adresse email
  4. Choisissez le type (Succès ou Échec)
  5. Cliquez sur "Envoyer" et vérifiez votre boîte mail
7

Blocage Stripe (nouveaux comptes)

🔒 Qu'est-ce que le blocage Stripe ?

Pour les nouveaux comptes Stripe, Stripe bloque automatiquement les fonds pendant une période (généralement 7 jours) avant de les rendre disponibles pour transfert. Ce délai diminue au fil du temps quand le compte reçoit plus de paiements et devient "établi".

⚙️ Comment le plugin gère ce blocage ?

Le plugin récupère automatiquement la vraie date de disponibilité des fonds depuis l'API Stripe (champ available_on). Aucune configuration n'est nécessaire de votre part.

  • Quand un paiement est reçu, le plugin interroge Stripe pour connaître la date de déblocage
  • Cette date est stockée et affichée au vendeur dans son wallet
  • Le transfert est automatiquement reporté si les fonds sont encore bloqués

📅 Exemple concret

Situation : Réservation du 28 au 30 décembre, délai de paiement configuré : 2 jours

Date Statut affiché au vendeur Explication
28-30 déc 📅 Réservation en cours La réservation est en cours
31 déc - 1 jan ⏳ Délai en cours Réservation terminée, délai de 2 jours en cours
2 jan 🔒 Fonds bloqués par Stripe Délai écoulé, mais Stripe bloque encore les fonds (nouveau compte)
5 jan ✅ Transféré Fonds débloqués par Stripe → transfert automatique

👁️ Ce que voit le vendeur dans son wallet

Quand les fonds sont bloqués par Stripe, le vendeur voit :

🔒 Fonds bloqués par Stripe
🔓 Disponible le : 5 janvier 2025 14:30
💡 Stripe bloque temporairement les fonds (politique nouveaux comptes). Le transfert sera effectué automatiquement dès que les fonds seront disponibles.

✅ Points importants

  • Automatique : Aucune action requise de l'admin, tout est géré automatiquement
  • Transparent : Le vendeur voit exactement quand ses fonds seront disponibles
  • Évolutif : Le délai de blocage Stripe diminue quand le compte devient "établi"
  • Pas de configuration : Le plugin récupère la vraie date depuis Stripe
8

FAQ - Questions fréquentes

❓ Que se passe-t-il si j'annule ma licence ?

Si votre licence est annulée ou expire :

  • Le plugin se désactive automatiquement
  • Les commandes en attente restent bloquées (pas de transfert)
  • Listeo Core reprend le contrôle et transfère immédiatement les NOUVEAUX paiements
  • Vous devez réactiver une licence pour débloquer les transferts en attente

❓ Puis-je rembourser un client manuellement ?

Oui ! C'est justement l'avantage de ce plugin. Tant que l'argent n'est pas transféré au vendeur, vous pouvez :

  • Aller dans WooCommerce → Commandes
  • Ouvrir la commande concernée
  • Cliquer sur "Rembourser"
  • Le remboursement se fait sur VOTRE compte Stripe (car l'argent n'a pas été transféré)

❓ Le cron ne s'exécute pas, que faire ?

Vérifiez d'abord le tableau de bord :

  1. La licence est-elle valide ?
  2. Le plugin est-il activé dans les paramètres ?
  3. Stripe Connect est-il configuré ?

Si tout est OK, vous pouvez exécuter manuellement en cliquant sur "Exécuter maintenant" ou demander à votre hébergeur de vérifier que le cron WordPress fonctionne.

❓ Puis-je utiliser ce plugin avec un autre thème que Listeo ?

Non. Ce plugin est spécifiquement conçu pour le thème Listeo et son système Stripe Connect. Il nécessite :

  • Listeo Core (plugin obligatoire)
  • WooCommerce
  • Stripe Connect configuré dans Listeo

❓ Une erreur s'est produite lors d'un transfert, que faire ?

Consultez l'Historique pour voir le message d'erreur exact. Les erreurs courantes :

  • Vendeur non connecté à Stripe - Le vendeur doit d'abord connecter son compte Stripe depuis son profil
  • Clés Stripe invalides - Vérifiez les clés dans Listeo → Paramètres → Stripe Connect
  • Montant insuffisant - La commission est égale ou supérieure au montant total

🔗 Le plugin fonctionne-t-il avec Listeo Politique Annulation ?

Oui ! Le plugin est entièrement compatible avec Listeo Politique Annulation. Le système ajuste automatiquement le montant du transfert en fonction des remboursements effectués.

📊 Exemple de calcul avec remboursement partiel :

Montant payé par le client 100 €
Annulation avec remboursement 50% -50 €
Montant net restant 50 €
Commission plateforme (10%) -5 €
Le vendeur reçoit 45 €

⚠️ Important : Si la commande est entièrement remboursée (100%), le transfert au vendeur est automatiquement annulé et aucun montant ne lui sera versé.

💡 Note : La commission de la plateforme est toujours calculée sur le montant NET (après remboursement), jamais sur le montant brut initial.

📄 Comment télécharger les factures de commission ?

Pour télécharger les factures de commission (PDF), vous devez installer et activer le plugin Listeo Invoice & TVA.

📋 Étapes pour activer les factures de commission :

  1. Installez et activez Listeo Invoice & TVA
  2. Activez votre licence Invoice & TVA
  3. Allez dans Listeo Invoice → Paramètres
  4. Activez l'option "Factures de commission"
  5. Les boutons de téléchargement 📄 apparaîtront dans le tableau des commissions

📝 Contenu de la facture de commission :
Montant de la réservation, taux de commission, montant HT/TTC, TVA, informations du vendeur.

🛒 Obtenir Listeo Invoice & TVA

🔒 Le plugin fonctionne-t-il avec la pré-autorisation Stripe ?

Oui ! Le plugin est entièrement compatible avec la fonctionnalité de pré-autorisation de Prepaid Booking for Listeo.

🔄 Flux avec pré-autorisation:

  1. Client réserve → Pré-autorisation créée (montant bloqué, pas débité)
  2. Vendeur accepte → Paiement capturé (client débité)
  3. Commande marquée listeo_pending_transfer = yes
  4. Fin de réservation + délai → Transfert au vendeur

✅ Avantage: Si le vendeur refuse la réservation, la pré-autorisation est simplement libérée. Aucun remboursement Stripe nécessaire, donc aucun frais !

💡 Note: La pré-autorisation nécessite Prepaid Booking for Listeo et Listeo Rejet Refund pour fonctionner.

❓ Combien coûte ce plugin ?

Le plugin nécessite une licence Premium. Consultez la page Deferred Payment → Acheter pour voir les offres disponibles :

  • Pro - Pour 1 site
  • Lifetime - Licence à vie
  • Agency - Jusqu'à 5 sites
💬

Besoin d'aide ?

Notre équipe de support est là pour vous aider ! N'hésitez pas à nous contacter si vous avez besoin d'assistance ou si quelque chose n'est pas clair dans cette documentation.

📧 Contacter le support

Besoin d'aide supplémentaire ?

Notre équipe est disponible pour vous accompagner.