Vérification de la livraison des e-mails
Avant que le module commence à envoyer des rappels de paiement à vos clients, cette fonctionnalité confirme que le système de messagerie de votre PrestaShop est capable de délivrer un e-mail dans une vraie boîte de réception.
Disponible depuis la v1.2.0
Présentation
La vérification de la livraison des e-mails correspond à l'étape 4 de la liste de contrôle de configuration du module. Lorsque vous cliquez sur Envoyer un e-mail de test, le module génère un lien unique à durée limitée et l'intègre dans un message de test envoyé à l'adresse de votre choix. En cliquant sur ce lien, vous indiquez au module que votre système de messagerie fonctionne — et déverrouillez le statut final « actif » sur le tableau de bord de configuration.
Tant que la vérification n'est pas terminée, le tableau de bord Configuration du module maintient le badge de statut en orange et affiche « Le module n'est pas encore actif. » La barre de progression reste en dessous de 100 %. Une fois le lien cliqué, le badge devient vert et la bannière indique « Le module est actif et prêt à envoyer des rappels de paiement ! »
Cette étape existe parce que de nombreuses installations PrestaShop ont des paramètres de messagerie mal configurés — identifiants SMTP incorrects, ports bloqués ou filtres anti-spam trop agressifs. Détecter un problème de livraison lors de la configuration est bien plus simple qu'essayer de le diagnostiquer après que des clients ont déjà manqué leurs rappels de paiement.
Configuration
La vérification de la livraison des e-mails ne dispose pas de panneau de paramètres persistant — il s'agit d'un processus unique que vous déclenchez depuis le tableau de bord de configuration. La seule donnée à saisir est l'adresse e-mail à laquelle vous souhaitez recevoir le message de test.
| Champ | Remarques |
|---|---|
| Adresse e-mail | Pré-remplie avec l'e-mail administrateur de votre boutique. Vous pouvez la remplacer par n'importe quelle boîte de réception à laquelle vous avez accès immédiatement. |
L'adresse saisie ici est utilisée uniquement pour l'e-mail de vérification. Elle n'est pas enregistrée de façon permanente et n'a aucun effet sur l'adresse à laquelle les rappels clients sont envoyés.
L'étape 4 n'est disponible qu'une fois les étapes 1 à 3 terminées. Si la carte affiche un badge Verrouillé, commencez par effectuer les actions suivantes :
- Étape 1 — Configurez et enregistrez votre modèle d'e-mail.
- Étape 2 — Sélectionnez au moins un module de paiement à surveiller.
- Étape 3 — Créez au moins un message de rappel.
Une fois les trois étapes terminées, l'étape 4 s'ouvre automatiquement.
Fonctionnement
Envoi de l'e-mail de test
- Accédez à Modules > Gestionnaire de modules, recherchez Order Payment Reminders Pro et cliquez sur Configurer.
- Le tableau de bord Configuration du module s'ouvre. Développez la carte Test & Vérification (étape 4).
- Dans le champ Adresse e-mail, confirmez ou modifiez l'adresse de destination.
- Cliquez sur Envoyer un e-mail de test.
- Un message de confirmation apparaît : « E-mail de test envoyé à [adresse]. Veuillez vérifier votre boîte de réception et cliquer sur le lien de vérification. »
Clic sur le lien de vérification
- Ouvrez votre boîte de réception et trouvez l'e-mail avec l'objet « Test Email - Order Payment Reminders ».
- Le corps de l'e-mail contient un bouton vert Verify Email Delivery. Cliquez dessus.
- Votre navigateur ouvre une page sur votre vitrine. Si la livraison a réussi, la page affiche une coche verte et le message « Livraison de l'e-mail confirmée ! Votre module est prêt à être utilisé. »
- Cliquez sur Retour à la configuration du module pour revenir au Back Office.
Fonctionnement du jeton
Le lien de vérification contient un jeton unique généré au moment où vous cliquez sur Envoyer un e-mail de test. Le jeton est valable 24 heures. Une fois que vous avez cliqué sur le lien avec succès, le jeton est immédiatement supprimé — cliquer une seconde fois sur le même lien affiche « Jeton de vérification invalide », ce qui est attendu et sans conséquence.
Si le délai de 24 heures est dépassé avant que vous cliquiez, la page affiche : « Le lien de vérification a expiré. Veuillez envoyer un nouvel e-mail de test depuis la configuration du module. » Retournez au tableau de bord et cliquez à nouveau sur Envoyer un e-mail de test pour obtenir un nouveau lien.
Ce qui change lorsque la vérification réussit
Après un clic réussi, le module enregistre votre boutique comme vérifiée. Le tableau de bord de configuration reflète immédiatement ce changement :
- L'étape 4 affiche un badge vert Vérifié.
- La barre de progression atteint 100 %.
- La bannière de statut devient verte : « Le module est actif et prêt à envoyer des rappels de paiement ! »
Effet sur la tâche cron
La tâche cron quotidienne qui envoie les e-mails de rappel ne vérifie pas le statut de vérification. Si votre cron est planifié avant que vous ayez terminé cette étape, le module tentera quand même d'envoyer des rappels. La vérification est une mesure de sécurité au moment de la configuration, pas un verrou au moment de l'exécution. Le flux recommandé est de terminer les quatre étapes — y compris la vérification — avant d'ajouter la tâche cron à votre serveur.
Interaction avec le mode test
Le mode test et la vérification des e-mails sont des fonctionnalités indépendantes. Si le mode test est actif lorsque vous cliquez sur Envoyer un e-mail de test, l'e-mail de test est quand même envoyé à l'adresse saisie dans le champ de vérification — et non à l'adresse du mode test. La vérification contourne intentionnellement la redirection du mode test.
Exemples d'utilisation
Exemple : première configuration Vous venez d'installer le module, créé votre premier message de rappel et sélectionné le module de paiement Wire Transfer à l'étape 2. Ouvrez l'étape 4, laissez l'adresse e-mail administrateur par défaut et cliquez sur Envoyer un e-mail de test. L'e-mail arrive en moins d'une minute. Vous cliquez sur le bouton vert, la page de la vitrine confirme la livraison et le tableau de bord affiche les quatre étapes comme terminées. Vos premiers rappels seront désormais envoyés selon le calendrier prévu.
Exemple : après modification des paramètres SMTP Votre hébergeur a migré votre site vers un nouveau serveur avec des identifiants de messagerie sortante différents. Vous mettez à jour les paramètres SMTP dans Paramètres avancés > E-mail de PrestaShop, puis revenez au tableau de bord du module et cliquez à nouveau sur Envoyer un e-mail de test. Si le nouvel e-mail arrive et que vous cliquez sur le lien, vous savez que la nouvelle configuration SMTP fonctionne correctement.
Exemple : diagnostic des rappels manquants Un client vous contacte en indiquant n'avoir jamais reçu de rappel de paiement. Relancez le processus de vérification en utilisant votre propre adresse e-mail. Si l'e-mail de test n'arrive pas, votre système de messagerie a un problème de livraison qui affecte tous les e-mails sortants — pas seulement les rappels. S'il arrive, le problème est spécifique à cette commande ou à ce client.
Remarques importantes
- Le statut de vérification est enregistré par boutique. Dans une configuration multi-boutique, effectuez l'étape de vérification en étant connecté au contexte du Back Office de chaque boutique afin de marquer chacune comme vérifiée sur son propre tableau de bord.
- Le lien de vérification ouvre une page publique de votre vitrine et ne nécessite aucune connexion au Back Office. Il est possible de le cliquer depuis n'importe quel appareil ou client de messagerie.
- Si votre client de messagerie supprime le HTML, aucun bouton ne sera présent — seulement une longue URL. Copiez et collez l'URL depuis la version texte brut de l'e-mail dans votre navigateur.
- Ne modifiez pas manuellement l'URL de vérification. Le paramètre
tokendoit être présent et intact pour que le lien fonctionne.
Résolution des problèmes
| Problème | Solution |
|---|---|
| L'e-mail de vérification n'est jamais arrivé | Vérifiez les paramètres de messagerie de PrestaShop dans Paramètres avancés > E-mail et envoyez d'abord un test depuis cette page. Vérifiez également votre dossier spam. |
| « Le lien de vérification a expiré » lors du clic | Le délai de 24 heures est dépassé. Retournez au tableau de bord, cliquez à nouveau sur Envoyer un e-mail de test et cliquez rapidement sur le nouveau lien. |
| « Jeton de vérification invalide » lors du clic | Vous avez déjà cliqué avec succès sur le lien (le jeton est consommé à la première utilisation), ou un e-mail de test plus récent a remplacé celui-ci. Retournez au tableau de bord — si l'étape 4 affiche Vérifié, la configuration est terminée. |
| « Lien de vérification invalide » lors du clic | L'URL est malformée ou le paramètre token est absent. Ne copiez pas l'URL manuellement ; cliquez sur le bouton dans l'e-mail. |
| L'étape 4 affiche « Verrouillé » au lieu du formulaire e-mail | Les étapes 1 à 3 ne sont pas toutes terminées. Vérifiez chaque étape pour un badge Requis et terminez-les d'abord. |
| Le tableau de bord affiche toujours l'étape 4 comme en attente après le clic | Une couche de cache a peut-être retardé la mise à jour. Actualisez la page de configuration du module en forçant le rechargement (Ctrl + Maj + R / Cmd + Maj + R). |
| Le bouton Envoyer un e-mail de test ne réagit pas | Vérifiez la console de votre navigateur pour des erreurs JavaScript. Essayez d'enregistrer la configuration du module une fois avant de réessayer pour actualiser le jeton AJAX. |
Foire aux questions
Le module cesse-t-il d'envoyer des rappels si je perds mon statut de vérification ?
Non. La tâche cron quotidienne qui envoie les rappels s'exécute indépendamment du statut de vérification. L'indicateur de vérification n'affecte que l'affichage du tableau de bord de configuration — une fois la configuration initiale passée, il ne bloque pas la livraison des e-mails.
Puis-je effectuer une nouvelle vérification après avoir modifié mes paramètres SMTP ?
Oui. Ouvrez l'étape Test & Vérification et cliquez à nouveau sur Envoyer un e-mail de test. Le module génère un nouveau jeton et envoie un nouvel e-mail à l'adresse que vous saisissez, remplaçant le jeton précédent.
La page de vérification indique « Livraison de l'e-mail confirmée ! » mais l'étape 4 affiche toujours « en attente » dans le tableau de bord. Que s'est-il passé ?
L'indicateur de vérification a été enregistré correctement, mais votre navigateur affichait une version mise en cache du tableau de bord. Actualisez la page de configuration du module en forçant le rechargement (Ctrl + Maj + R ou Cmd + Maj + R) et l'étape apparaîtra comme Vérifiée.
La vérification doit-elle être répétée pour chaque boutique dans une configuration multi-boutique ?
Oui. L'indicateur de vérification est enregistré par boutique. Effectuez l'étape de vérification en étant connecté au contexte du Back Office de chaque boutique afin que le tableau de bord de chacune affiche le statut correct.
L'e-mail de vérification est arrivé mais il n'y a pas de bouton — seulement une longue URL. Que faire ?
Votre client de messagerie supprime le HTML. Ouvrez l'e-mail dans un client différent, ou copiez l'URL brute depuis la section texte brut et collez-la dans votre navigateur.
Quelle adresse e-mail dois-je utiliser pour le test ?
Utilisez n'importe quelle boîte de réception à laquelle vous avez accès immédiatement — votre e-mail personnel ou administrateur convient parfaitement. L'adresse n'est pas enregistrée et n'est utilisée que pour délivrer ce seul message de test. L'e-mail administrateur de votre boutique est renseigné par défaut.
Le lien de vérification est-il sûr à cliquer depuis un appareil mobile ?
Oui. Le lien ouvre une page sur votre propre vitrine, valide le jeton, enregistre le statut vérifié et affiche un message de confirmation. Aucune connexion au Back Office n'est requise et aucune action sensible n'est effectuée.