Printers Documentation
Complete guide to configuring printers with Flip POS. Flip POS supports two printer integration methods: Epson Server Direct Print and Star Micronics CloudPRNT. Multiple printers can be configured to support different stations in your kitchen or bar.
Overview
- Epson Server Direct Print — Epson OmniLink and TM-i series printers with built-in LAN connectivity
- Star Micronics CloudPRNT — Star TSP100III/IV, mC-Print2, mC-Print3, TSP650II, TSP700II, and more
- Multiple Printers — configure as many printers as your operation requires
- Printer Routing — route specific menu categories to the printer of your choice (e.g., hot food to the kitchen printer, drinks to the bar printer)
How Each Integration Works
Epson Server Direct Print: The Flip POS server pushes print jobs directly to the printer over your local network using Epson's Server Direct Print protocol. The printer must have an IP address reachable from the internet (or you must configure your router accordingly).
Star Micronics CloudPRNT: The printer polls the Flip POS server on a regular interval — no inbound network access to the printer is required. The printer reaches out to Flip POS over the internet, checks if there is a job waiting, and pulls it down to print. This makes Star CloudPRNT printers easy to set up on any standard internet connection without any router or firewall configuration.
Supported Printer Models
Epson — Server Direct Print
- OmniLink TM-T88VII
- OmniLink TM-m50II-H
- OmniLink TM-m50II
- OmniLink TM-m30III
- TM-T88V-DT
- TM-T88V-i
- TM-T70II-DT
- TM-T70-i
- TM-H6000IV-DT
- TM-T82II-i
- TM-L90-i
Star Micronics — CloudPRNT
The following models have CloudPRNT built in:
- mC-Print2 — compact receipt printer with built-in CloudPRNT
- mC-Print3 — compact receipt printer with built-in CloudPRNT (most popular for restaurant use)
- TSP143III (TSP100 III generation) — LAN and wireless variants include CloudPRNT
- TSP143IV (TSP100 IV generation) — built-in CloudPRNT
The following models support CloudPRNT via the IFBD-HI01X add-on interface board (sold separately by Star Micronics):
- TSP650II
- TSP700II
- TSP800II
- SP700 (impact dot matrix kitchen printer)
Note: The printer must be connected via Ethernet (wired LAN) or WiFi. USB-only printers cannot use CloudPRNT.
Flip POS Printer Setup
All printers — regardless of brand — are first added in the Flip POS admin. This generates the credentials and URL you will use to configure the printer hardware.
- Go to Settings → Printers in the Flip POS admin
- Click "Add Printer"
- Enter a Printer Name (e.g., "Kitchen Printer", "Bar Printer")
- Select a Service Location — the Shopify POS location this printer belongs to
- Select the Printer Type:
- Epson — for Epson OmniLink/TM-i series printers using Server Direct Print
- Star Micronics (CloudPRNT) — for Star TSP100, mC-Print, and TSP650/700/800 series printers
- Click "Create Printer"
- After creation, the printer's detail card will display:
- URL — the server URL to enter into your printer's settings
- Printer ID — used as the username for authentication
- Password — a 6-digit password for authentication
- Keep this information on screen — you will need it when configuring the printer hardware in the steps below
Epson Printer Configuration
Configure your Epson printer to connect to Flip POS using Server Direct Print.
- Power on your Epson printer. It will print a startup receipt showing its LAN IP address. Enter that IP address into your web browser (e.g.,
http://192.168.1.172) to open the printer's settings page. - Click Advanced Settings
- Click Administrator Login
- Enter the printer's serial number as the password
- Click TM-i Settings
- Click Server Direct Print
- Enable Server Direct Print
- Enter the connection details from your Flip POS printer card:
- Server 1 - URL → paste the URL from Flip POS
- ID → enter the Printer ID from Flip POS
- Password → enter the Password from Flip POS
- Click Apply then Restart
- Click OK to confirm the restart
Star Micronics CloudPRNT Configuration
Star Micronics printers use CloudPRNT — a pull-based protocol where the printer regularly polls the Flip POS server for waiting print jobs. This means no port forwarding or firewall changes are needed on your restaurant's network. The printer reaches out to the internet on its own.
How CloudPRNT Works
Once configured, the Star printer sends a request to the Flip POS server every few seconds. If a print job is waiting (for example, an order was just sent to the kitchen), the printer pulls the job down and prints it automatically. If there is nothing to print, it simply waits and checks again on the next interval.
Step 1 — Find the Printer's IP Address
You need the printer's IP address to access its settings page.
- Hold the Feed button while powering on the printer (or hold Feed for 5 seconds while it is running) — the printer will print a self-test page showing its current IP address
- Alternatively, check your router's connected devices list
Step 2 — Open the Printer's Settings Page
- On a computer or phone connected to the same WiFi or network as the printer, open a web browser
- Enter the printer's IP address in the address bar (e.g.,
http://192.168.1.100) - The Star printer settings page will load
- Log in with the default credentials:
- Username:
root - Password:
public
- Username:
Step 3 — Configure CloudPRNT
- In the printer's web admin, navigate to the CloudPRNT section
- Set CloudPRNT Service to Enable
- In the Server URL field, paste the URL from your Flip POS printer card (it will look like
https://flip-pos.fly.dev/api/cloudprnt/YOUR-PRINTER-ID) - In the User Name field, enter the Printer ID from your Flip POS printer card
- In the Password field, enter the Password from your Flip POS printer card
- Set the Polling time to 5 seconds (this controls how quickly new jobs appear — lower is faster)
- Important for TSP650II, TSP700II, TSP800II, SP700 with IFBD-HI01X board: these models default to 120 seconds — you must change this to 5–10 seconds or kitchen tickets will be severely delayed
- Leave HTTPS trust level set to the default (standard CA certificates) — Flip POS uses a standard SSL certificate that the printer will trust automatically
- Click Save
- Click Restart to apply the settings — the printer will be offline for about 30–60 seconds while it reboots
Step 4 — Verify the Connection
- After the printer restarts, go back to Settings → Printers in the Flip POS admin
- Find your Star printer and click "Test Connection" or send a test print
- If connected successfully, the printer will print a test ticket within a few seconds
- If it does not respond, double-check the URL, Printer ID, and Password are entered exactly as shown in Flip POS
Star Printer Network Setup
WiFi Configuration
For Star printers with built-in WiFi (such as the TSP143IIIW and mC-Print3 with WiFi):
- In the printer's web admin, navigate to the WLAN or Wireless LAN settings section
- Enter your restaurant's WiFi SSID (network name) and password
- Save and restart the printer
- After reboot, the printer will connect to your WiFi — print a self-test page to confirm the new IP address
For older Star printers without built-in WiFi, a Star Micronics WiFi dongle (connected via USB) can be configured in the same WLAN settings section.
Assigning a Static IP (Recommended)
We recommend assigning a static IP address to your Star printer so its admin page is always accessible at the same address. This does not affect CloudPRNT operation (the printer calls out to Flip POS, not the other way around), but it makes future configuration changes easier.
- In the printer web admin, navigate to the IP Parameters or TCP/IP section
- Switch the IP assignment from DHCP to Static
- Enter the same IP address currently shown on the self-test page (this locks in the address the printer already has)
- Enter the Subnet Mask and Default Gateway (also shown on the self-test page)
- Save and restart
Kitchen Printing
Optimize kitchen workflows with printer routing and ticket content.
Kitchen Ticket Content
Kitchen tickets printed by Flip POS include:
- Order number and table information
- Order time
- Menu items with quantities
- Modifiers and customizations
- Item-level and order-level notes
Printer Routing by Category
You can configure each printer to only print tickets for specific menu categories — for example, sending hot food orders to the kitchen printer and drink orders to the bar printer.
- Go to Settings → Printers
- Find the printer you want to configure and click the category routing button
- Uncheck "Print All Orders" if it is enabled
- Select the specific menu categories whose items should print on this printer
- Save — only orders containing items from those categories will now trigger this printer
Customer Check Printing
In addition to kitchen tickets, Flip POS can print a customer-facing check — an itemized bill showing the subtotal, tax, any auto gratuity, and the total. Both Epson Server Direct Print and Star Micronics CloudPRNT printers support customer check printing.
What Prints on a Customer Check
- Restaurant name and check number
- Server name and table number
- All items with quantities and prices
- Item-level modifiers
- Subtotal
- Tax
- Auto gratuity (if configured and applicable)
- Total
- Date and time
How to Print a Customer Check
- In the Table Service app, navigate to the table you want to print a check for.
- Click the "Actions >" link in the top right of the Table # screen.
- Click "Print Check". This button only appears once at least one item on the table has been sent to the kitchen.
- Flip POS sends check print jobs for all active checks on the table simultaneously to all configured printers for that service location.
- A toast notification confirms the check was sent to the printer.
Note: A printer must be configured in Flip POS Settings and associated with the correct service location for this button to work.
Check Printing with Star CloudPRNT
Star CloudPRNT printers fully support customer check printing. When a check print job is queued, the printer pulls the job on its next poll interval (typically within 5 seconds if polling time is set to 5 seconds) and prints the formatted check automatically. No additional configuration beyond standard CloudPRNT setup is required.
Automatic Printing
Flip POS automatically triggers printing when orders are sent to the kitchen. No manual action is required by staff beyond their normal workflow.
Print Triggers
- Table Service: When the "Send to Kitchen" icon is tapped on a table's check, all pending items are sent to all configured printers for that service location
- Quick Serve: When "Send to POS Cart" is tapped on an order, a kitchen ticket is printed automatically
- QR Code Orders (Auto-Approve): When a customer submits a QR order and auto-approve is enabled, a kitchen ticket prints immediately
If no printers are configured in Settings for the relevant service location, no printing will occur. The order will still appear on any configured Kitchen Display System.
Troubleshooting
Epson Printer Not Printing
- Verify the printer is powered on and connected to the network
- Confirm the IP address on the self-test page matches what is configured in your router
- Re-open the printer's web admin and verify the Server Direct Print URL, ID, and Password match what Flip POS shows exactly
- Click Apply and Restart in the printer admin after any changes
- Check that the printer has paper loaded and is not in an error state
Star Printer Not Printing
- Print a self-test page (hold Feed while powering on) and confirm the printer shows a network IP address — if it shows 0.0.0.0, the printer is not connected to the network
- Open the printer's web admin and verify CloudPRNT is Enabled and the Server URL, User Name, and Password match what Flip POS shows exactly — copy-paste rather than typing manually to avoid errors
- Confirm the polling time is set to 5–10 seconds — the default of 120 seconds on some models means you may be waiting up to 2 minutes for each job
- After any change, click Save then Restart in the printer admin — changes do not apply until the printer reboots
- Verify the printer has network access to the internet — CloudPRNT requires the printer to be able to reach
flip-pos.fly.dev - If using WiFi, check that the printer is connected to the correct network and the signal is strong enough
Star Printer Connected But Jobs Are Delayed
- Check the Polling time setting in the CloudPRNT section of the printer admin — it should be set to 5 seconds
- On TSP650II, TSP700II, TSP800II, and SP700 printers using the IFBD-HI01X interface board, the factory default polling time is 120 seconds — change this to 5–10 seconds
Getting Support
- Contact support at
support@flip-pos.com - Include your printer model, printer type (Epson or Star), and a description of the issue
- If possible, include the error message shown in the Flip POS printer settings