Enhances the checkout process by allowing customers to add an internal order reference. Includes a hook for customer-side search functionality. Reference appears in email, PDF, and order detail in admin.
This module adds a customer order reference field to your PrestaShop checkout. It’s especially useful for B2B customers who want to manage internal tracking or recurring orders. Private customers benefit from added clarity and documentation.
At the core of this module is an extra input field in the checkout process. Customers can enter an order reference, project number, or internal note. The input is stored with the cart and later linked to the order ID upon completion. This ensures that the reference is permanently accessible for both the customer and shop admin.
In the PrestaShop back office, the customer’s order reference is shown directly on the order detail page. This greatly facilitates order handling, particularly when dealing with inquiries, returns, or internal processes – saving time and avoiding misunderstandings.
The module provides a convenient search form on the customer order history page. Customers can search their orders by either the PrestaShop order ID or the custom order reference. This extra filter improves usability, especially for high-volume buyers.
The order reference is also available in printed documents. The module includes a template variable for displaying it in PDF invoices (PDFInvoice) and delivery slips (PDFDeliverySlip). Integration is well-documented and can be customized as needed.
In addition to PDFs, the order reference can also be inserted into the order confirmation email (order_conf). The variable is only used if the customer has actually entered a reference – ensuring relevant and clean communication.
For connecting external systems, the module offers an added benefit: it extends the PrestaShop Webservice API with a new resource. This allows automated retrieval and processing of customer order references, making it ideal for scalable shops using ERP or CRM systems.
| Checkout Form | Input field in the checkout process for internal customer order references. |
| Order Confirmation | Displays the internal order reference on the order confirmation page in the front office. |
| Back Office Integration | Displays the internal customer order reference on the admin order detail page. |
| Front Office Order Details | Shows the internal customer order reference in the customer account’s order history. |
| Optional Order Search | Search form on the order history page (PrestaShop order ID & customer reference) using a custom module hook. |
| Email & PDF Variable | Available variables for the order confirmation email (order_conf) and PDF templates for invoice and delivery slip. |
| Webservice Resource | Custom API resource `order_reference` for PrestaShop webservice access. |
This demo helps you understand how the product works.
Store Demo Back Office Demo