WooCommerce Integration
Automatically print WooCommerce orders to a Star Micronics thermal printer — a designed receipt, packing slip, or kitchen ticket prints the moment an order comes in. No PDFs, no browser print dialog, no clicking "print" on every order.
What you need
- A WordPress site running WooCommerce 8.0+ (High-Performance Order Storage is supported).
- A Star Micronics thermal printer and the ReceiptKit bridge running on the same network (see PC Bridge Setup).
- A ReceiptKit account with a secret API key (
rk_live_…).
Printer note: this plugin prints to Star Micronics printers. If you use a different printer, see Using a different printer below.
Add a WooCommerce template
In your ReceiptKit dashboard, open the Template Gallery and clone one of the WooCommerce starters into your organization:
- WooCommerce Order – Customer Receipt — a branded receipt with items, totals, and payment.
- WooCommerce Order – Packing Slip — a no-prices pick/pack slip with the ship-to address.
- WooCommerce Order – Kitchen Ticket — a large-format prep ticket for food orders.
These are pre-mapped to the exact field names the plugin sends, so they work with no editing. You can customize the design any time in the template editor.
Copy your API key
In the dashboard, go to Settings → API Keys and copy a secret key (it starts with rk_live_). Keep it handy for step 5.
Connect the bridge to your printer
Install the ReceiptKit bridge on a computer on the same network as your Star printer and claim the printer, following the PC Bridge Setup guide. Once the printer shows up in your dashboard, you're ready to wire up WooCommerce.
Install the plugin
In your WordPress admin, go to Plugins → Add New, search for ReceiptKit for WooCommerce, install it, and activate. (Or upload the plugin ZIP via Plugins → Add New → Upload Plugin.)
After activating, a ReceiptKit item appears under the WooCommerce menu.
Connect and configure
Open WooCommerce → ReceiptKit and set:
- ReceiptKit API key — paste your
rk_live_…key and save. The page confirms the connection and loads your printers and templates. - Printer — choose the Star printer to print to.
- Template — choose the WooCommerce template you cloned in step 1.
- Print when order becomes — the order status that triggers a print (default: Processing).
- Cash drawer — open the drawer before/after printing, if you have one.
Send a test print
Click Send test print. A sample order prints on your selected printer, confirming the whole chain — WordPress → ReceiptKit → bridge → printer — works end to end.
Turn on auto-print
Check Auto-print and save. From now on, every order prints automatically when it reaches your chosen status. Each order prints once; the print is recorded as an order note.
When does it print?
The plugin prints an order the first time it enters the status you selected. Common choices:
| Status | Prints when… |
|---|---|
| Processing (default) | Payment has been received and the order is ready to fulfill. |
| Completed | The order is marked complete (e.g. handed over or shipped). |
| On hold | The order is awaiting payment/confirmation. |
What's on the receipt
The plugin maps each order to these fields, which the WooCommerce templates already use. If you build your own template, use these field names.
| Field | From the WooCommerce order |
|---|---|
storeName | Your site name |
orderNumber | Order number |
orderDate | Order date/time |
items[] | Line items — name, sku, qty, price, total |
subtotal, discount, shipping, tax, total | Order totals (currency-formatted) |
paymentMethod | Payment method title |
customerName, customerEmail, customerPhone | Billing contact |
shippingAddress, billingAddress | Formatted addresses |
customerNote | Customer order note |
Using a different printer
ReceiptKit currently prints to Star Micronics thermal printers. If you use an Epson or another brand, open WooCommerce → ReceiptKit and use the Request printer support form to tell us the make and model. We add printer support based on demand and will email you when yours is supported.
Troubleshooting
Nothing prints when an order comes in
Confirm Auto-printis on and the order actually reached your trigger status. Check the order's notes — the plugin records a note on every print attempt, including the error if it failed.
"Could not connect to ReceiptKit"
The API key is missing or invalid. Use a secret key (rk_live_…), not a public key, and make sure it hasn't been revoked.
Test print fails with "No printer found"
The bridge must be running and the printer claimed in your dashboard. See PC Bridge Setup.
Monthly print limit reached
Prints are counted against your plan. If you hit the limit, upgrade in Billing.
Related
- Supported Printers
- PC Bridge Setup
- REST API Reference — for building your own integration