Payment integration reference
This article is a reference companion to Process payments from the queue. It describes how payment is initiated from the queue into the Zenoti POS (Point of Sale), how auto-pay and pre-authorization work, and how group billing is handled. For step-by-step payment instructions, see Process payments from the queue.
Audience: Front desk staff and managers responsible for payment processing and checkout from the queue.
On this page
- Before you begin
- How payment is launched from the queue
- Auto-pay
- Pre-authorization
- Authorization status and edge cases
- Group billing
- Tips
- Troubleshooting
- Related articles
Before you begin
- The Enable Admin Queue setting must be enabled at the organization level, and Operate appointment book in Queue mode must be enabled at the center level.
- For auto-pay, both the organization-level auto-pay setting and the center-level auto-pay setting must be active.
Permission: Edit (under Appointments) — Required to initiate payment from queue cards. The POS icon on queue cards follows the ContextMenu action under Appointments in your security role.
How payment is launched from the queue
The queue does not process payments directly. Instead, it launches the Zenoti POS interface with the appointment details, invoice, and guest information already loaded. This means:
- The same POS workflow is used for queue checkouts as for appointment book checkouts.
- All standard payment methods, discounts, and tip collection options available in POS are accessible from queue-initiated checkouts.
When staff clicks Take Payment on a queue card, the system passes the appointment group ID, invoice ID, guest ID, and group invoice ID to the POS interface. Staff then complete payment using the standard POS process.
Note: When the amount already paid is greater than or equal to the invoice total, the queue card surfaces Close invoice and Edit invoice directly — no POS launch is required in that case.
Staff can also tap the POS icon on a Guests Waiting card before the service has started. A confirmation warning appears before POS opens. In this advance-payment flow, the invoice remains open until the service is marked Completed, at which point it can be closed.
For payment processing details, see Process payments from the queue.
Auto-pay
When both the organization-level auto-pay setting and the center-level auto-pay setting are active, the queue can trigger automatic payment for appointments when the guest has a valid payment method on file. The system initiates auto-pay by passing the appointment group ID to the payment processing layer.
Auto-pay behavior:
- When a service is completed, the system checks whether the appointment qualifies for auto-pay.
- If the guest has a payment method on file and auto-pay is active at both levels, payment is initiated automatically.
- The authorization status on the queue card updates to reflect the result.
- If auto-pay succeeds, no manual POS action is required.
- If auto-pay fails — for example, because a card authorization fails at check-in — the Take Payment button appears on the queue card so staff can collect payment in-store.
Note: If a guest enrolls for auto-pay after an appointment is created but before the service starts, an icon appears on the queue card to surface the auto-pay option.
Pre-authorization
By default, when auto-pay is active, the system pre-authorizes the guest's payment method at check-in. Pre-authorization verifies that the payment method is valid before the service begins.
When the organization-level setting that disables pre-authorization is enabled:
- The pre-authorization step at check-in is skipped.
- Payment is charged directly when the service is completed.
- This is useful when the final service amount may differ significantly from the pre-booked amount, such as when add-on services are frequently added during the visit.
Authorization status and edge cases
Each queue card tracks the current auto-pay authorization status for the appointment. Status values:
| Status | Meaning |
|---|---|
| Authorized | The payment method has been verified. The charge will be processed upon service completion. |
| Pending | Authorization is in progress. |
| Not authorized | The payment method could not be verified. Staff must collect payment manually. |
Authorization status updates appear automatically on all connected queue screens.
Edge cases:
- Card authorization fails at check-in — The Take Payment button appears on the queue card so staff can collect payment in-store manually.
- Guest enrolls for auto-pay after appointment creation — If enrollment occurs after the appointment is created but before the service starts, an icon appears on the queue card to surface the auto-pay option. Staff do not need to take any additional action to trigger pre-authorization; it applies at the point the enrollment is detected.
Group billing
For guests who are part of the same group booking or family account, group billing allows a single payment transaction to cover all related appointments. Staff select the primary appointment and open the group billing interface, which shows all related invoices combined. Payment is collected once for the entire group.
Tips
- If auto-pay is active at the organization level but not the center level (or vice versa), auto-pay will not trigger. Verify both settings are enabled before expecting automatic payment.
- Use the advance-payment flow — tapping POS on a Guests Waiting card — when a guest needs to pay before their service begins, such as when using a prepaid package. The invoice stays open until the service is marked Completed.
- When a guest's auto-pay fails at check-in, address the payment before the service ends so the checkout queue is not delayed. The Take Payment button on the queue card provides direct access to POS.
Troubleshooting
| Problem | Resolution |
|---|---|
| Take Payment button does not appear on the queue card | Confirm the staff member's security role includes the ContextMenu action under Appointments. Also verify that the Enable Admin Queue and Operate appointment book in Queue mode settings are both active. |
| Auto-pay does not trigger after service completion | Confirm the auto-pay setting is enabled at both the organization level and the center level. Also verify the guest has a valid payment method on file. |
| Authorization status shows Not authorized at check-in | The guest's payment method could not be verified. Use Take Payment on the queue card to process payment in-store. Ask the guest to update their payment method if the issue recurs. |