📚 Documentation

Documentation

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

← Tous les plugins
❌

Rejet & Refund for Listeo

Version 1.3.1

Documentation - Guide complet

Tout ce que vous devez savoir sur le système de rejet et remboursement automatique

1

Qu'est-ce que le système Rejet Refund ?

Reject Refund for Listeo est un système automatique qui protège les clients en remboursant intégralement les réservations payées mais en attente d'acceptation du vendeur.

❌

Rejet manuel

Le vendeur peut rejeter la réservation avec remboursement 100%

⏰

Expiration par délai

Si le vendeur ne répond pas dans le délai configuré

📅

Expiration par date

Si la date de début de réservation arrive

Scénario typique

  1. Client paie une réservation: Sans instant booking, la réservation passe en statut "waiting"
  2. Vendeur doit répondre: Il peut accepter ou rejeter la réservation
  3. Si rejeté: Client remboursé 100% automatiquement via Stripe
  4. Si pas de réponse: Rejet automatique après le délai OU à la date de début

🛡️ Protection du client

Ce système garantit que :

  • ✅ Le client ne perd jamais son argent si le vendeur refuse
  • ✅ Le client est remboursé 100% (pas de frais)
  • ✅ Le remboursement est automatique et immédiat
  • ✅ Une réservation ne peut pas rester "en attente" indéfiniment
2

Comment fonctionne l'acceptation des réservations ?

Lorsque l'instant booking est désactivé sur un listing, le vendeur doit accepter manuellement chaque réservation.

1

Client crée une réservation

Le client paie sa réservation. Statut: "waiting" (en attente d'acceptation).

2

Vendeur reçoit une notification

Le vendeur voit la nouvelle réservation dans son dashboard avec deux boutons: "Accepter" et "Rejeter".

3

Vendeur a un délai pour répondre

Le système affiche un compte à rebours basé sur:

  • Le délai configuré par l'admin (ex: 48h)
  • OU la date de début de réservation (si elle arrive avant)
4

Deux issues possibles

✅ Acceptée

Réservation confirmée

❌ Rejetée/Expirée

Client remboursé 100%

Information importante

L'instant booking permet d'éviter ce processus. Si activé sur un listing, les réservations sont automatiquement confirmées sans besoin d'acceptation manuelle.

3

Comment rejeter une réservation ?

Si vous êtes vendeur et que vous souhaitez rejeter une réservation en attente :

  1. 1

    Allez dans "My Bookings"

    Dans votre dashboard vendeur, cliquez sur "My Bookings" dans le menu.

  2. 2

    Trouvez la réservation en attente

    Localisez la réservation avec le statut "waiting" (badge orange).

  3. 3

    Cliquez sur "Rejeter"

    Un bouton rouge "Rejeter" est disponible à côté du bouton "Accepter".

  4. 4

    Sélectionnez une raison et confirmez

    Une popup s'ouvre. Choisissez une raison de rejet:

    • Dates non disponibles
    • Listing temporairement fermé
    • Erreur de tarification
    • Autre raison (à préciser)

⚡ Que se passe-t-il après le rejet ?

  1. Le client est remboursé 100% automatiquement via Stripe
  2. La réservation passe en statut "cancelled"
  3. Le client reçoit un email expliquant le rejet
  4. Les dates redeviennent disponibles sur votre listing
4

⭐ Expiration intelligente et remboursement automatique

Le système utilise une expiration intelligente qui vérifie deux dates pour déterminer quand annuler automatiquement une réservation en attente:

⏰

Critère 1: Délai configuré

Temps écoulé depuis la création de la réservation (ex: 48h)

📅

Critère 2: Date de début ⭐

Date/heure de début de la réservation (NOUVEAU !)

🎯 Logique d'expiration

La réservation expire au PLUS TÔT entre les deux dates

📊 Exemples concrets

Délai configuré Réservation pour dans Expire dans Raison
48h (2 jours) 5 jours 48h (2 jours) ⏰ Délai
5 jours (120h) 3 jours 3 jours ⭐ 📅 Date début
0 (désactivé) 2 jours 2 jours 📅 Date début

Pourquoi cette logique ?

Une réservation ne peut pas être acceptée APRÈS son début. Si un client réserve pour dans 3 jours mais que le délai configuré est de 5 jours, le vendeur a seulement 3 jours maximum pour répondre (jusqu'à la date de début). C'est plus logique et plus juste pour le client.

💰 Remboursement automatique

Lorsqu'une réservation expire (manuellement ou automatiquement) :

  • 💳 100% remboursé via Stripe (aucun frais)
  • ⚡ Remboursement immédiat (automatique)
  • 📧 Email envoyé au client et au vendeur
  • 📊 Historique enregistré dans le dashboard
  • 🏦 Argent sur compte client sous 5-10 jours
5

Configuration et paramètres

Si vous êtes administrateur, vous pouvez configurer le système depuis Rejet Refund > Paramètres.

⚙️ Paramètres principaux

1 Délai avant rejet automatique

Définit le nombre d'heures qu'un vendeur a pour répondre à une réservation. Exemples :

  • 24h = 1 jour (délai rapide)
  • 48h = 2 jours (recommandé)
  • 72h = 3 jours (délai flexible)
  • 0 = Désactivé (seule la date de début compte)

2 Vérification automatique (Cron)

Le système vérifie automatiquement toutes les 15 minutes les réservations en attente. Aucune configuration requise, c'est entièrement automatique.

🔧 Dépendances requises

Pour que ce plugin fonctionne, vous DEVEZ avoir :

  1. Listeo Core: Le plugin principal de Listeo
  2. WooCommerce: Pour gérer les commandes et paiements
  3. Deferred Payment for Listeo v2.0+ ⚠️: OBLIGATOIRE ! Intercepte les paiements Stripe pour permettre les remboursements
  4. Licence valide: Pour Reject Refund for Listeo ET Paiement Différé
6

Questions fréquentes (FAQ)

❓ Que se passe-t-il si j'active l'instant booking ?

Si l'instant booking est activé sur un listing, les réservations sont automatiquement confirmées. Le système Rejet Refund ne s'applique pas car il n'y a pas de phase d'attente d'acceptation.

❓ Le client peut-il annuler une réservation "waiting" ?

Oui, le client peut annuler à tout moment une réservation en attente. Il sera remboursé 100% car la réservation n'est pas encore confirmée. Utilisez le plugin Cancellation Policy for Listeo si vous voulez gérer les annulations de réservations confirmées.

❓ Que signifie "Deferred Payment for Listeo OBLIGATOIRE" ?

Par défaut, Stripe transfère les fonds immédiatement au vendeur. Impossible de rembourser ! Paiement Différé intercepte le paiement et le garde en attente jusqu'à l'acceptation. C'est indispensable pour les remboursements automatiques.

❓ Puis-je désactiver l'expiration automatique ?

Oui, mettez le délai à 0 heures dans les paramètres. MAIS l'expiration par date de début restera active. C'est normal : une réservation ne peut pas rester "en attente" après son début !

❓ Le vendeur paie-t-il des frais quand il rejette ?

Non, le vendeur ne paie aucun frais. Le client est remboursé 100%, et c'est la plateforme qui supporte les frais Stripe (environ 2-3%). C'est pour ça qu'il est important de bien gérer ses réservations et d'activer l'instant booking si possible.

❓ Puis-je voir l'historique des rejets ?

Oui ! Allez dans Rejet Refund > Historique. Vous verrez tous les rejets (manuels et automatiques), les montants remboursés, les raisons, et qui a rejeté (vendeur ou système).

7

Boutons d'annulation - Affichage par statut

Ce plugin ajoute des boutons rouges d'annulation côté vendeur et côté client. Voici les règles d'affichage selon le statut de la réservation.

🔴 Bouton "Rejeter" - Côté Vendeur

Le bouton "Rejeter" apparaît sur la page "Mes Réservations" du vendeur pour :

Statut de la réservation Payée ? Bouton affiché ? Action effectuée
En attente (Pending/Waiting) ✅ 🔴 Rejeter 💰 Remboursement 100%
En attente (Pending/Waiting) ❌ 🔴 Rejeter 📋 Annulation simple
Payée / Confirmée / Annulée / Expirée — ❌ Pas de bouton —

🔴 Bouton "Annuler la réservation" - Côté Client

Le bouton "Annuler la réservation" apparaît sur la page "Mes Réservations" du client pour :

Statut de la réservation Payée ? Bouton affiché ? Action effectuée
En attente (Pending/Waiting) ✅ 🔴 Annuler 💰 Remboursement 100%
En attente (Pending/Waiting) ❌ 🔴 Annuler 📋 Annulation simple
Approuvée (Approved) ❌ 🔴 Annuler 📋 Annulation simple
Confirmée (Confirmed) ❌ 🔴 Annuler 📋 Annulation simple
Payée / Annulée / Expirée — ❌ Pas de bouton —

✅ Résumé simplifié

👨‍💼
Vendeur

Peut rejeter les réservations en attente uniquement

👤
Client

Peut annuler : en attente + approuvées non payées

Pour les réservations payées et confirmées

Utilisez le plugin "Cancellation Policy for Listeo" pour gérer les annulations de réservations payées et confirmées avec des règles de remboursement personnalisées (100%, 50%, 0% selon le délai avant la date).

8

🔒 Intégration Pré-autorisation Stripe

🔒

Nouvelle intégration: Pré-autorisation Stripe

Ce plugin s'intègre parfaitement avec la fonctionnalité de pré-autorisation de Prepaid Booking for Listeo. Quand cette option est activée, les boutons d'acceptation et de rejet ont un comportement adapté.

🔄 Comment ça fonctionne ?

✅ Bouton "Accepter" (Vendeur)

Quand le vendeur clique sur "Accepter":

  • La pré-autorisation est capturée
  • Le client est débité
  • La réservation passe en statut "paid"
  • Les emails de confirmation sont envoyés

❌ Bouton "Rejeter" (Vendeur/Client)

Quand on clique sur "Rejeter" ou "Annuler":

  • La pré-autorisation est annulée
  • Le client n'est PAS débité
  • Le montant bloqué est libéré
  • Aucun remboursement nécessaire !

📊 Différence: Pré-auth vs Paiement direct

Situation Paiement direct 🔒 Pré-autorisation
À la réservation Client débité Montant bloqué
Vendeur accepte Déjà payé → Capture (débit)
Vendeur rejette Remboursement Stripe ✅ Libération (pas de remboursement)
Expiration automatique Remboursement Stripe ✅ Libération (pas de remboursement)

⏰ Configuration du délai

⚠️ Limite de 5 jours avec pré-autorisation

Stripe limite les pré-autorisations à 7 jours. Pour garantir la sécurité, le délai maximum d'acceptation est automatiquement limité à 5 jours (120 heures) quand la pré-autorisation est activée. Si vous configurez un délai supérieur, il sera automatiquement réduit.

✨ Avantages de la pré-autorisation

💰

Pas de frais de remboursement

Stripe ne facture pas les annulations de pré-auth

⚡

Libération instantanée

Pas d'attente de 5-10 jours pour le remboursement

😊

Meilleure expérience

Le client voit son argent libéré immédiatement

🔧 Comment activer la pré-autorisation ?

  1. Installez et activez Prepaid Booking for Listeo
  2. Allez dans Paiement Préalable → Paramètres
  3. Activez l'option "Pré-autorisation Stripe"
  4. La pré-autorisation s'applique automatiquement aux réservations non instantanées
9

🅿️ Intégration Pré-autorisation PayPal

🅿️

Nouvelle intégration: Pré-autorisation PayPal

En plus de Stripe, ce plugin s'intègre maintenant avec la fonctionnalité de pré-autorisation PayPal de Prepaid Booking for Listeo. Le fonctionnement est identique à Stripe mais avec une limite de 29 jours au lieu de 7 jours.

🔄 Comment ça fonctionne ?

✅ Bouton "Accepter" (Vendeur)

Quand le vendeur clique sur "Accepter":

  • L'autorisation PayPal est capturée
  • Le client est débité
  • La réservation passe en statut "paid"
  • Les emails de confirmation sont envoyés

❌ Bouton "Rejeter" (Vendeur/Client)

Quand on clique sur "Rejeter" ou "Annuler":

  • L'autorisation PayPal est annulée (void)
  • Le client n'est PAS débité
  • Le montant bloqué est libéré
  • Aucun remboursement nécessaire !

⚖️ Différence: PayPal vs Stripe

Caractéristique 🔒 Stripe Pre-auth 🅿️ PayPal Pre-auth
Durée maximale 7 jours 29 jours
Délai recommandé 5 jours 5 jours
Capture ✅ Instantané ✅ Instantané
Annulation ✅ Libération immédiate ✅ Void immédiat

⏰ Configuration du délai

💡 Cohérence avec Stripe: 5 jours recommandé

Bien que PayPal permette jusqu'à 29 jours, nous recommandons de conserver le même délai de 5 jours (120 heures) que Stripe pour assurer une expérience utilisateur cohérente, quelle que soit la méthode de paiement choisie par vos clients.

✨ Avantages de la pré-autorisation PayPal

💰

Pas de frais de remboursement

PayPal ne facture pas les annulations de pré-auth

⚡

Libération instantanée

Pas d'attente pour le remboursement

🌍

Alternative à Stripe

Offrez PayPal aux clients qui le préfèrent

🔧 Comment activer la pré-autorisation PayPal ?

  1. Installez et activez Prepaid Booking for Listeo
  2. Configurez PayPal dans Paiement Préalable → Paramètres
  3. Activez l'option "Pré-autorisation PayPal"
  4. La pré-autorisation PayPal s'applique automatiquement aux réservations non instantanées
📚

Besoin d'aide supplémentaire ?

Si quelque chose n'est pas clair ou si vous rencontrez un problème, n'hésitez pas à contacter le support. Nous sommes là pour vous aider !

✉️ Contacter le support

Besoin d'aide supplémentaire ?

Notre équipe est disponible pour vous accompagner.