ZenotiHelp

Pay-via-Link / Zen-Checkout Widget β€” Appointment Book (V1 ASPX)

ZTZenoti Docs Team Updated November 3, 2026 3 min readGuide

The appointment book page loads the pay-via-link widget bridge script, the Zen-Checkout stylesheet, and the Zen-Checkout module so that payment-via-link and checkout widget functionality is available to front desk staff directly from within the appointment book.

Audience: Front desk staff and center administrators who process payments or send payment links to guests from the appointment book.

Before you begin

  • Your center must have an active appointment book session open.

  • Payment-via-link must be enabled for your center. For settings overview, see topic.

  • You need the following permissions to take payments or send payment links from the appointment book:

    Permission: You need the Take Payment permission to access payment actions from within the appointment book. Admin path: Configuration > Security > Security Roles > [your role] > Appointments > Take Payment

Note: The pay-via-link and checkout widget features load automatically when the appointment book page opens. No manual action is required to activate them β€” they are part of the page initialization sequence.

Steps

When you open the appointment book, Zenoti loads the required payment scripts in the background. You do not need to start or configure this loading process yourself. However, you can confirm that the features are ready to use before attempting to send a payment link.

  1. Open the appointment book for your center.
  2. Locate an appointment in the calendar.
  3. Right-click the appointment block to open the context menu.
  4. Confirm that payment-related actions β€” such as Take Payment and Payment Link β€” appear in the menu.

If payment actions do not appear, see the Troubleshooting section below.

  1. Open the appointment book and locate the guest's appointment.
  2. Right-click the appointment block to open the context menu.
  3. Select Show Invoice to open the guest's invoice.
  4. In the invoice panel, select the option to send a Payment Link to the guest.
  5. Confirm the guest's contact details (email or mobile number) are on file.
  6. Select Send to deliver the payment link to the guest.

The guest receives the link and can complete payment through the Zen-Checkout widget outside the center.

Use the checkout widget from the appointment book

The Zen-Checkout widget integrates with the appointment book's invoicing flow. When you initiate payment collection from within an appointment context, the widget surfaces the appropriate payment options based on your center's configuration.

  1. Open the appointment book and locate the guest's appointment.
  2. Right-click the appointment block and select Take Payment (or select Show Invoice and then proceed to payment).
  3. The checkout widget loads within the payment panel.
  4. Select the payment method and complete the transaction.

For payment processing details, see topic.

Tips

  • If you regularly send payment links before a guest arrives, configure the auto-trigger setting so links are sent automatically based on appointment time or status changes. For settings overview, see topic.
  • Confirm that the guest has a valid email address or mobile number on their profile before sending a payment link. A missing contact detail causes the send action to fail silently. For guest profile details, see topic.
  • When a guest pays via a link before their appointment, the invoice closes automatically if your center has enabled that option. Check with your administrator if you want invoices to remain open for manual review after link payment.

Troubleshooting

Payment actions do not appear in the appointment context menu.

The Take Payment and Payment Link options are permission-controlled. Confirm that your security role includes the Take Payment permission. Ask your administrator to verify your role at Configuration > Security > Security Roles > [your role] > Appointments. Also confirm that your center has payment-via-link enabled at the organization or center level.

The payment link send action fails or shows an error.

The most common cause is a missing guest email address or mobile number. Open the guest profile, add the missing contact detail, and retry. If the issue persists, confirm that the notification template for payment links is enabled. For payment processing, see topic.

The checkout widget does not load when taking payment.

If the widget panel appears blank or fails to render, refresh the appointment book page. The widget scripts load during page initialization β€” a reload restores them. If the problem recurs consistently, ask your administrator to confirm that pay-via-link is enabled for your center and that no browser extensions are blocking script loading.

Was this article helpful?
Your feedback helps us improve our documentation.