1.0.0
Nov 6, 2026
Latest- First release.
Royal Mail Click & Drop Shipping for OpenCart
by Kavio Labs · for OpenCart 4.1.x
Royal Mail services at checkout with prices from your own table (service, zone, weight band), orders sent to Royal Mail Click & Drop from the order page or at an order status, PDF labels for OBA accounts, tracking numbers read back into the order history. You connect with your own Click & Drop API key. Click & Drop has no rate quote, so checkout prices are the table you maintain. A shipping extension with events and cron, no OCMOD.
Built forOpenCart
Royal Mail services at checkout1 of 6
What it does
Royal Mail services at checkout with prices from your own table (service, zone, weight band), orders sent to Royal Mail Click & Drop from the order page or at an order status, PDF labels for OBA accounts, tracking numbers read back into the order history. You connect with your own Click & Drop API key. Click & Drop has no rate quote, so checkout prices are the table you maintain. A shipping extension with events and cron, no OCMOD.
What it changes for your store
- Royal Mail shipping through Click & Drop. Customers choose a Royal Mail service at checkout; you send the order to Click & Drop with one click (or at an order status); the tracking number comes back into the order. You connect with your own Click & Drop API key.
- Know the limits. Prices at checkout are the ones you enter, not a live quote. Labels through the API need an OBA account. Click & Drop reports no delivery event, so orders are not marked delivered automatically. Tested against a stand-in built from the official Click & Drop Swagger specification, not against a live Royal Mail account. Royal Mail is a trademark of its owner; this extension is not affiliated with or endorsed by Royal Mail. The Royal Mail logo is not used.
Features
Checkout
- One Royal Mail shipping method with a line per service: Tracked 24, Tracked 48, Special Delivery Guaranteed by 1pm, International Tracked, International Tracked & Signed
- Prices come from a table you maintain: weight bands per service and zone (UK, EU, rest of the world), because Click & Drop has no rate quote
- Free shipping threshold, fallback price, tax class and geo zone
Orders, labels and tracking
- A Royal Mail tab on the order page: send the order with address, weight, items, totals, service code and customs data for international parcels
- Accounts with an Online Business Account (OBA) get the PDF label back with the order, with CN22 / CN23; one PDF for many orders from the Shipments tab
- Pay-as-you-go accounts: the order is created in Click & Drop, you print and pay for the label there
- The tracking number and the Royal Mail tracking link go into the order history, with an optional e-mail; cron reads the printed, manifested and despatched state back
- Cancel the Click & Drop order from the order page
Safe and simple
- API key stored encrypted and masked in the log, labels served to administrators only; a shipping extension with events and cron, no OCMOD, no core edits; tested on OpenCart 4.1.0.4
What you get
- Download & installOne installer package (.ocmod.zip) for OpenCart 4.0.2 – 4.1.x. There is no OpenCart 3 edition. Download it from My licenses right after payment.
- 12 months of updates & supportNew versions and help for 12 months (24 or 36 months at checkout). After that the extension keeps working; renew anytime at 50%.
- License for your storeOne production domain with all its subdomains; staging and local development hosts are free. How licensing works
- 30-day refundFull refund within 30 days of your first purchase, no reason needed. Refund policy
- Tested buildsOpenCart 4.1.0.4. Tested on OpenCart 4.1.0.4.
- Documentation & supportFull guide (Installation, Configuration, Usage, Developer notes) on this page. Tickets from your account, first reply within 1 business day.
Compatibility
Royal Mail Click & Drop Shipping works with OpenCart 4.1.0.4.
We list the builds we install and test on. “Tested” means the test plan ran on that build; “Supported” means the build is inside the supported range.
| Version | Range | Runs on | Status |
|---|---|---|---|
| OpenCart 4.1.0.x | 4.1.0.0 – 4.1.0.4 | PHP 8.1 – 8.3 | Tested on 4.1.0.4 |
| OpenCart 4.0.2.x | 4.0.2.0 – 4.0.2.3 | PHP 8.0 – 8.2 | Supported |
How do I install the extension?
- Upload. Extensions > Installer: upload the .ocmod.zip. It is for OpenCart 4 (4.0.2 to 4.1.x).
- Install and enable. Extensions > Extensions > Modules: install, open the settings and switch it on. Events register themselves; nothing is patched.
- Enter the license key. Paste the key from My licenses. Subdomains, staging and local hosts are included; you have 14 days to do it.
The Documentation tab covers the settings and every screen.
Which OpenCart versions does it work with?
OpenCart 4.1.0.4. Tested on OpenCart 4.1.0.4. The Compatibility tab lists every version range.
Do the extensions change core files?
No. They work through OpenCart events and standard extension types (modules, order totals, themes). No core file edits, no OCMOD patches, no theme template edits, so OpenCart updates and other extensions keep working.
What does the license cover?
One production store domain with every subdomain (www, shop., staging.), plus local development hosts such as localhost, *.local and *.test. A store on another domain needs its own license; a second-store license is 40% off. You have 14 days after installing to enter the key. 12 months of updates and support are included; after that the extension keeps working and renewals are 50% off. How licensing works
Can I get a refund?
Yes. Ask for a full refund within 30 days of your first purchase, no reason needed: open a ticket or write to [email protected] with your order number. The money goes back to the card or bank account you paid with within 5 business days of approval. Refund policy
How do I get help?
Open a ticket from your account, so your license details are attached. We answer Monday to Friday: bug reports within 1 business day, how-to questions within 2. Support policy. Not a customer yet? Ask a pre-sales question.
8 more answers about setup and daily use in the Documentation tab.
Overview
Royal Mail Click & Drop Shipping connects your OpenCart 4 shop to Royal Mail Click & Drop, the online shipping service of Royal Mail for businesses. Customers pick a Royal Mail service at checkout with a price from a table you maintain; you send the order to Click & Drop from the order page (or let an order status do it); the tracking number comes back into the order history. You connect with your own Click & Drop API key.
What it does
- Table rates at checkout. One Royal Mail shipping method with a line per service you enable: Tracked 24, Tracked 48, Special Delivery Guaranteed by 1pm, International Tracked and International Tracked & Signed. Each line shows a delivery time text. Prices come from your table: weight bands per service and zone (UK, EU, rest of the world), in the store's default currency. Free shipping threshold, fallback price, tax class and geo zone like any OpenCart shipping method.
- Orders to Click & Drop. A Royal Mail tab on the order page sends the order with address, weight, items, totals, service code and, outside the UK, customs data. Optionally an order status sends it automatically.
- Labels. Royal Mail only generates labels through the API for accounts with an Online Business Account (OBA). With an OBA account the PDF label (with the CN22 / CN23 for international orders) comes back with the order; the Shipments tab downloads one PDF for many orders. With a pay-as-you-go account you print and pay for the label in Click & Drop.
- Tracking. The tracking number and the Royal Mail tracking link are written to the order history (the customer sees them in the account, with an optional e-mail). The OpenCart cron reads the printed, manifested and despatched state back.
- Cancel. The order tab cancels the Click & Drop order.
- Safe. The API key is stored encrypted and masked in the log; label files are only served to logged-in administrators. Events and cron only: no OCMOD, no core edits. OpenCart 4, tested on 4.1.0.4.
Limits to know
- Click & Drop has no rate quote API. The prices customers see are the ones you enter in the Rates tab; keep them in line with your own Royal Mail price list. The example bands the extension can fill in are illustrations, not Royal Mail prices.
- Labels through the API need an OBA account (Royal Mail answers HTTP 403 otherwise). A pay-as-you-go account creates the order in Click & Drop only.
- Click & Drop reports no delivery event, so the extension never marks an order delivered; the tracking link shows it.
- The Click & Drop service code of each service depends on your account; map them on the Connection tab (the extension can list the codes of your account).
- The extension was tested against a stand-in of the Click & Drop API built from the official Swagger specification, not against a live Royal Mail account. Check one order against your own account before you rely on it.
- Royal Mail rate limit: 5 calls per second; the extension retries once.
Royal Mail is a trademark of its owner; this extension is not affiliated with or endorsed by Royal Mail. The Royal Mail logo is not used.
Installation
Requirements: OpenCart 4.1.0.x, PHP 7.4 or newer with cURL and OpenSSL, a Royal Mail Click & Drop account.
- In Click & Drop open Settings > Integrations, add a Royal Mail Click & Drop API integration and copy the API key.
- In the OpenCart admin open Extensions > Installer, upload
kv_royal_mail.ocmod.zipand click Install. - Open Extensions > Extensions, choose Shipping, find Royal Mail Click & Drop Shipping, click the green Install button, then the blue pencil.
- On the Connection tab paste the API key and click Save and test connection. Choose your account type (OBA or pay as you go) and map the service codes ("Load the codes of my account").
- On the Rates tab enter your prices (or load the example bands and edit them) and save.
- On the Checkout tab choose the services, set the status to on and save.
- Make sure the OpenCart cron job runs (see Orders and tracking).
Uninstall: Extensions > Shipping > Uninstall removes the settings, the key, the rate table, the shipments and the log. Click & Drop orders already created stay in Click & Drop and their tracking numbers stay in the order history.
Update: upload the new zip in the Installer; settings, key and rate table stay.
Configuration
Checkout. Status, services offered, free shipping from (store currency), fallback price (offered as one "Royal Mail" method when no band covers the parcel), weight used when products have none, tax class, geo zone, sort order.
Connection. Click & Drop API key (stored encrypted; leave empty to keep it, enter - to remove it), account type, the Click & Drop service code of each service (empty = account default), package format, country of origin and customs category for orders outside the UK.
Rates. Per service: rows of zone, "up to" grams and price. The smallest band that holds the parcel weight is used; a parcel heavier than the largest band gets no price for that service. Zones: UK (GB), EU (member states), rest of the world.
Orders and tracking. Order status that sends the order to Click & Drop (only orders with a Royal Mail method), order status when the tracking number arrives, e-mail the customer, debug log. Cron: */10 * * * * php /path/to/opencart/cron.php or the secret address shown on the tab.
Shipments. The latest shipments with order, Click & Drop order, tracking number and state; tick rows and download one PDF with their labels (OBA accounts).
API log. Errors and warnings; with the debug log on, every request and response. The API key is masked.
Usage
Checkout. The customer chooses a Royal Mail service; the order keeps the method.
Send an order. Open the order, tab Royal Mail, press Send to Click & Drop. The order appears in Click & Drop with the address, weight, items, totals and service. With an OBA account the label PDF is stored with the order and can be printed from the tab.
Tracking. Once Click & Drop issues the tracking number the extension writes it, with the Royal Mail tracking link, to the order history. Press the refresh button to read it at once; the cron does it hourly.
Cancel. The red button cancels the Click & Drop order. A label already printed for it becomes invalid: destroy it.
Many orders. Settings > Shipments: tick shipments and download one PDF with the labels (OBA accounts).
Developer notes
Identity
| Item | Value |
|---|---|
| Extension code | kv_royal_mail (type shipping) |
| Settings | shipping_kv_royal_mail_* |
| PHP namespace | KavioLabs\KvRoyalMail (shared core in system/library/ of the extension) |
| Tables | kv_royal_mail_rates, kv_royal_mail_shipments, kv_royal_mail_log |
| Checkout route | extension/kv_royal_mail/shipping/kv_royal_mail (model getQuote) |
Events and cron
| Trigger | Action |
|---|---|
admin/view/sale/order_info/before | adds the Royal Mail tab to the order page |
admin/controller/common/header/before | licence check |
catalog/model/checkout/order.addHistory/after | sends the order at the chosen status |
| OpenCart cron, hourly | extension/kv_royal_mail/shipping/kv_royal_mail.cron reads tracking back |
Click & Drop API conformance
Endpoints and shapes follow the official Swagger specification of the Click & Drop API v1 (api.parcel.royalmail.com/api/v1, Authorization: Bearer <API key>).
| Call | Used for | Notes |
|---|---|---|
GET /carriers | test connection | |
GET /services | list service codes of the account | serviceCode, serviceName |
POST /orders | create the order ({"items":[CreateOrderRequest]}) | answer createdOrders / failedOrders; label.includeLabelInResponse for OBA |
GET /orders/{ids} | tracking, printed / manifested / shipped dates | identifiers joined by ;, max 100 |
GET /orders/{ids}/label | PDF labels (documentType=postageLabel, includeCN) | OBA only, HTTP 403 otherwise |
DELETE /orders/{ids} | cancel |
Not used: update order, return labels, manifest. HTTP 401, 403 and 429 come without a body and are mapped to readable messages; 429 is retried once.
Tests
php81 tests/unit.php and php83 tests/unit.php (129 checks) against tests/mock-server/server.js (a stand-in built from the Swagger, port 19377) and a scratch MariaDB database; node tests/e2e.js runs the browser flow on an OpenCart 4.1.0.4 dev store (62 checks). Not tested against a live Royal Mail account.
Hidden setting shipping_kv_royal_mail_base_url points the extension to the mock; it is honoured for loopback hosts only.
FAQ
Does it show live Royal Mail prices?
No. Click & Drop has no rate quote API. The price at checkout comes from the table you maintain in the Rates tab.
Do I need an OBA account?
Only for labels through the API. Without one the order is created in Click & Drop and you print and pay for the label there.
Does it mark orders delivered?
No. Click & Drop reports no delivery event; the tracking link shows it.
Which currency are the prices?
The default currency of the store; shown in the customer's currency like any shipping price.
Does it work with OpenCart 3?
No, OpenCart 4.1 only.
Does it use OCMOD?
No. A shipping extension, events and cron.
Where is the tracking number?
In the order history and on the Royal Mail tab; the customer sees it in the account.
Is it affiliated with Royal Mail?
No. Royal Mail is a trademark of its owner. The Royal Mail logo is not used.
Details
Compatibility- Version
- 1.0.1
- Compatible with
- OpenCart 4.1.0.4
- Core edits
- None
- Extension ID
- kv_royal_mail
- Developer
- Kavio Labs Software Limited
Support
Policy- Bug reports
- 1 business day
- How-to questions
- 2 business days
- Channel
- Tickets in your account
Buy with confidence
What stands behind your license
-
Tested builds
This product was tested on this build. Builds we did not test are not listed.
- OpenCart4.1.0.4
-
12 months of updates
Updates and support are included in the price. The product keeps working afterwards; renewing is optional.
How licensing works -
30-day refund
If it is not what you expected, tell us within 30 days and we refund the order.
Refund policy -
Secure checkout
Pay by card, Apple Pay or Google Pay on Stripe's secure page. Your card number never reaches our server.
Ask a pre-sales question
Sold by Kavio Labs Software Limited, registered in England and Wales No. 17532441. About us
More for OpenCart
Works well alongside it.
Server-Side Tracking: GA4, Meta Conversions API, TikTok
Extension · v1.0.1Server-side tracking for OpenCart 4.x and 3.0.x: purchases, refunds, add to cart, checkout, product views and leads go from your server to the free official GA4 Measurement Protocol, Meta Conversions API and TikTok Events API, deduplicated with the browser pixels through shared event ids. Consent-aware, SHA-256 hashed customer data, order status mapping, queue with retries, test mode and an event log. No paid relay, events only, no OCMOD.
- 4.1.0.x
- 4.0.2.x
- 3.0.x
from$59Buy
Atlas: Department Store Theme
Theme · v1.0.1The department store theme for OpenCart 4.x and 3.0.x: colour-coded departments, a department list beside the hero slider with two side promos, a big search with a department selector, tabbed product blocks, a 2 + 1 + 2 offer grid, deals of the day with real countdowns, a department showcase, a promotions band and a three-column product page with a sticky buy box. Four styles (Meridian, Harbor, Citrus, Night) and your own colours on top. Events only, no core changes.
- 4.1.0.x
- 4.0.2.x
- 3.0.x
from$129Buy
Bot & Country Blocker
Extension · v1.0.1Stop AI crawlers, scrapers, vulnerability scanners and unwanted countries before OpenCart 4.x or 3.0.x builds a page. Googlebot and Bingbot are verified by DNS and always allowed; 50+ bots get one switch each; country rules use free GeoIP databases and can close only the checkout; IP and network lists, rate limits, honeypots and the cart flood fix; a one-second challenge instead of a captcha; learning mode, dashboard, log, IP tester and Cloudflare export. No core changes, no OCMOD.
- 4.1.0.x
- 4.0.2.x
- 3.0.x
from$49Buy