Receipt Printing

Receipt printing lets your merchants keep their paper workflow: receipts and kitchen order tickets (KOTs) print directly from the partner app the moment an order arrives, so outlet staff never re-type an order. Printing is configured per device, by the merchant, in the partner app — your team’s role as the marketplace operator is mostly to know the options and guide merchants to the right setup during onboarding.

What gets printed

Document	For	Contents
Receipt	The customer / counter	Items and prices, taxes and charges, total, payment status, order number, branding
Kitchen order ticket (KOT)	The kitchen / fulfillment station	Items, quantities, variants and add-ons, notes — no prices

Order cards in the partner app have manual Print and Print KOT buttons, and the Auto-Print on New Order toggle prints automatically as orders arrive — the usual choice for busy outlets.

Printer types

In the Printer tab, the merchant picks a printer type:

Type	What it is	Best for
Bluetooth	Thermal receipt printer paired over Bluetooth	The common counter setup — inexpensive and portable
Capacitor Bluetooth	An alternate Bluetooth connection mode	Try it if a printer won’t connect via the standard Bluetooth type
Sunmi	The built-in printer on Sunmi Android terminals	One-device counter setups — no pairing at all
Network	A printer reachable on the outlet’s network, configured by IP address and port	Fixed kitchen or counter printers on LAN
PrintNode	Cloud printing to a printer attached to a computer, addressed by printer ID	Printers far from the staff device; multi-station setups
None	Printing disabled on this device	Devices that only monitor orders

Connecting a Bluetooth printer

Choose the Bluetooth type, tap Scan for devices, and select the printer from the list.
Optionally enable Auto-reconnect on startup so the device reattaches to the printer whenever the app launches — strongly recommended for dedicated order devices.
Use the Disconnect button to release the printer (e.g. before pairing it to a different device).

Sunmi devices

On Sunmi hardware, choose Sunmi and use Check Printer Status to confirm the built-in printer is ready. Toggles for Auto Line Feed, Enable Beep Sound, and Open Cash Drawer control the device’s extras.

Status and capabilities

The Printer tab shows two panels that make support conversations much easier:

Connection Status — a status icon, when the printer last connected, and a health readout (Ready / Not Ready).
Printer Capabilities — what the connected printer supports, shown as badges: Paper Cut, Cash Drawer, QR Code, Barcode, Images, Auto-reconnect — plus supported paper sizes and print speed.

When a merchant reports printing trouble, ask them to read you these two panels first.

Formatting and behavior

General settings on the same tab control output:

Page Size, Character Set, Printer Model, Printer Language, and Receipt Template selects — match these to the physical printer (wrong page size is the top cause of garbled or cut-off prints).
Print Header and Print Footer text — outlet name, a thank-you line, a returns note.
Auto-Print on New Order — print as orders arrive, no taps.
An “Exclude special commands” toggle for printers that mis-handle certain control codes — flip it if output contains stray characters.

Test Print

The Test Print button outputs a sample receipt — use it after every hardware or settings change, and at the start of service.

A dedicated KOT printer

The Printer tab has a separate Kitchen Order Ticket (KOT) Printer section: enable it with its own toggle, give it its own printer type and configuration, and its own header/footer text. That means the counter receipt printer and the kitchen ticket printer can be entirely different devices — receipt at the register, KOT on a network printer at the pass. A dedicated Test KOT Print button verifies it independently.

Guidance for marketplace operators

Make printing part of merchant onboarding. A merchant whose first live order silently doesn’t print loses trust fast — have them run Test Print and a test order before launch.
Recommend hardware patterns: Sunmi terminal or Bluetooth thermal printer for a single counter; Network or PrintNode when the printer lives away from the staff device.
Auto-print needs an awake device. The device that receives orders should stay plugged in with the app foregrounded — the partner app’s Display settings can keep the screen awake.

Troubleshooting

Symptom	Try this
Nothing prints on new orders	Check Auto-Print on New Order is on, Connection Status reads Ready, and the device is awake with the app open
Garbled or cut-off output	Match Page Size / Printer Model / Printer Language to the hardware; try the “Exclude special commands” toggle; run Test Print
Bluetooth printer won’t pair	Re-run Scan for devices; if it still fails, try the Capacitor Bluetooth type instead
Printer drops between orders	Enable Auto-reconnect on startup; keep the device in range and the app foregrounded
Network printer unreachable	Verify the IP address and port, and that printer and device are on the same network
PrintNode jobs not arriving	Confirm the PrintNode client is running on the host computer and the printer ID is correct
KOT prints but receipt doesn’t (or vice versa)	They’re configured separately — check both the main printer and the Kitchen Order Ticket (KOT) Printer section