ZenotiHelp

Payment processing

ZTZenoti Docs Team Updated September 16, 2026 21 min readGuide

Process payments for invoices on the desktop POS (the web-based Point of Sale accessed from a desktop or laptop browser through the Appointment Book or Front Desk dashboard) using multiple payment methods including cash, card, gift cards, loyalty points, and membership credits.

Which POS surface am I using? Zenoti has four customer-payment surfaces: desktop POS (this article β€” staff-facing, web browser, paired to a card-reader terminal), Mobile POS (Zenoti Mobile on iPad / Android tablet, used at the chair or massage table), mirror mode (a guest-facing iPad that mirrors the desktop POS β€” see Use mirror mode), and payment links / Webstore (guest self-checkout via a link or the public Webstore). Each surface has its own article. The flows in this article apply specifically to the desktop POS.


On this page


Before you begin

  • You need an open invoice with items and a due balance.

  • Your organization must have payment methods enabled at the organization or center level.

  • For card payments, the center must have at least one active payment terminal / card reader configured under the organization's payment processor. Supported terminals depend on the processor: Stripe Connect supports Verifone P400 Plus, BBPOS Chipper 2X BT, BBPOS WisePOS E (and WisePOS E Cloud), and Stripe Reader M2; Adyen supports Verifone e285 / V400m and other Adyen-supplied models; Element Express (Worldpay) and FreedomPay each have their own supported readers. See Configure payment terminals and card readers for the per-processor list and per-device setup articles (including Miura readers, Verifone P400 Plus, BBPOS variants).

  • For card payments, the desktop POS must be on a network that can reach the processor's terminal API endpoints (Stripe terminal hosts, Adyen Terminal API, etc.). If transactions never reach the terminal, allowlist the processor's hosts on the center's outbound firewall.

  • You need the following permissions:

    Permission: Add, Edit, Delete, and ContextMenu (under Appointments) β€” Required to access POS (Point of Sale) and process payments on invoices.

    Permission: Send Payment Link to Guest (under Appointments) β€” Required to send payment links to guests.

  • If using cash payments, you must have a register assigned and opened. If the Enable Mandatory Opening of Register setting is active for your center, cash payments are blocked until a register is open β€” the system will not accept cash transactions until you complete the register-opening step.

  • If using loyalty points, the guest must be enrolled in your loyalty program with available points.

  • To sell prepaid cards from the point of sale, the Allow prepaid sale in POS setting must be enabled at the center level (Configuration > search "Allow prepaid sale in POS" at center level). When disabled, prepaid card items do not appear in the POS item catalog.

  • Payment links require the payment link feature to be enabled at both the organization level and the individual center level. If either level is not configured, payment links will not function for that center.

Acronyms used in this article

  • POS β€” Point of Sale (the front-desk checkout system)
  • POI β€” Point of Interaction (the payment terminal / card reader hardware)
  • AVS β€” Address Verification Service (fraud-prevention check that matches the billing address against the card issuer's records)
  • SSG β€” Service Surcharge / Gratuity (a tip-style amount allocated to support staff or service surcharge per organization configuration; the on-invoice label can be customized via the organization's SSG label setting; editable on the invoice with the Edit SSG permission)
  • CMA β€” Customer Mobile App (Zenoti Mobile in its guest-facing mode; distinct from the staff-facing Mobile POS)

Steps

Follow the sections below to process payments using the desktop POS.

Access the payment screen

  1. Navigate to the point of sale (POS) from the Appointment Book or Front Desk dashboard.
  2. Open the invoice you want to process payment for.
  3. Click Payment to access the payment entry screen.

The system displays the current due balance and available payment methods based on your organization's configuration.

Apply membership credits (if applicable)

  1. If the guest has an active membership with available credits, the system displays the Membership payment option.
  2. Select Membership from the payment methods.
  3. Choose which membership credits to apply:
    • Service credits β€” Apply to eligible services on the invoice
    • Dollar credits β€” Apply monetary value toward the invoice total
  4. Click Apply to process the membership payment.

The system automatically calculates the maximum applicable amount and updates the due balance.

Note: Membership and package benefits must be applied at the individual sub-invoice level within a group invoice β€” they cannot be applied at the group level. All other payment methods are applied at the group level only. For loyalty point program configuration, see loyalty point program configuration.

Apply loyalty points (if applicable)

  1. If the guest has redeemable loyalty points, select Loyalty Points from the payment methods.
  2. The system displays the guest's available point balance and the maximum redeemable amount for this invoice.
  3. Enter the number of points to redeem or click Use Maximum to apply all available points.
  4. Click Apply to process the loyalty point redemption.

Note: The system automatically calculates the dollar value based on your loyalty program's redemption rate. For loyalty point program configuration, see loyalty point program configuration.

Process card payments

The desktop POS supports three distinct card-payment paths. Pick the right one β€” they are about how the card is captured, not whether the card is on file:

Option Use when What happens
Use Card Reader The guest is physically present and you want them to swipe, insert (chip), or tap (contactless / NFC enabled) their card on the terminal. Works for any card β€” saved or new. The terminal handles capture; if the guest taps a saved card, the saved record is matched. The desktop POS triggers the connected payment terminal. The terminal screen prompts the guest to swipe, insert, or tap. After authorization, the desktop POS receives the response.
Use a Saved Card The guest has a card already on file in Zenoti and you want to charge it without the guest doing anything. Card-not-present (or present-but-skipping-the-terminal). The desktop POS displays the guest's saved cards. You select one, and Zenoti charges it via the saved token. The terminal is not used.
Use a New Card The guest is not present (or doesn't want to use the terminal) and you need to enter card details manually. The desktop POS shows a manual-entry form. Enter the card number, expiry, and CVV. Optionally save the card to the guest's profile for future Saved-Card use. AVS prompts may appear (see AVS prompts).

Important: "Use Card Reader" is not the option for saved cards β€” use Use a Saved Card for that. Despite the legacy V1 help article suggesting otherwise, the labels are about hardware path vs vault path: card-reader = terminal/hardware, saved-card = vault, new-card = manual entry. If you are unsure, "Use Card Reader" works for any physical card the guest has in hand.

To process the payment:

  1. Select Card from the payment methods. The system shows the amount due and the SSG (Service Surcharge / Gratuity) field, which is auto-populated from the invoice's tip configuration. With the Edit SSG permission, you can adjust the SSG amount before submitting. The SSG label may be customized for your organization (for example, "Service Charge" or "Tip"); the on-screen label always reflects your organization's setting.
  2. The system selects your default terminal automatically. If your center has multiple terminals, you can switch via the terminal dropdown. See Select a terminal (multiple card readers).
  3. Choose the appropriate option from the table above (Use Card Reader, Use a Saved Card, or Use a New Card).
  4. For Use Card Reader: Have the guest insert, swipe, or tap their card on the terminal. The terminal accepts chip insertion, magnetic stripe swipe, and contactless / NFC enabled tap β€” if a method is not supported on your specific terminal model, the terminal will decline that input method and prompt for an alternative. The terminal prompts for tip (if enabled), then for signature (where required). On Stripe terminals (Verifone P400 Plus, BBPOS variants, Stripe Reader M2), the prompt sequence is shown on the terminal screen; on Miura readers, the desktop POS guides the guest with on-screen prompts as the reader operates. For Use a Saved Card: Pick the saved card from the list. The system tokenizes the charge and submits it to the processor. For Use a New Card: Enter card details β€” number, expiry, CVV. If AVS is enabled, also enter the billing street address and ZIP/postal code (see AVS prompts). Optionally check Save card to guest profile to store the tokenized card for future Saved-Card use.
  5. If a Cashback field appears (a debit-only feature offered by some processors): cashback is the amount the guest receives in physical cash from the till in addition to the invoice charge β€” common on debit-card transactions in regions where this is supported. Enter the cashback amount only if your terminal and processor support cashback and you have a cash drawer at the register. If you do not, leave the field at zero. The total charged to the card is the invoice amount plus the cashback amount.
  6. Wait for authorization. The system displays the result. On success, the invoice balance updates to reflect the payment.

Note on partial / split payments: To split the invoice across multiple payment methods (for example, half on card and half on a gift card), apply each method in sequence β€” the due amount updates after each. Split-payment configuration (the rules that govern which methods can be combined and in what order) is set at the organization level.

Note on check payments: When a guest pays by check and the check amount exceeds the invoice total, enter the full check amount received. The system calculates the difference as a cashback amount β€” enter this in the Cashback Amount field. The system records the full check amount received and the cashback as a cash outflow, with the net settlement equal to the invoice total.

Close the invoice and deliver the receipt

After the payment is authorized:

  1. Click Complete Payment to finalize the invoice and close the payment session. The invoice closes automatically when the due balance reaches zero.
  2. Deliver the receipt β€” see Print or email receipts below.

If you need to collect additional guest details (name, email, phone, billing address) for AVS or for emailing the receipt, the system prompts on the relevant screen β€” enter the requested fields. AVS uses billing street address and ZIP/postal code only; the receipt-email screen uses email; saving a new card may collect name + email + phone for the guest profile.

Process cash payments

  1. Select Cash from the payment methods.
  2. Enter the cash amount received from the guest.
  3. The system automatically calculates change due if the cash amount exceeds the invoice balance.
  4. Click Process Payment to complete the cash transaction.
  5. Provide change to the guest if applicable.

Important: Cash payments require an assigned and opened register. If the Enable Mandatory Opening of Register setting is active for your center, cash payments are blocked until a register is open β€” the system will not accept cash transactions until you complete the register-opening step. See Assign and open a register below.

Process gift card payments

  1. Select Gift Card from the payment methods.
  2. Enter or scan the gift card code.
  3. The system validates the card and displays the available balance.
  4. Enter the amount to charge against the gift card (up to the available balance).
  5. Click Add Payment to process the gift card payment.

The system deducts the payment amount from the gift card balance and updates the invoice. For gift card management and program configuration, see gift card management.

Process prepaid card payments

Prepaid cards are center-issued cards loaded with a monetary balance. To accept a prepaid card payment:

  1. Select Prepaid Card from the payment methods.
  2. Enter or scan the prepaid card code.
  3. The system validates the card and displays the available balance.
  4. Enter the amount to apply from the prepaid card (up to the available balance).
  5. Click Add Payment to process the prepaid card payment.

The system deducts the applied amount from the prepaid card balance and updates the invoice due amount.

Note: To sell prepaid cards from the point of sale, the Allow prepaid sale in POS setting must be enabled at the center level. When enabled, prepaid card items appear in the POS item catalog and front desk staff can sell them directly. When disabled, prepaid cards do not appear as purchasable items.

Process custom payments

  1. Select Custom Payment from the payment methods for house charges or special payment arrangements.
  2. Choose the custom payment type from the dropdown menu.
  3. Enter any required reference information or notes.
  4. Enter the payment amount.
  5. Click Process Payment to complete the custom payment.

Custom payments are typically used for corporate accounts, house charges, or special billing arrangements. Custom payment types are created at the organization level. If a custom payment type is integration-based, the integration must also be assigned at the center level before it appears as an option at checkout.

Note: Payments in a group invoice can only be added at the group level. The only exceptions are membership and package benefits, which must be applied at the individual sub-invoice level.

Complete multi-method payments

You can combine multiple payment methods on a single invoice β€” for example, applying membership credits first, then loyalty points, then paying the remaining balance by card.

Worked example: A guest's invoice total is $120. She has $30 in membership service credits and 500 loyalty points worth $10. The front desk applies membership credits ($30 due β†’ $90), then loyalty points ($90 due β†’ $80), then charges the remaining $80 to her card. Each step creates a separate transaction record, and the receipt shows all three payment methods.

  1. Apply the first payment method (for example, membership credits or loyalty points) and confirm the due amount updates.
  2. Apply the next payment method for the remaining balance.
  3. Continue until the invoice balance reaches zero.
  4. Review the payment summary showing all applied payments.
  5. Click Complete Payment to finalize the invoice and close the payment session.

Each payment method creates a separate transaction record, and the guest receives a receipt showing all payment methods used.

Payment links let guests pay their invoice online without being present at the front desk. This feature requires the payment link feature to be enabled at both the organization level and the individual center level.

Availability: Payment links require enablement at both the organization level and the individual center level. Partial payment links require an additional organization-level setting. Payment links for non-Zenoti payment processors require a further organization-level setting plus an online payment processor configured for the center.

Permission: Send Payment Link to Guest (under Appointments) β€” Required to send payment links to guests.

  1. Instead of processing payment at the front desk, click Send Payment Link on the invoice.
  2. Choose the delivery method:
    • Email β€” Send link to the guest's email address
    • SMS β€” Send link to the guest's mobile number
  3. If your organization has partial payment links enabled, you can adjust the amount the guest is asked to pay before sending.
  4. Click Send Link to generate and deliver the payment link.

The guest receives the link and can complete payment online using their preferred method. The payment automatically applies to the invoice when completed.

Note: For non-Zenoti payment processors, payment links are only available when the organization-level setting for non-Zenoti payment links is enabled and an online payment processor is configured for the center. Physical terminal payments do not require a payment processor configuration β€” that requirement applies only to online card transactions.

Assign and open a register

Before processing cash payments, you must have a register assigned to your session. Depending on your organization's configuration, register assignment may happen automatically or require a manual selection.

How register assignment works:

  • If the Auto-select cash register organization-level setting is configured to assign based on the logged-in user, the system automatically assigns the last register used by your account when you log in.
  • If the setting is configured to assign based on the machine or browser, the system assigns the register associated with the workstation you are using.
  • If no register is automatically assigned, the system prompts you to select one from the available registers for your center.

To manually assign a register:

  1. Navigate to the Appointment Book.
  2. When prompted, select a register from the list of available registers for your center.
  3. If the Enable Mandatory Opening of Register setting is active for your center, you must also open the register before cash payments and certain other operations become available.

Important: An employee can only be assigned to one register at a time. If you need to use a different terminal or workstation, log off from the current session before accessing the register from another location β€” the system enforces a single active register assignment per employee.

Note: The Auto-select cash register setting is configured at the organization level under Configuration > POS > Essentials. It is not a center-level setting.

If the Auto-open register setting is enabled for your center, the register opens automatically when you access the point of sale β€” no manual open step is required.

Important: When the Enable Mandatory Opening of Register setting is active for your center, it blocks both access to the Mid-Day and Close tabs in register management and cash payment processing. Cash payments cannot be accepted until a register is open β€” the restriction applies to payment collection, not only to register management navigation.

For full register management workflows (opening, closing, mid-day counts, cash management), see Close a register and reconcile and Manage mid-day cash counts and payouts.

Handle payment failures

Different failure symptoms have different causes. Match the symptom to the row below before retrying β€” running every fix in order can briefly disrupt service and may not address the actual cause.

Symptom on the desktop POS or terminal Cause class What to do
"Transaction declined" or "The transaction was declined by the issuer. Use a different card." Issuer decline β€” the cardholder's bank rejected the charge. Network and terminal are working correctly. Ask the guest for a different card or another payment method. Do not retry the same card unless the guest confirms β€” repeated declines on the same card can trigger fraud rules.
"No such reader" or "Reader is currently offline" Terminal connectivity β€” the reader cannot be reached. Check the terminal's Wi-Fi / cloud icons, reboot the terminal, or switch to an alternative terminal at the same center. See the device-specific terminal setup article (e.g., Verifone P400 Plus).
"Failed to process payment. Timed out waiting for response from POI" Terminal lost responsiveness mid-transaction. Auth state is uncertain β€” do not assume the payment failed. Check the invoice status before retrying to avoid double-charges. If the invoice still shows the balance as due, retry. If the invoice already shows the payment applied, do not retry.
"Payment was not processed as the system just completed a pending transaction" A concurrent or recently-completed transaction is still in flight. Wait 30 seconds and retry. If it persists, reboot the terminal or use an alternative terminal.
"Cannot process this transaction" with no specific error code, or transaction never reaches the terminal Configuration / mapping β€” the terminal is not the active default for the center, the Registration Code does not match the device, or processor onboarding is incomplete. Verify the terminal selection in the dropdown. Check Configuration > Payments > Process payments > Payment processor onboarding for any outstanding onboarding step.
All terminals at all centers fail simultaneously Service or processor outage β€” not a center-side issue. Check the Zenoti Payments status page for an active incident. Switch to manual card entry or cash if the outage is processor-specific and the alternative processor (if your org has one) is healthy.

Note: For detailed troubleshooting of terminal errors and POI (Point of Interaction) error messages, see the device-specific terminal articles in the Integrations category β€” for Stripe terminals, see Verifone P400 Plus and Configure payment terminals and card readers.

If the problem persists

If you have classified the failure, run the suggested fix from the table above, and the payment still cannot be collected:

  1. Take the payment another way. Switch to an alternative terminal at the same center (the cashier dropdown lists every active terminal). If no alternative is available, use Use a New Card with manual entry on this same screen β€” that bypasses the terminal entirely. For very large invoices or repeated failures, send a payment link instead and let the guest pay online.
  2. Capture diagnostic detail. Note the exact error string, the time of the failure, the affected terminal's Registration Code (or serial number for non-Stripe processors), and which payment option you used (Use Card Reader / Use a Saved Card / Use a New Card).
  3. Contact Zenoti Support. Open a support ticket and include the diagnostic detail. For an organization-wide issue (every terminal at every center failing), include the Stripe Location ID or Adyen Merchant ID and indicate the rough start time of the issue so support can correlate with platform telemetry.

Select a terminal (multiple card readers)

If your center has multiple card readers configured:

  1. When you initiate a card payment, the system displays the default terminal assigned to your session.
  2. To use a different terminal, click Change next to the terminal name.
  3. Select the desired terminal from the list of available terminals.
  4. Complete the transaction on the selected terminal.

Note: On Mobile POS (iPad), the system automatically selects the terminal paired with your device. If multiple terminals are available, you can switch terminals from the payment screen.

Surcharge and convenience fee visibility

If your center has surcharging enabled:

  • A surcharge banner appears on the invoice screen informing you that surcharge fees have been applied to card payments.
  • The surcharge amount displays as a separate line item on the invoice and receipt.
  • Surcharge rates vary by card network (Visa, Mastercard, Amex, Discover) and are configured by your administrator.
  • Cash and non-card payment methods are not subject to surcharges.

Inform the guest about the surcharge before processing the card payment.

AVS (Address Verification) prompts

If your center has AVS (Address Verification Service) enabled:

  • When a guest saves a new card, the system prompts you to collect the guest's billing address (street address and ZIP/postal code).
  • AVS verification helps reduce fraud by matching the billing address against the card issuer's records.
  • If AVS verification fails, the system may still allow the transaction depending on your organization's AVS policy.

Auto-pay guests

If a guest has Auto-pay enabled on their profile, the system pre-authorizes their saved card at appointment check-in and captures the final amount when the invoice is closed β€” the guest does not need to interact with the terminal at checkout. From the desktop POS:

  • You can collect payment directly from the appointment context menu (Collect Payment) without going through the full POS checkout flow.
  • The guest's Auto-pay status (authorized / failed / not enrolled) is visible on the appointment details and the guest profile.
  • If the authorization at check-in failed, the appointment displays a failure indicator and the Collect Payment action falls back to the standard manual flow.

For full Auto-pay setup, configuration, status reference (Successful, Failed, Voided, Released), Web POS and Mobile failure handling, and notification configuration, see Use Auto-pay.

After completing payment:

  1. The system displays a payment confirmation screen with the receipt summary.
  2. To print, click Print Receipt. This requires a printer connected to your device (thermal printer for physical receipts).
  3. To email the receipt to the guest, click Email Receipt. The system sends the receipt to the guest's email address on file.
  4. If no printer is connected, use the email option to deliver the receipt digitally.

Note: Your administrator can configure the default action after closing an invoice β€” either Close and Print (receipt sent to the configured printer) or Close and Email (receipt emailed to the guest). This default is set at the organization level under Essentials in the POS section. You can override the default for individual invoices using the print and email options above.

Note: The first time you transact using a new card reader, the terminal may perform a one-time software update (typically 3–5 minutes). During this update, use an alternate terminal or payment method. The terminal requires an active internet connection for the update.

Tips

  • Process payments in order of preference β€” Apply membership credits and loyalty points first, then process remaining balance with cash or card.
  • Verify gift card balances β€” The system displays the available balance before processing to avoid declined transactions.
  • Use payment links for convenience β€” Send payment links to guests who prefer to pay later or need to retrieve payment information. Remember that payment links must be enabled at both the organization and center level before they are available.
  • Check register assignment β€” Ensure you have a register assigned before processing cash payments to avoid transaction errors. If mandatory register opening is enabled at your center, cash payments are blocked until the register is open β€” this restriction applies to payment collection, not only to register management navigation.
  • Review payment summary β€” Always verify the payment breakdown with the guest before completing multi-method payments.
  • Know your card readers β€” For supported card reader models and setup instructions, see the payment terminal articles in the Integrations category.
  • Terminal-switching limitation β€” If you need to process payments from a different workstation, log off from your current session first. The system enforces a single active register assignment per employee and will not allow concurrent access from multiple terminals.

Troubleshooting

Problem Resolution
Cash payment option is unavailable or blocked Verify that you have a register assigned to your session. If the Enable Mandatory Opening of Register setting is active for your center, you must open the register before cash payments are accepted β€” this blocks both register management tabs and cash payment processing. Navigate to the Appointment Book and complete the register-opening step.
Payment link option does not appear on the invoice Payment links must be enabled at both the organization level and the individual center level. Contact your administrator to verify both settings are active. Also confirm you have the Send Payment Link to Guest permission under Appointments.
Prepaid card items do not appear in the POS item catalog The Allow prepaid sale in POS setting must be enabled at the center level. Navigate to Configuration and search for "Allow prepaid sale in POS" at the center level to enable it.
Custom payment type does not appear at checkout Custom payment types are created at the organization level. If the type is integration-based, the integration must also be assigned at the center level. Contact your administrator to verify both the organization-level type and the center-level integration assignment are configured.
Register is not automatically assigned when logging in The Auto-select cash register setting is configured at the organization level under Configuration > POS > Essentials. If no register is auto-assigned, select one manually from the Appointment Book when prompted. If you cannot see any registers, contact your administrator to verify registers are configured for your center.
Card terminal does not respond when initiating a card payment Check the terminal's network connectivity (Wi-Fi or Ethernet indicator on the device). If the terminal appears offline, reboot it and wait for it to reconnect. Switch to an alternative terminal if one is available. If no terminal is available, use Use a New Card with manual entry to bypass the terminal.
Membership credits do not appear as a payment option The guest must have an active membership with available credits. Verify the guest's membership status on their profile. If the membership is frozen or cancelled, credits may not be available β€” see membership program configuration for details on membership states.
Was this article helpful?
Your feedback helps us improve our documentation.