Installer Qafilo Pro : licence, Stripe et e-mails automatiques en 20 minutes

Avant de commencer

• Qafilo, l’extension gratuite, installé et activé. Qafilo Pro ne fonctionne pas sans elle.
• WordPress 6.8 ou plus récent et PHP 8.1 ou plus récent. Votre hébergeur l’indique dans son espace client.
• Un compte Stripe au nom de l’agence, vérifié. L’argent des clients arrive directement sur ce compte : ni FullDo ni Qafilo ne le touchent.
• L’e-mail de confirmation reçu après l’achat : il contient votre clé de licence et le lien de téléchargement de Qafilo Pro.

1. Installer l’extension et activer la licence

1. Téléchargez le fichier qafilo-pro au format zip depuis le lien de l’e-mail. Ne le décompressez pas.
2. Dans WordPress, ouvrez Extensions › Ajouter › Téléverser une extension, choisissez le fichier, puis Installer et Activer.
3. L’écran d’activation de la licence s’ouvre. Collez la clé reçue par e-mail et validez. Une licence vaut pour un site : pour l’utiliser sur un autre site, désactivez-la d’abord sur le premier.
4. Le menu Qafilo › Qafilo Pro apparaît : c’est là que tout se règle.

2. Relier Stripe, d’abord en mode test

Commencez toujours par le mode test : aucun argent réel ne circule, et vous vérifiez que tout le parcours fonctionne sur votre site avant de l’ouvrir aux clients.

1. Dans le tableau de bord Stripe, activez le mode test, puis ouvrez Développeurs › Clés API et copiez la clé secrète (elle commence par sk_test_). Collez-la dans Qafilo Pro, champ « Clé secrète ».
2. Dans Qafilo Pro, copiez l’adresse du webhook. Elle a la forme https://votre-site.fr/wp-json/qafilo-pro/v1/stripe.
3. Dans Stripe, ouvrez Développeurs › Webhooks et ajoutez une destination de type point de terminaison. Collez l’adresse, puis choisissez les deux événements checkout.session.completed et checkout.session.async_payment_succeeded.
4. Copiez le secret de signature de cette destination (il commence par whsec_) et collez-le dans Qafilo Pro, champ « Secret de signature du webhook ». Enregistrez.

Les deux clés ne sont plus jamais affichées une fois enregistrées : Qafilo Pro montre seulement leurs quatre derniers caractères. Si la clé du coffre Qafilo est déjà dans wp-config.php, elles sont enregistrées chiffrées.

3. Faire un paiement test

1. Ouvrez une réservation et passez-la en Confirmée. Le client reçoit l’e-mail de confirmation avec le lien de paiement de l’acompte.
2. Dans la colonne de droite de la réservation, le bloc « Paiement par le client » affiche le montant dû et le lien de paiement. Ouvrez ce lien dans une fenêtre privée.
3. Sur la page de Stripe, payez avec la carte de test 4242 4242 4242 4242, une date future et un code quelconques.
4. Revenez sur la réservation : le paiement apparaît en « Paiement en ligne (Stripe) », le statut passe à « Acompte reçu » et l’e-mail de reçu est noté dans l’historique.

Si le paiement est accepté par Stripe mais n’apparaît pas sur la réservation après quelques minutes, c’est presque toujours le pare-feu de l’hébergeur qui bloque le webhook. Stripe l’indique dans Développeurs › Webhooks, sur la destination, avec le code d’erreur renvoyé.

Hébergement o2switch : le réglage Tiger Protect

Chez o2switch, le pare-feu Tiger Protect bloque les appels de Stripe vers le site : le paiement passe, mais la réservation n’est pas mise à jour. Dans le cPanel, ouvrez Tiger Protect et désactivez la protection pour le domaine du site. Si vous préférez la garder, demandez au support o2switch d’autoriser l’adresse /wp-json/qafilo-pro/v1/stripe. Chez les autres hébergeurs, un pare-feu applicatif peut produire le même effet : la solution est la même.

4. Passer en production

1. Dans Stripe, quittez le mode test. Copiez la clé secrète réelle (sk_live_) et remplacez la clé de test dans Qafilo Pro.
2. Créez à nouveau la destination webhook, cette fois hors mode test, avec la même adresse et les deux mêmes événements. Son secret de signature est différent : remplacez aussi celui de Qafilo Pro. C’est l’oubli le plus fréquent.
3. Enregistrez. Le haut de l’écran Qafilo Pro indique « En service » : les clients paient désormais par carte, sur le compte Stripe de l’agence.

5. Virement et e-mails automatiques

• Coordonnées bancaires : titulaire, IBAN et BIC. Elles sont ajoutées aux e-mails dès qu’un montant est dû, avec la référence de réservation à indiquer sur le virement. Utile pour les clients qui ne paient pas par carte.
• E-mails automatiques : confirmation, reçu, relance d’acompte, solde bientôt dû, solde dû, départ proche. Chacun s’active séparément, et les délais en jours se règlent sur le même écran. L’échéance du solde suit le nombre de jours avant le départ fixé dans Qafilo › Réglages.
• Les relances partent chaque jour à 9 h. WordPress ne lance ses tâches planifiées que lorsqu’une page est visitée : sur un site peu fréquenté, ajoutez une tâche cron chez l’hébergeur qui appelle https://votre-site.fr/wp-cron.php toutes les heures.
• Pour que les e-mails arrivent en boîte de réception, envoyez-les par le serveur de messagerie de l’agence avec une extension SMTP, plutôt que par la fonction d’envoi par défaut de l’hébergeur.

Questions fréquentes