Verified Delivery Reviews for OpenCart — reviews only after the parcel is received

Verified Delivery Reviews for OpenCart is a module that asks for a review when the buyer already has the item in hand. On marketplaces a seller review can be left right after checkout, before anything arrives — and sellers spend months disputing ratings for cancelled orders. On your own store you can do better: ask only those who picked up the parcel, and show it next to the review.

The module watches the waybill status that our shipping modules for OpenCart already keep — Nova Poshta, Ukrposhta, Meest and ROZETKA Delivery — and a few days after the parcel is received it sends one e-mail per order with five stars under every item. A click on a star opens a short form without an account, the review lands in the standard Catalog → Reviews, and on the product page it carries the mark “The buyer received the item · Nova Poshta”. Orders without a waybill — pickup, courier — go by the “Complete” status.

Running WordPress? The same logic exists for WooCommerce — Verified Delivery Reviews for WooCommerce.

What the buyer sees

• One e-mail, when the parcel is already home. By default 3 days after receipt, so the buyer has time to try the item; nothing is sent at night (21:00 to 9:00 Kyiv time).
• Stars right in the e-mail. Five stars under every item: a click opens the form with the rating already chosen. The e-mail goes through your store’s mail settings and in the language of the order.
• A form without an account. A personal link valid for 60 days: stars, a few words about the item and a display name. Text is optional — a rating is enough (or make text required).
• “Don’t ask me for reviews”. A link in every e-mail; unsubscribing is a button on the page, so mail scanners that open links do not unsubscribe anyone.

The review is a regular OpenCart review: it appears in Catalog → Reviews, where you approve it as usual. The module adds the green mark “The buyer received the item” and, if you like, the delivery service. OpenCart 4 recalculates the product rating right after approval. If review notifications are on in your store, you get an e-mail.

What the admin gets

Extensions → Extensions → Modules → Verified Delivery Reviews. Seven tabs: “Report”, “When to ask”, “Messages”, “Form and mark”, “Requests”, “Schedule”, “Licence”.

• Trigger. “Waybill status, orders without a waybill — by order status” (default), “waybill status only” or “order status only”. Delivery services are ticked on and off, and you see whether their module was found.
• “Received” statuses. Until you choose any, the module takes only “Complete” from the store’s “complete” statuses — without “Shipped”, because a shipped parcel has not been received yet. Add “Shipped” only if waybills are tracked by our carrier modules.
• Timing and anti-spam. Delay after receipt, quiet hours and time zone, pause per buyer, skipping items already reviewed, minimum order total, link lifetime in days, requests per run.
• Form and mark. Moderate all, auto-publish 4–5 stars or all; required text; your own mark text and the delivery service in it.
• Test e-mail to yourself. Enter your address and language — a sample e-mail comes only to you, nothing goes to buyers.

Panel on the order page. Where the request is now (scheduled, sent, reviewed, skipped and why), the “The buyer received it — schedule” and “Send now” buttons, and a tracking number field for Ukrposhta. The “Requests” tab lists all requests with a search by order number.

Report. Parcels received, requests sent, form opened, review left, average rating — by source (Nova Poshta, Meest, ROZETKA Delivery, Ukrposhta, order status, confirmed by a manager) and with the reasons a request did not go out: the buyer unsubscribed, the parcel was not received, the buyer was asked recently, the order was cancelled.

Pro: Viber, SMS, Telegram, photos and your own texts

• Viber / SMS via TurboSMS. Your turbosms.ua account and your approved sender names: Viber first, SMS if the number has no Viber (or Viber only, or SMS only). A “Check the connection and balance” button. Messages are paid to TurboSMS at its rates.
• Telegram. A bot from @BotFather is connected with the “Connect the bot” button (HTTPS required). On the order success page the buyer taps “Get it in Telegram” — the request arrives in the chat with a “Leave a review” button. The /stop command or blocking the bot unsubscribes. The bot does not write to people who have not started it: that is how Telegram works.
• Photos in reviews. Count and size limits are configurable; JPEG, PNG and WebP are checked by file content, not just by extension. The gallery appears under the review after approval.
• Your own texts. E-mail subject, heading and text, Viber/SMS and Telegram texts with the variables {customer_name}, {store_name}, {order_number}, {carrier}, {ttn}, {review_link}. An empty field means the built-in text in the language of the order.
• Report. Periods of 7/30/90/365 days, breakdown by channel (e-mail, Viber/SMS, Telegram) and CSV without buyers’ e-mails and phones.

How it works — step by step

1. On every run the module looks at recent orders: has the parcel been received by the waybill of our shipping module, has the order got a “received” status, has a manager pressed “The buyer received it”.
2. Receipt confirmed — the order gets a request with a send date: the delay after receipt, quiet hours. Refused, returned or cancelled — the request is skipped with a reason.
3. Before sending, the module checks again: the order is not cancelled, the buyer has not unsubscribed and was not asked in the last 30 days, the order still has items without a review.
4. The e-mail (in Pro also Viber/SMS and Telegram) goes out in the language of the order. One request per order is guaranteed by a unique record in the database, and a run lock stops two cron runs from sending a duplicate.
5. The buyer opens the form by the personal link, sets the stars and writes the review — it is saved to OpenCart’s standard review table, linked to the order and the delivery service.
6. You moderate as usual: Catalog → Reviews. After approval — the “The buyer received the item” mark on the product page.

Under the hood

• Read-only. The module reads the tables of our shipping modules and changes nothing there. For future modules there is the cc_shipment_delivered event (order_id, carrier, ttn, delivered_at).
• One library for three builds. The logic is shared by OpenCart 4, 3 and 2.3 and written for PHP 7.0+; the settings screen, the order panel, the form and the e-mail have their own styles and look the same on Bootstrap 5 and 3.
• One request per order — a unique key in the module’s own table and an atomic “claim” of the request before sending; runs never overlap thanks to a MySQL lock.
• Privacy. The link is a random token, only its hash is stored. E-mail and phone for the pause and unsubscribe are stored only as hashes.
• Regular reviews. Reviews are written to OpenCart’s standard review table, the mark is added by an event to the product’s review list. Remove the module — the reviews stay in Catalog → Reviews.
• Uninstall. Uninstalling removes the events, cron jobs and module tables (the “Keep data” box keeps unsubscribes and the log). A connected Telegram bot is disconnected on uninstall.

How to install

1. OpenCart 4: Extensions → Installer → upload cc_vdreviews.ocmod.zip (do not rename the archive) and press “Install”. OpenCart 3: Extensions → Installer → cc_vdreviews-oc3.ocmod.zip. OpenCart 2.3: upload the contents of the upload/ folder from cc_vdreviews-oc2.ocmod.zip to the store root (FTP or the hosting file manager).
2. Extensions → Extensions → Modules → Verified Delivery Reviews → “Install”, then “Edit”.
3. The “When to ask” tab: turn the status on, check the trigger, delivery services and the “received” status, save.
4. The “Messages” tab: “Send a test e-mail” to your address — you will see what the buyer gets.
5. The “Schedule” tab: add the cron URL to the hosting crontab (or rely on runs from the admin).
6. For Pro: the “Licence” tab — the key from the e-mail after payment, or the 7-day trial.