EP Ecommerce — Printful

EP Ecommerce — Printful is the Printful connector for EP Ecommerce — POD, the print-on-demand engine. It is deliberately thin: it holds your Printful credentials and a Test Connection check, and it teaches the engine how to talk to Printful’s API. Everything else (syncing your catalogue, the storefront, checkout, shipping quotes, order routing, and tracking) lives in the engine.

Published by ElmsPark Studio.

What this plugin does

• Stores your Printful API Token and Store ID.
• Provides the Test Connection button, which confirms the link, lists your stores, and fills in your Store ID.
• Connects the POD engine to Printful so the engine can sync products, quote shipping, route paid orders, and pull back tracking.

On its own it does nothing visible. It is one half of a pair: the engine does the work, this connector supplies the Printful account. Other print-on-demand providers can be added as sibling connectors in the same way.

Requirements

• PageMotor 0.7 or later
• EP Ecommerce 0.1.22 or later — adds the generic pod product type the engine uses.
• EP Ecommerce — POD — the engine that does the actual work.
• EP Ecommerce — Stripe — for taking card payment.
• A Printful account with a Manual order / API store, and an API token for that store.

Important: you need a “Manual order / API” store

This is the one thing that catches people out. Printful only opens its products and orders API on a store of type Manual order platform / API. A Printful store that is already linked to Shopify, WooCommerce, Etsy or similar will refuse the connection with a message like “applies only to Manual Order / API platform”.

The reason is simple: PageMotor is your shopfront here, and Printful is fulfilment only. So in Printful, open Stores, add a store, choose Manual order platform / API, then create the token for that store.

The Test Connection button checks this for you. It lists every store on your account, marks which are usable, and warns you clearly if none of them is a Manual order / API store.

Installation

Install in this order, activating each before the next:

1. EP Ecommerce (0.1.22+).
2. EP Ecommerce — POD (the engine).
3. EP Ecommerce — Printful (this connector).
4. EP Ecommerce — Stripe (card payment).

Database tables are created automatically on first load.

Setup

1. Open Plugin Settings → EP Ecommerce — Printful.
2. Paste your Printful API Token. Create one on the Printful Developers page (Settings, Developers, add a private token with store scopes).
3. Click Test Connection. It works from the token you have just typed, so there is no need to Save first. It confirms the link, lists your stores, and fills in the Store ID of your Manual order / API store automatically (most accounts have one usable store).
4. Click Save.

That is all you do here. Everything else (enabling print-on-demand, syncing products, delivery pricing, and fulfilment) happens on the EP Ecommerce — POD settings page.

Troubleshooting

Test Connection says none of your stores is a “Manual order / API” store

Your token is valid, but the store it points at is linked to another platform (Shopify, WooCommerce and so on), which Printful does not open to this API. In Printful, open Stores, add a store, choose Manual order platform / API, then generate a token for that store and paste it here.

Test Connection fails outright

Check the token is current and has not been revoked, and that it carries store scopes. Generate a fresh one on the Printful Developers page and try again. A 401 means the token is invalid or expired.

Everything is connected here, but nothing syncs

Syncing lives in the engine, not in this connector. Open EP Ecommerce — POD, tick Enable print-on-demand, then click Sync products. See the EP Ecommerce — POD page.

Feedback and corrections

For a quick question about this plugin, EP Support inside your admin is the fastest option. The chat widget sits on every EP plugin settings page and knows which one you’re on.

For anything bigger, like a bug report, a feature request, or a “how do I…” that needs a real reply, open a ticket at help.elmspark.com. A real person, helped by AI, writes the reply, usually within a few hours.

Changelog

1.0.8

• Fixes stored keys and passwords reading as empty after a PageMotor 0.11.3 or 0.11.4 update. After the core update, every secret this plugin had encrypted at rest came back blank, so anything that needed it failed with an authentication error until the value was typed in again. Nothing was deleted: the encrypted value was still in the settings row, but PageMotor 0.11.3 moved the site secret that opens it, and this plugin was still looking in the old place. It now finds the secret in both places, so an existing value opens again without re-entry, and a value that was re-entered in the meantime keeps working and is moved back under the site secret.
• If you updated PageMotor and then re-entered a key or password, there is nothing to do. If you updated and have not re-entered it, this release restores it on the next page load.

1.0.7

• Your Printful API token is now stored encrypted. Until this release it sat in plain text in the plugin’s settings, where anyone holding an API or MCP connection to your site with permission to configure plugins could read it straight back out. Your site’s visitors were never able to see it.
• Existing sites convert themselves the next time the plugin loads, once. There is nothing to re-enter and no key to replace.
• Reading your settings over the API now returns a placeholder rather than the value, and writing that placeholder back leaves the stored secret untouched. Clearing it by submitting an empty value still works as before.
• On hosting without encryption support the previous behaviour is kept and the reason is written to the log, because quietly discarding a working key would be worse than the exposure this closes.