Email Delivery Verification
Before the module starts sending payment reminders to your customers, this feature confirms that your PrestaShop mail system can actually deliver an email to a real inbox.
Available since v1.2.0
Overview
Email delivery verification is Step 4 of the module setup checklist. When you click Send Test Email, the module generates a unique, time-limited link and embeds it in a test message sent to the address you choose. Clicking that link tells the module your mail system works — and unlocks the final "active" status on the setup dashboard.
Until verification is complete, the Module Setup dashboard keeps the status badge amber and displays "Module is not active yet." The progress bar stays below 100%. Once you click the link, the badge turns green and the banner reads "Module is active and ready to send payment reminders!"
The step exists because many PrestaShop installations have misconfigured mail settings — wrong SMTP credentials, blocked ports, or aggressive spam filters. Catching a delivery problem during setup is far easier than diagnosing it after customers have already missed their payment reminders.
Configuration
Email delivery verification has no persistent settings panel — it is a one-time flow you trigger from the setup dashboard. The only input you provide is the email address where you want to receive the test message.
| Field | Notes |
|---|---|
| Email address | Pre-filled with your shop admin email. You can change it to any inbox you can access immediately. |
The address you enter here is used only for the verification email. It is not stored permanently and has no effect on where customer reminders are sent.
Step 4 is only available once Steps 1–3 are complete. If the card shows a Locked badge, finish the following first:
- Step 1 — Configure and save your email template.
- Step 2 — Select at least one payment module to monitor.
- Step 3 — Create at least one reminder message.
Once all three are done, Step 4 opens automatically.
How It Works
Sending the test email
- Go to Modules > Module Manager, find Order Payment Reminders Pro, and click Configure.
- The Module Setup dashboard opens. Expand the Test & Verify card (Step 4).
- In the Email address field, confirm or change the destination address.
- Click Send Test Email.
- A confirmation message appears: "Test email sent to [address]. Please check your inbox and click the verification link."
Clicking the verification link
- Open your inbox and find the email with subject "Test Email - Order Payment Reminders".
- The email body contains a green Verify Email Delivery button. Click it.
- Your browser opens a page on your storefront. If delivery succeeded, the page shows a green checkmark and the message "Email delivery confirmed! Your module is ready to use."
- Click Return to Module Configuration to go back to the Back Office.
Token mechanics
The verification link contains a unique token generated at the moment you click Send Test Email. The token is valid for 24 hours. Once you click the link successfully, the token is immediately deleted — clicking the same link a second time shows "Invalid verification token," which is expected and harmless.
If the 24-hour window passes before you click, the page shows: "Verification link has expired. Please send a new test email from the module configuration." Return to the dashboard and click Send Test Email again to get a fresh link.
What changes when verification succeeds
After a successful click, the module sets your shop as verified. The setup dashboard immediately reflects this:
- Step 4 shows a green Verified badge.
- The progress bar reaches 100%.
- The status banner turns green: "Module is active and ready to send payment reminders!"
Effect on the cron job
The daily cron job that sends reminder emails does not check verification status. If your cron is scheduled before you complete this step, the module will still attempt to send reminders. Verification is a setup-time safeguard, not a runtime lock. The recommended flow is to complete all four steps — including verification — before adding the cron job to your server.
Test Mode interaction
Test Mode and email verification are independent features. If Test Mode is active when you click Send Test Email, the test email still goes to the address you entered in the verification field — not to the Test Mode address. Verification bypasses the Test Mode redirect intentionally.
Usage Examples
Example: First-time setup You have just installed the module, created your first reminder message, and picked the Wire Transfer payment module in Step 2. Open Step 4, leave the default admin email address, and click Send Test Email. The email arrives within a minute. You click the green button, the storefront page confirms delivery, and the dashboard shows all four steps complete. Your first reminders will now go out on schedule.
Example: After changing SMTP settings Your hosting provider moved your site to a new server with different outgoing mail credentials. You update the SMTP settings under Advanced Parameters > E-mail in PrestaShop, then return to the module dashboard and click Send Test Email again. If the new email arrives and you click the link, you know the new SMTP configuration is working correctly.
Example: Diagnosing missing reminders A customer contacts you saying they never received a payment reminder. Re-run the verification flow using your own email address. If the test email does not arrive, your mail system has a delivery problem that applies to all outgoing mail — not just reminders. If it does arrive, the issue is specific to that order or customer.
Important Notes
- Verification status is stored per-shop. In a multi-shop setup, complete the verification step while logged in to each shop's Back Office context to mark each one as verified on its own dashboard.
- The verification link opens a public page on your storefront and requires no Back Office login. It is safe to click from any device or email client.
- If your email client strips HTML, there will be no button — only a long URL. Copy and paste the URL from the plain-text version of the email into your browser.
- Do not manually edit the verification URL. The
tokenparameter must be present and intact for the link to work.
Troubleshooting
| Problem | Solution |
|---|---|
| The verification email never arrived | Check PrestaShop's mail settings under Advanced Parameters > E-mail and send a test from that page first. Also check your spam folder. |
| "Verification link has expired" when clicking | The 24-hour window passed. Return to the dashboard, click Send Test Email again, and click the new link promptly. |
| "Invalid verification token" when clicking | You already clicked the link successfully (the token is consumed on first use), or a newer test email replaced this one. Return to the dashboard — if Step 4 shows Verified, setup is complete. |
| "Invalid verification link" when clicking | The URL is malformed or the token parameter is missing. Do not copy the URL manually; click the button inside the email. |
| Step 4 shows "Locked" instead of the email form | Steps 1–3 are not all complete. Check each step for a Required badge and finish those steps first. |
| Dashboard still shows Step 4 as pending after clicking the link | A caching layer may have delayed the update. Hard-refresh the module configuration page (Ctrl + Shift + R / Cmd + Shift + R). |
| Send Test Email button does nothing | Check your browser console for JavaScript errors. Try saving the module configuration once before retrying to refresh the AJAX token. |
Frequently Asked Questions
Does the module stop sending reminders if I lose my verified status?
No. The daily cron job that sends reminders runs regardless of verification status. The verified flag affects only the setup dashboard display — once you are past initial setup, it does not block email delivery.
Can I re-verify after changing my SMTP settings?
Yes. Open the Test & Verify step and click Send Test Email again. The module generates a new token and sends a fresh email to whatever address you enter, overwriting the previous token.
The verification page says "Email delivery confirmed!" but Step 4 still shows pending in the dashboard. What happened?
The verified flag was saved correctly, but your browser was showing a cached version of the dashboard. Hard-refresh the module configuration page (Ctrl + Shift + R or Cmd + Shift + R) and the step will show as Verified.
Does verification need to be repeated for each shop in a multi-shop setup?
Yes. The verified flag is stored per-shop. Complete the verification step while logged in to each shop's Back Office context so each shop's dashboard shows the correct status.
The verification email arrived but there is no button — just a long URL. What do I do?
Your email client is stripping HTML. Open the email in a different client, or copy the raw URL from the plain-text section and paste it into your browser.
What email address should I use for the test?
Use any inbox you can access right away — your personal email or admin address works well. The address is not stored and is only used to deliver this one test message. Your shop admin email is filled in by default.
Is the verification link safe to click from a mobile device?
Yes. The link opens a page on your own storefront, validates the token, records the verified status, and shows a confirmation message. No Back Office login is required and no sensitive action is taken.