Cloud Receipt Printing | Troubleshooting

📖 Overview

This guide covers common issues, error messages, and fixes when using Cloud Receipt Printing. Troubleshooting focuses on both USB and Network printer setups, as well as Print Controller misconfiguration.

🔐 Access Required: Visit: yourinstance-devices.ordernext.com to use Canopy 2.0's Devices App.

If you can't access the site, contact your Account Manager or venuesupport@shift4.com.

🔍 Quick Checks

Before diving into specific errors, complete these steps:

1. Confirm the Print Controller displays a Print Icon in the top-right corner of the STV POS app.
   
   
2. If missing, tap Hamburger Menu > Refresh Config.
3. If still missing:
   • Check the Device ID in Debug Info
   • Match it with the correct device in Canopy 2.0
   • Reboot the device if needed
4. In Canopy 2.0 > Printers, confirm the Receipt Printer slider is set to ON
   
   
5. Reassign the correct printer and refresh config again if necessary

🧪 Common Error Messages & Fixes

❌ Error 1: "There was an error printing the receipt"

Cause: The Print Controller is incorrectly assigned or unreachable

Fix:

• Go to Canopy 2.0 > Devices > Printers
• Locate the printer and verify the correct Print Controller is set
• If incorrect, update and SAVE
• Refresh the Print Controller in STV App
• Ensure:
  • The Print Controller is online and network-connected
  • It is on the same POS VLAN as other devices
     

❌ Error 2: "Print Failed: Communication could not be established"

Cause: The POS device trying to print has no printer assigned

Fix:

• In Canopy 2.0 > Devices > Configurations
• Assign a Receipt Printer to the device
• Save and Refresh Config on that terminal
   

❌ Error 3 (USB Only): "An invalid parameter was passed"

Cause: USB Printer is not connected properly

Fix:

• Ensure USB printer is powered on
• Check both ends of the USB A to 2.0 cable
  • Printer side should click into place
  • Workstation side should plug into 2.0 port on the hub

• If needed, test other USB ports or reboot the hub and device
   

❌ Error 4 (Network Only): "Failed to open the device"

Cause: Printer is offline or unreachable on the network

Fix:

• Confirm printer is powered on
• Verify network indicators:
  • Epson: Look for Ethernet or WiFi symbol
  • Star: Look for solid green LED
• Confirm the printer has a Static IP or is DHCP Reserved and is on the correct POS VLAN
• In STV App > Debug Info > Printing, check the Printer Status
  • If it shows FAILED, the printer isn't reachable by the Print Controller

🧠 Two Common Network Mistakes

• Mismatched connection types (WiFi vs LAN)
  • Ensure network "Bridging" (aka Crosstalk) is enabled
• Wrong VLAN or SSID
  • Printer and Print Controller must be on the same POS VLAN/WiFi

🕰️ Long Gap Between Uses?

If your Cloud Receipt setup hasn’t been used in a while:

Check These First:

• Ensure Print Controller is on and connected
• Reboot and refresh config on each terminal

Ask Yourself:

• Has the network changed?
  • You may need to factory reset printers and reassign Static IPs
  • Recheck VLAN alignment
• Were there power outages?
  • Devices and printers may have reset or lost configs
• Have devices been swapped out?
  • Reassign new devices using:
    • Cloud Receipt Printing | Setup Guide