Epson Receipt Printer Not Printing from a Web App

Your Epson TM-T88, TM-T20, TM-m30 or other TM series printer works from the vendor utility, but not from your website, web app or online ordering system. Almost every case comes down to one of six causes. Work down the list in order.

Why web apps and receipt printers don't mix

A browser cannot open a socket to a printer. The two ways around that are a print dialog, which needs an OS driver on every machine and someone to click Print, or a small program on the local network that accepts jobs from the cloud and speaks ESC/POS to the printer. Epson's own answer is ePOS-Print and Server Direct Print, which work but need the printer's web service enabled, certificates managed on each printer for HTTPS pages, and your own server to poll. ReceiptKit's bridge is the same idea with the certificates, polling and rendering handled for you.

Symptom, cause, fix

1. Nothing happens, browser console shows a blocked request or CORS error

Cause. The page is served over HTTPS and tried to talk to the printer over plain HTTP on the LAN. Browsers block that as mixed content, and the printer's own web service usually has a self-signed certificate the browser will not trust.

Fix. Stop printing from the browser directly. Send the job to a service that reaches the printer from inside the network — the ReceiptKit bridge does this over MQTT, so the browser only ever talks to receiptkit.io.

2. Printer never shows up in a scan

Cause. Epson TM printers fall back to a fixed address when DHCP gives no answer (often 192.168.192.168), so the printer is on a different subnet from everything else.

Fix. Print the self-test sheet (hold Feed while powering on), read the IP, and move the printer onto your network. Step-by-step in Printer Not Found.

3. Windows bridge sees the printer over USB but jobs fail

Cause. Epson USB printers on Windows enumerate as a vendor-class device and need Epson's Advanced Printer Driver (APD) installed once so the port exists. Star and generic ESC/POS printers do not need this.

Fix. Install Epson APD for your model, reconnect the USB cable, and rescan. Raspberry Pi and macOS bridges talk to the printer directly and need no driver.

4. Jobs are accepted but nothing prints, printer light is flashing

Cause. The printer is in an error state — cover open, paper out, paper jam, or the cutter is stuck. Jobs queue until it clears.

Fix. Reseat the paper roll so it feeds from underneath, close the cover firmly, and power-cycle. The bridge reports cover-open and paper-out live on the Devices page so you can see this before sending.

5. Right side of the receipt is cut off, or text wraps strangely

Cause. The receipt was rendered for 80 mm paper (576 dots) but the printer or roll is 58 mm (384 or 512 dots), or vice versa.

Fix. Set the paper width on the printer in the dashboard, or pass dotWidth on the print call to match the roll.

6. Printer works from one computer but not the bridge

Cause. The printer is connected by both USB and Ethernet, or another application is holding the USB port open. TM printers answer on one interface at a time.

Fix. Use a single connection, and close any vendor utility (EpsonNet Config, TM Utility) that may still have the printer open.

A 5-minute test that isolates the problem

  1. Print the self-test sheet. If it prints, the printer, paper and cutter are fine and the problem is on the network or software side.
  2. Note the IP address on the sheet. If it is not on the same range as your computer, follow Printer Not Found.
  3. Install the free bridge on a PC, Mac or Raspberry Pi on the same network (PC setup / Pi setup) and let it discover the printer.
  4. Send a test receipt from Dashboard → Print Receipt. If that prints, the printer is ready and any remaining issue is in your integration's API call or template.

Model notes

  • TM-T88V / VI / VII, TM-T20 II / III, TM-m30 / m30II / m50: ESC/POS over Ethernet, Wi-Fi or USB. Tested end-to-end on a TM-T88VI over both USB and Ethernet; cover-open and paper-out are reported on every connection.
  • Windows + USB: needs Epson APD once per machine. See the driver table in Supported Printers.
  • Clones that report an Epson USB descriptor: many generic printers identify as a TM-m30II. They print fine; rename the device in the dashboard if the label bothers you.

Still stuck?

Send us the self-test sheet and the bridge's Devices page screenshot from the contact form and we will tell you which of the six it is.