Black November: −35% on all modules until 30 November Black November: −35% until 30 November Choose a module

Get in touch
OpenCart

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.

Pro · lifetime licence Staging copies are included. The more sites, the cheaper each one
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
Or all 509 Pro modules with All Access — 3 244 UAH / year ≈ €66

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.

Feature Free Pro
Connection with a Printful private token, the token encrypted, a Store ID for an account-level token ✔ ✔
Linking OpenCart products to Printful sync products by option values ✔ ✔
A Printful panel in the order: which lines will go, sending as a draft, status refresh, cancelling a draft ✔ ✔
Printful costs, shipments with the carrier and tracking in the order ✔ ✔
A note in the order history and an e-mail to the buyer with the tracking ✔ ✔
Duplicate protection by external_id ✔ ✔
A "Printful orders" list in the Sales menu with filters ✔ ✔
Contacts and a message for the packing slip, the default Printful shipping method ✔ ✔
Interface in English ✔ ✔
Automatic sending by order status with a queue and retries — ✔
A "Confirm for fulfillment" button with an amount confirmation and an automatic confirmation mode (off by default) — ✔
Live Printful rates at checkout with a markup, a fee and free shipping above a subtotal — ✔
Printful webhooks: registering and checking from the admin — ✔
The "shipped" status in OpenCart — ✔
Automatic linking of products by SKU and option names — ✔
An availability check of variants every 6 hours — ✔
Bulk sending and refreshing of orders — ✔
A journal of Printful calls — ✔

What it looks like

Printful panel in the order
The “Printful” panel on the order page: which lines are linked, the draft at Printful, the Printful costs and the buttons.
Linking products to Printful
The “Product links” page: a store product, a Printful product, option values for each variant.
A shipped order with tracking
A shipped order: the carrier, the tracking and the journal of steps.

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

v1.0.0 Current 14.11.2026

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

All Access Need more? All modules (509) under one licence, new ones are added automatically. 3 244 UAH≈ €66 Learn more →

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

  1. Install the archive for your OpenCart version and install the extension in Extensions → Extensions → Shipping.
  2. In the Printful Developer Portal create a private token for a “Manual order platform / API” store with the scopes orders, sync_products and webhooks.
  3. On the “Connection” tab paste the token and press “Save and check connection”.
  4. Create a product with options in OpenCart (for example Size) and link it to a Printful sync product on the “Product links” page.
  5. Open an order, see which lines will go to Printful and press “Send to Printful as draft”. Confirm the draft in your Printful dashboard.
  6. 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

  1. 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).
  2. For 3.x and 2.3: Extensions → Modifications → Refresh.
  3. Extensions → Extensions → Shipping → Printful Print-on-Demand: install it and open the settings.
  4. On the “Connection” tab paste the token and press “Save and check connection”.
  5. 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.

@catcode_support Setup, compatibility, activation
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.

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