
Printful Print-on-Demand for OpenCart — orders to Printful, tracking and shipping rates (USA)
Printful for OpenCart 4.x, 3.x, 2.3 (USA): linking products and sending orders free; Pro adds automatic sending, rates at checkout and webhooks. A licence for life.
- Compatibility
- OpenCart 4.0.2.x–4.1.x, 3.0.x, 2.3.0.2 · interface language: English
- Version
-
v1.0.0 (OpenCart 4)
v1.0.0 (OpenCart 3.x)
v1.0.0 (OpenCart 2.3) - Licence
- a site + a staging copy, lifetime
- Trial
- 7 days, no card, one per site
- Updated
- 14.11.2026
What Free has,
and what Pro adds
The free version works with no time limit. Pro adds the rest of the features in the table.
Key points
What the seller gets
An order from your store reaches Printful as a draft: until the draft is confirmed nothing is charged and nothing is printed.
In the admin
The “Connection” tab: the private token from the Printful Developer Portal and an optional Store ID for an account-level token.

The trial starts when you ask
A fresh install is the free version, nothing switches on by itself. The “Try Pro for 7 days” button → e-mail → the key right in the window and by e-mail.

One key — a site and a staging copy
Moving the site? Unlink the licence on the old domain and activate it on the new one yourself. A staging copy (staging., dev.) works with the same key and does not take a site slot. For studios — keys for 5 or 25 sites, or unlimited.
Technical requirements
OpenCart 4.0.2.x–4.1.x, 3.0.x or 2.3.0.2; the cURL extension; PHP 7.0 or newer.
A Printful account and a private token with the scopes orders, sync_products, webhooks; an account-level token also needs a Store ID.
Automatic confirmation in Pro charges the card of your store at Printful, so it is off by default; the “Confirm for fulfillment” button asks you to confirm the amount.
There is no import of products from Printful into OpenCart: you create the products in OpenCart by hand and the module links them (by hand, or in Pro automatically by SKU and option names).
Order lines are matched by option values. Text and file options (personalisation) do not pass a design to Printful: the file of the sync variant is printed.
A Printful store has one webhook address: registering replaces the address set by another integration; the admin shows a warning.
Without PHP-FPM background sending runs by cron: the OpenCart 4 scheduler every hour, OpenCart 3.x and 2.3 a server cron on the address from the “Automation” tab (every 5 minutes). The admin says so.
When the buyer did not pick a Printful rate, the default method (STANDARD) is used, and the shipping price for the buyer may differ from the Printful cost. The Printful limit on rates is 5 requests per minute.
The interface language is English (en-gb and en-us).
Version history
For OpenCart 4.x, 3.x and 2.3: linking products to Printful sync products, sending orders as drafts, status and tracking, an e-mail to the buyer, duplicate protection.
Frequently bought with Printful Print-on-Demand


Shippo & EasyPost Shipping Labels for OpenCart 2.3, 3.x and 4.x — live USPS, UPS, FedEx and DHL rates and labels

Sales Tax Nexus Monitor for OpenCart 2.3, 3.x and 4.x — US state economic nexus thresholds

Prop 65 Warnings for OpenCart 2.3, 3.x and 4.x — California warnings on the product, cart and checkout
Full module description
Printful Print-on-Demand for OpenCart 4.x, 3.x and 2.3 passes the orders of your store to Printful: OpenCart products are linked to Printful sync products by option values, and a panel on the order page sends the order to Printful and shows the status, the Printful costs and the tracking of shipments. The integration uses a Printful private token through API v1.
What you need from Printful. A Printful account, a store of the “Manual order platform / API” type and a private token with the scopes orders, sync_products and webhooks. Products in Printful are created as sync products: the module does not import products from Printful into the OpenCart catalogue, so you create the products in OpenCart by hand and the module links them.
What the seller gets
An order from your store reaches Printful as a draft: until the draft is confirmed nothing is charged and nothing is printed. The order page shows which lines are linked to Printful and which are not, and only the linked lines are sent. The “Send to Printful as draft” button passes one order with a unique external_id that carries the store prefix, the retail prices and a packing slip with your contacts.
Linking is the “Product links” page: find a product of your store, pick its Printful product, load the variants and set the option values for each one (for example Size: M). Two variants with the same options cannot be linked. Order lines are matched to variants by option values, the closest match wins, and extra options such as gift wrapping do not get in the way.
When Printful ships a package, the order shows the carrier, the tracking number and the date, the order history gets a note, and the buyer gets an e-mail with the tracking link (the e-mail can be switched off in the settings). The journal under the panel shows each step: draft, confirmed, shipped.
In the admin
The “Connection” tab: the private token from the Printful Developer Portal and an optional Store ID for an account-level token. The “Save and check connection” button shows the name of the Printful store and the number of products in it, and if a scope is missing it says which one. A Printful token has an expiry date (up to two years): after it Printful answers 401, the module shows a clear message, and the token has to be replaced by hand.
The “Orders” tab: the default Printful shipping method (STANDARD, used when the buyer did not pick a Printful rate at checkout), the contacts and the message for the packing slip, the tracking e-mail for the buyer. Orders go to Printful as drafts; you can confirm a draft in your Printful dashboard.
The “License” tab: a Pro key or a 7-day trial. Without a key the Pro tabs show an explanation and the free part keeps working.
The “Checkout rates” tab (Pro): live Printful rates for the buyer address and the Printful items of the cart appear at checkout as shipping methods. A percentage markup, a fixed fee and free shipping above a subtotal can be added to a rate (amounts in USD). A 0.00 rate and an unknown currency are not shown, answers are cached for 10 minutes, and after a Printful failure the method is hidden for 60 seconds so that checkout does not wait. For a cart with mixed products (some you ship yourself) you choose a policy: hide the Printful rates or show the rate for the Printful items only.
The “Automation” tab (Pro): the order statuses at which an order goes to Printful by itself, a draft or an immediate confirmation, the OpenCart status after shipping (only between “processing” and “complete”, so stock is never moved twice) and disabling a product when none of its linked variants is left at Printful. Webhooks are registered, checked and removed from the admin: Printful reports status changes and shipments at once, and the order is read again from the API, so an older answer never rolls a status back. Background work runs from the OpenCart 4 scheduler every hour and from page views; a server cron speeds it up.
The “Printful orders” list in the Sales menu: the filters “In queue”, “Drafts”, “In progress”, “Need attention”, “Finished” and “Product links”, sending and refreshing several orders by ID, and in Pro also bulk actions and the journal of calls.
How it works, step by step
- Install the archive for your OpenCart version and install the extension in Extensions → Extensions → Shipping.
- In the Printful Developer Portal create a private token for a “Manual order platform / API” store with the scopes orders, sync_products and webhooks.
- On the “Connection” tab paste the token and press “Save and check connection”.
- Create a product with options in OpenCart (for example Size) and link it to a Printful sync product on the “Product links” page.
- Open an order, see which lines will go to Printful and press “Send to Printful as draft”. Confirm the draft in your Printful dashboard.
- For Pro: a key or a trial on the “License” tab, then rates at checkout, automatic sending and webhooks.
Under the hood
- Printful API v1: /stores, /store/products, /orders (draft and confirm), /orders/{id}, /shipping/rates, /webhooks; the token goes in the Bearer header, is stored encrypted and never reaches the log; an account-level token adds X-PF-Store-Id.
- Sending: the order external_id with the store prefix; on an unknown answer the module looks the order up by external_id, and an “order already exists” answer is linked to the existing order, so there is no duplicate.
- The Pro queue: up to 8 attempts with a growing pause, sending right after the buyer gets the answer (fastcgi_finish_request) and the OpenCart 4 cron or a URL cron.
- Webhooks: a key in the URL, idempotency by event, the order read again from the API; a round of polling of open orders covers missed events.
- Pro rates: the Shipping Rate API, a 10-minute cache, a 60-second pause after a failure and a short timeout so that checkout does not hang.
Installation
- Extensions → Installer: upload the archive for your version without renaming the file (OpenCart 4 — cc_printful.ocmod.zip, 3.x — cc_printful-oc3.ocmod.zip, 2.3 — cc_printful-oc23.ocmod.zip; for 2.3 copy the contents of the upload/ folder to the store root).
- For 3.x and 2.3: Extensions → Modifications → Refresh.
- Extensions → Extensions → Shipping → Printful Print-on-Demand: install it and open the settings.
- On the “Connection” tab paste the token and press “Save and check connection”.
- For Pro: enter a key or start the trial on the “License” tab.
Questions
about the module
Didn't find the answer? Message us on Telegram and we'll reply within a business day.
Is this an official Printful module?
No, it is an independent integration with Printful by CatCode. Printful is a trademark of its owner.
What do I need to start?
A Printful account, a store of the "Manual order platform / API" type and a private token with the scopes orders, sync_products, webhooks.
Does the module import products from Printful?
No. You create the products in OpenCart by hand and the module links them to Printful sync products: by hand on the "Product links" page, and in Pro automatically by SKU and option names.
When does Printful charge money?
The free version passes the order as a draft: nothing is charged or printed until you confirm the draft in your Printful dashboard. Pro has a "Confirm for fulfillment" button with an amount confirmation and an automatic confirmation mode; it charges the card of your store at Printful and is therefore off by default.
What if Printful does not answer?
The module does not create a duplicate: it looks the order up at Printful by external_id and links the existing one to the order. In Pro the queue retries up to 8 times.
Can I pass the design of the buyer?
No. The file of the sync variant is printed; text and file options are not passed to Printful.
What about shipping rates at checkout?
That is Pro: live Printful rates for the buyer address, with a markup, a fixed fee and free shipping above a subtotal. For an address without a US state and for a cart with other products there are no Printful methods by default.
Can I keep a webhook that is already set?
A Printful store has one webhook address. Registering from the module replaces the existing one, and the admin warns about it.
Which OpenCart versions?
OpenCart 4.0.2.x–4.1.x, 3.0.x and 2.3.0.2: three separate archives in one product.
Is the licence for life?
Yes, for OpenCart it is one payment and a licence for life, for two sites.
What happens after the trial?
Pro switches off, orders in the queue stop with a reason, and the free part keeps working.
No reviews yet. Be the first.
No questions yet. Ask one — we answer within 24 hours.
Not quite what you are looking for?
We build custom modules for WordPress, WooCommerce, OpenCart and Shopify. Tell us about the task and we'll prepare an estimate.
Order a custom module
Buying the module
—
Charged in UAH; your bank converts it to your currency. EUR price is approximate.




















