Use mirror mode
Mirror mode turns a second device (typically an iPad) into a customer-facing display during checkout. While front-desk staff processes the transaction on the desktop POS (Point of Sale), the guest sees their invoice summary, selects tip amounts, chooses donations, and views payment status on the mirror screen. Staff can track the guest's checkout progress in real time on the desktop and assist if something goes wrong.
On this page
- Before you begin
- Set up mirror mode
- How mirror mode works
- Process a transaction with mirror mode (desktop POS)
- After payment completes
- Mirror mode screens
- Tips collection
- Donations
- Handle payment failures
- Troubleshooting
- Related articles
Before you begin
- You need the following permission:
Permission: Your role must have the appropriate permissions for POS operations and cash register access.
- Ensure you are using one of Zenoti's supported devices for iOS and Android.
- If you are using an iPad, go to iPad Settings and set Auto-Lock to Never to prevent the device from locking during payment processing.
- Set up a payment processor before turning on mirror mode. Mirror mode is the customer-facing surface of an existing payment-processor flow β it does not provision processors, register card readers, or authorize bank accounts on its own. Complete Set up a payment processor and verify your Stripe Connect onboarding is complete before continuing.
- You must have at least one active cash register at the center level.
- The POS functionality is not available on Android phones. Zenoti Mobile v2 is only supported on iPads and Android tablets.
- Supported card readers: Mirror mode works with the following Stripe terminal card readers: BBPOS Chipper 2X BT (Bluetooth), BBPOS WisePOS E (WiFi), BBPOS WisePOS E Cloud (WiFi/Cloud), and Stripe Reader M2 (Bluetooth). For card reader setup instructions, see Configure payment terminals and card readers.
- Optional β receipt printer: If your center prints receipts to a Bluetooth thermal printer paired with the iPad, set up the printer first via Pair a receipt printer to your iPad. The mirror mode print receipt option routes to that printer when one is paired; otherwise, receipts are emailed.
Important β register match. The cash register selected on the iPad in Zenoti Mobile MUST match the cash register selected on the desktop POS for the SignalR mirror connection to work. Mismatched registers are the second-most-common mirror-mode setup error (after the three-toggle mismatch in Set up mirror mode). If the mirror is connected but cards are routed to the wrong terminal, check the register first.
Set up mirror mode
Three enablement points must all be on for mirror mode to work. This is the most common mirror mode setup mistake β staff turn one toggle on, miss another, and the iPad sits at "Connecting" with no diagnostic. Confirm all three: (1) Organization-level invoice mirroring is enabled (Step 1 below β usually a one-time setup by an organization administrator). (2) Per-cash-register Enable Invoice Mirroring is checked for the register the iPad will pair to (Step 2). (3) Switch to Mirror Mode is on inside Zenoti Mobile on the iPad (Step 3, sub-step 7). If mirror mode is not appearing, walk through these three in order β Step 1 first, Step 3 last.
Step 1: Enable invoice mirroring for your organization
Contact your manager to enable invoice mirroring for your organization's mobile POS. This is an organization-level setting; it does not appear in self-service Configurations because it gates the feature for the entire organization across all centers.
Step 2: Enable mirroring on cash registers
- At the center level, click the Configuration icon.
- Search for and select Cash Register.
- Click the cash register for which you want to enable mirror mode.
- Select the Enable Invoice Mirroring checkbox (if not already selected) and click Save.
- Repeat steps 3-4 for any additional cash registers you want to mirror-enable.
Note: You can enable mirror mode on any number of cash registers. All mirroring-enabled registers become available for selection in the Zenoti Mobile App.
Step 3: Configure mirror mode on the iPad
- On your iPad, launch Zenoti Mobile and tap Settings.
- Tap Cash Register. The list of cash registers with mirror mode enabled appears.
- Select the appropriate cash register.
- Go to the Mirror mode section.
- Tap Add URL and enter your business's own public website URL (for example,
https://www.spabliss.comfor a business named "Spa Bliss"). This is not your Zenoti instance URL or a domain you need to whitelist on a firewall β it's the public-facing website guests would visit (the URL on your business cards, social profiles, or marketing site). Mirror mode uses it to associate the iPad session with a specific business identity at session start. If your business does not have a public website, contact Zenoti Support for an alternative session URL.
Important: The URL must use
https(nothttp) for security compliance.
- Tap Save URL.
- Turn on Switch to Mirror Mode.
Mirror mode is now active. To mirror from a different cash register, repeat steps 1-7 with the other register.
URL whitelist for Safari
Mirror mode requires Safari to reach a number of external hosts. The whitelist below is split into Required for payments and Optional for analytics, walkthroughs, and support tooling so your network team can make informed allowlist decisions. Where possible, prefer the specific subdomain (js.stripe.com) over the wildcard (*.stripe.com); wildcards are listed where the upstream provider rotates subdomains and a wildcard is genuinely required.
Required for payments
These hosts must be reachable from the iPad's network for mirror mode to process card transactions. If any of these are blocked, payment processing fails β mirror mode itself may load but the card reader cannot communicate with the processor.
| Host | Purpose | Specific subdomains preferred |
|---|---|---|
*.zenoti.com |
Zenoti API and product surfaces | apisramrs01.zenoti.com (regional API). The wildcard is required because the regional API subdomain rotates per pod. |
*.stripe.com |
Stripe payment processor β checkout, terminal API, hosted payment page | js.stripe.com, api.stripe.com, terminal.stripe.com, hooks.stripe.com. Narrow to these subdomains if your network policy permits and Stripe documents the active list. |
api.payworks.io |
Payworks card-reader integration (used by some Stripe terminals) | Single specific host. |
*.amazontrust.com |
AWS root certificate authority | Required for TLS validation; specific subdomains rotate. |
*.bbpos.com |
BBPOS card-reader firmware and connectivity | Specific subdomains preferred where available. |
*.hostedpayments.com |
Hosted payment page processor variants | Specific subdomain preferred. |
*.elementexpress.com |
Element Express (Worldpay) terminal connectivity | Required only if your center uses Worldpay terminals; skip otherwise. |
*.managemyspa.com |
Legacy Zenoti deployment subdomain | Required only for organizations on the legacy subdomain. |
Optional for analytics, walkthroughs, and support
Mirror mode will process payments without these hosts allowlisted, but in-product walkthroughs, support chat, crash reporting, and product analytics may not function. Whitelist these where your network policy permits.
| Host | Purpose | Specific subdomains preferred |
|---|---|---|
intercom.io, intercom.com, js.intercomcdn.com, *.intercomassets.com, intercomassets.com, static.intercomassets.com |
In-product help and support chat | js.intercomcdn.com, static.intercomassets.com cover most flows. |
*.walkme.com, walkme.com, cdn.walkme.com |
In-product walkthroughs | cdn.walkme.com is the asset host. |
newrelic.com, bam.nr-data.net, *.nr-data.com |
New Relic real-user monitoring | Specific hosts as listed. |
crashlytics.com |
Firebase Crashlytics crash reporting | Single host. |
mixpanel.com, *.mixpanel.com, cdn.mxpnl.com |
Mixpanel product analytics | cdn.mxpnl.com is the asset host. |
amazonaws.com |
AWS-hosted assets and content | Required when Zenoti assets resolve to AWS-hosted endpoints. |
*.Zoho.com |
Zoho-hosted support / forms | Required only if your organization uses a Zoho integration. |
Note for MDM users: If your devices are managed via Mobile Device Management (MDM), you must also enable multi-app mode when using Safari for mirror mode and digital forms.
How mirror mode works
Mirror mode uses a real-time connection (SignalR) to synchronize the customer-facing display with the employee's POS screen. When the employee processes an invoice, the mirror device automatically transitions through the checkout screens, showing the guest relevant information at each step.
The flow:
- Employee opens an invoice on the desktop POS.
- The mirror device (iPad) displays the invoice summary.
- Employee processes payment on the desktop.
- A "Present Card" prompt appears on the iPad β the guest inserts, swipes, or taps their card on the card reader.
- The mirror shows payment status and transitions to the tips screen.
- The guest selects a tip amount on the mirror.
- The mirror optionally shows a donation prompt.
- The mirror displays a thank-you message or feedback request.
Throughout this flow, the desktop POS displays the guest's checkout progress steps in real time, so staff can actively prompt the guest about next steps and help if issues arise.
Staff visibility: The desktop POS shows a real-time progress tracker displaying which step the guest is on (payment, tips, donations, thank you). Use this to proactively guide guests who may need help at any step. The number of progress steps displayed depends on the payment processor configured for your center.
Process a transaction with mirror mode (desktop POS)
This section documents what the front-desk staff does on the desktop during a mirrored transaction:
- Log in to Zenoti and click the Appointment icon to open the Appointment book, or the Queue icon to open the Queue book. Mirror mode behaves identically from either book β your organization's Default POS Surface setting controls which icon is shown, and the iPad mirror flow does not change based on entry point.
- Select the cash register that matches the one you selected on the iPad in the Zenoti Mobile App. (See the Important β register match callout in Before you begin β mismatched registers are the most common cause of "mirror connected but card not detected.")
- Open the Take Payment screen of the appointment.
- Click Credit/Debit and verify the amount to be collected.
- Click Collect Tips to start the mirrored checkout flow on the iPad.
Why click "Collect Tips"? This button starts the entire mirrored checkout flow on the iPad β not tips collection alone. The iPad flow is ordered tips β donation β payment β receipt β signature, with tips as the first guest-facing screen. Clicking Collect Tips opens the iPad mirror at the tips screen (the first step) and the rest of the flow follows automatically. There is no separate "Collect Payment" or "Charge Card" trigger button β Collect Tips is the labelled entry into the entire flow.
- A prompt asking the guest to Present Card appears in the Zenoti Mobile App on the iPad.
- The guest follows the instructions on the iPad to complete the transaction (insert, swipe, or tap card).
- Monitor the guest's checkout progress on your desktop screen β each completed step updates in real time. The number of steps displayed depends on the payment processor.
- After the transaction completes, the payment is confirmed on the Collect Payment screen.
After payment completes
When the card payment finishes successfully:
- The desktop POS shows a payment-confirmation message and offers Email receipt and Print receipt options.
- Email receipt sends the receipt to the guest's email on file.
- Print receipt routes to the iPad's paired Bluetooth receipt printer (if one is paired β see Pair a receipt printer to your iPad) or to the desktop's configured printer.
- The iPad transitions to the thank-you screen for ~5 seconds, then to the inter-guest advertisement screen until you open the next invoice.
- The cash-register session is preserved. You can open the next guest's invoice on the desktop POS without re-pairing or reconfiguring the iPad.
- Split payments (one invoice with multiple payment methods): complete each payment in turn from the desktop POS Take Payment screen. The iPad mirror surfaces each card-payment step and reverts to the invoice-summary screen between methods. Cash, gift card, and membership-credit portions are processed entirely on the desktop without iPad-mirror involvement.
Note: In mirror mode, guests can use the card reader for credit/debit payments only (insert, swipe, or contactless tap). All other payment types β cash, check, gift card, membership credit, custom payment, payment link, ACH (Automated Clearing House) β must be processed on the desktop POS without iPad-mirror involvement. For a card already saved on the guest's profile, select Use a Saved Card on the desktop POS β the iPad mirror surfaces a payment-in-progress message but the card reader is not activated.
Note: For cards that require a PIN input, the guest's signature does not need to be collected.
Mirror mode screens
The mirror automatically transitions through these screens based on the checkout progress:
| Screen | When it appears | What the guest sees |
|---|---|---|
| Invoice summary | When the employee opens the invoice | Line items (services, products, taxes), individual amounts, and the total. The guest can scroll if the invoice is long. The guest cannot edit line items or dispute charges from the iPad β those are staff-side actions on the desktop POS. |
| Payment status | During payment processing | A real-time progress indicator that mirrors the staff-side progress steps. The guest sees what is currently processing (authorizing, capturing) and what comes next (tips, donation, signature). |
| Card prompt | When the desktop POS asks for the card | "Present Card" message with instructions to insert, swipe, or tap on the connected card reader. |
| Tips | After payment is authorized | Tip selection (preset percentages, custom amount, skip). |
| Split tips | When split tips are enabled | Individual provider names for tip allocation. |
| Donations | After tips (if enabled) | Donation amount options. |
| Thank you | After checkout is complete | Thank-you message or feedback prompt. |
| Advertisements | Between guests | Promotional content (configurable URL). |
Payment methods supported on the mirror
The mirror handles card payments only (chip insert, contactless tap including mobile wallets, magnetic-stripe swipe). Specific support depends on the connected card reader:
| Card reader | Insert (chip) | Tap (contactless) | Swipe | Saved-card path |
|---|---|---|---|---|
| BBPOS Chipper 2X BT | Yes | Yes | Yes | Use a Saved Card from the POS β no terminal interaction |
| BBPOS WisePOS E / WisePOS E Cloud | Yes | Yes | Yes | Same |
| Stripe Reader M2 | Yes | Yes | Yes | Same |
For a saved card on file, the FDO selects "Use a Saved Card" on the desktop POS β the mirror displays an authorization-in-progress message but the card reader is not used. All non-card payments (cash, check, gift card, custom payment, payment link) must be processed on the desktop POS; the mirror is not used for these.
Tips collection
On the tips screen, the guest can:
- Select a preset tip percentage β commonly 15%, 18%, 20%, or 25%.
- Enter a custom amount β type a specific tip amount.
- Choose payment method β tip by cash or card.
- Skip β choose not to tip.
When split tips are enabled, the mirror displays each provider's name so the guest can allocate tips individually to each provider who served them.
The selected tip is automatically recorded on the invoice and synced to the employee's POS device.
Donations
When donations are enabled for your center:
- After the tips screen, the mirror displays donation options.
- The guest can select a preset donation amount or enter a custom amount.
- The guest can also skip the donation.
- The donation is added to the transaction.
Handle payment failures
If a card payment fails during a mirrored transaction, the desktop POS displays an alert indicating the reason for the failure. You can:
- Retry β Click Retry to initiate the transaction again using the same card or a different card.
- Use a saved card β If the guest has a card saved on file, choose to process with a saved card. The Online Payment window reopens, and you must select "Use a Saved Card instead?" to proceed.
Handle a mid-transaction disconnect
The iPad and the card reader can lose connection mid-transaction. The desktop POS surfaces a "Mirror disconnected" indicator so you are not waiting for a guest action that cannot complete. Use the table below to identify the cause and recover:
| Symptom on the iPad | Likely cause | Recovery |
|---|---|---|
| Mirror shows a reconnection error and is trying to reconnect | Wi-Fi dropped on the iPad | Re-establish Wi-Fi on the iPad. If the transaction had already authorized but capture had not completed, finish the capture from the desktop POS β the auth is still valid. If the guest had not yet tapped, retry from the desktop. |
| Mirror screen blanked | iPad went to sleep | The iPad's Auto-Lock should be set to Never (see Before you begin). If it locked anyway, wake the iPad and re-confirm Auto-Lock. Transaction state is preserved on the desktop POS β complete the capture there if authorization had succeeded. |
| Card reader shows "Reader is currently offline" or "No such reader" | Bluetooth dropped (BBPOS Chipper 2X BT, Stripe Reader M2) or Wi-Fi dropped on the reader (WisePOS E variants) | Verify the card reader is powered and within range. For Bluetooth readers, re-pair from the iPad's Settings > Connected Card Readers. Then retry the payment. |
| Both iPad and desktop show "Connection lost" | Center-wide network outage or SignalR backend disruption | Wait ~30 seconds for auto-reconnect. If service is not restored, cancel the transaction on the desktop POS, switch to an alternative terminal at the same center, or use Take Payment on the desktop POS to enter the card manually. |
The transaction is voided automatically only if you explicitly cancel it on the desktop POS or if the terminal SDK returns a hard failure. A transient disconnect does not void an in-progress authorization β you can typically resume from the desktop after restoring connectivity.
Troubleshooting
Why is mirror mode not available on my iPad?
Mirror mode does not work if Safari is restricted on the iPad. To remove the restriction (iOS 12 and later):
- Open Settings on the iPad.
- Tap Screen Time > Content & Privacy Restrictions.
- Enter your Screen Time passcode if prompted.
- Under Allowed Apps, make sure Safari is enabled.
Note: On iPads running iOS 11 or earlier, the path was Settings > General > Restrictions. All currently supported iPad models run iOS 15 or later.
Why is the device stuck at "Connecting"?
If the device is stuck at "Connecting" when you attempt to use mirror mode during checkout:
- Ensure you have an active Wi-Fi or internet connection.
- Close and reopen the invoice. After the invoice opens, verify whether mirror mode is turned ON and the connection with Zenoti Mobile is established.
Why is mirror mode not working even though it's set up?
Your business may have multiple registers configured. Mirror mode may not work if you are connected to the wrong register:
- Verify that Enable Invoice Mirroring is enabled for your register (Configuration > POS > Cash register).
- In Zenoti Mobile, verify that your center is connected to the correct cash register. The register selected on the iPad must match the register selected on the desktop POS.
Why am I having trouble connecting to mirror mode?
You might face issues connecting to mirror mode if you are using an older version of Zenoti Mobile:
- Visit the App Store (iPad) or Play Store (Android) to ensure you have downloaded or updated to the latest version of Zenoti Mobile.
What should I do if I see an unknown error or frozen screen?
If you receive an unknown error message or the screen freezes while accepting payments in mirror mode:
- On the Take Payment screen, check that Mirror is set to ON.
- Check that the iPad is paired with your card reader. On the iPad, launch Zenoti Mobile, tap the Settings icon, then tap Connected Card Readers. Your card reader should be listed. If not, pair the iPad and card reader first, then proceed with taking payments.