ZenotiHelp

Integrations FAQ

ZTZenoti Docs Team Updated September 5, 2026 5 min readFAQ

Answers to frequently asked questions about Zenoti integrations. Every answer here mirrors behaviour documented in the corresponding setup or workflow article β€” check those articles for the authoritative description.


On this page


Payment processing

What is the difference between V1 and V2 payment processors?

V1 processors are configured at the center level via Configuration > Payments > Settings (the center-scope caption of the Payments row; at organization scope the row reads Payment settings and does not configure processors). V2 processors (including Adyen, Stripe, ZPay Lite, ICPlus, Xendit, Sunbit, Walletdoc, and CaisseAP) are configured at the organization level via Configuration > Payments > Process payments > Payment processor onboarding.

Can I use multiple payment processors at the same center?

Yes. You can configure a primary processor and enable custom payment agents for additional payment methods such as ZipPay (Australia) or Sunbit (US).

What BNPL (Buy Now, Pay Later) options does Zenoti support?

Zenoti supports Sunbit (US only, 5% fee, $60–$10,000 range), Stripe Express BNPL with Affirm/Afterpay/Klarna (5.9% fee), and ZipPay (Australia only, in-store code flow).

Can I migrate stored card tokens when switching processors?

Yes, for supported processor pairs. See Migrate cards between processors.

Can I void a Sunbit transaction?

No. Sunbit does not support void, refund, or pre-authorize/capture operations through Zenoti. Contact Sunbit directly for post-sale adjustments.


Accounting

Which accounting providers does Zenoti support?

Zenoti supports QuickBooks Online (QBO), Xero, and any provider accessible via the Codat accounting integration layer.

How often does accounting data sync?

You can configure sync schedules (daily, weekly, or custom intervals) per sync type (Invoice, Payment, Items, PettyCash, Inventory, InventoryAdjustment). See Configure accounting sync schedules.

Why is my QuickBooks sync failing silently?

The most common cause is a financial lock mismatch between organization and center levels. Verify the Lock financial data date at both scopes under Configuration > Business details > Business setup > Financials.

Can I sync inventory adjustments to accounting?

Yes, the InventoryAdjustment sync type is available in the sync schedule configuration.


PMS (Oracle Opera)

Does Zenoti support both Opera on-premise and Opera Cloud?

Yes. Opera on-premise is integrated via HTNG 2008B SOAP; Opera Cloud is integrated via REST. A single Zenoti center connects to exactly one Opera deployment. See Connect Oracle Opera PMS.

What does "on-premise cloud" mean?

Nothing β€” it is an obsolete term. Every Opera integration is either on-premise (Opera installed at the property) or cloud (Opera hosted by Oracle). Remove the term from any internal runbook that still uses it.

Why do Opera credentials say "do not use the placeholder 'HTNG' as the username"?

Opera credential examples in older documentation could be mistaken for shipping defaults. All HTNG credentials must be supplied by the hotel's Opera administrator from an HTNG service account β€” Zenoti does not ship a default username.


Payroll (ADP Run)

Does ADP Run support multiple employer accounts under one Zenoti organization?

Yes. ADP Run uses a multi-token OAuth model. Each ADP employer account requires its own token; tokens are assigned at center or organization level. See Connect ADP Run for payroll.

Can I correct a pay period that ADP has already processed?

No β€” a closed pay period cannot be overwritten through a sync. Use ADP's retroactive adjustment flow or an off-cycle pay run. See Sync payroll data with ADP.


Tips payout

What are the tips payout statuses?

Waiting for Process, Initiated, Transfer Success, Transfer Failed, and Center Account Inactive. These five values are used across both ADP Wisely and MyZen Tips.

Can I reverse a successful tips payout from Zenoti?

No. Once Transfer Success is recorded, funds have reached the employee's account. Work with the provider directly to recoup funds, or record an offsetting adjustment in the next cycle. See Process tips payouts.

Where does MyZen Tips belong β€” Integrations or MyZen?

MyZen Tips payout configuration is in the Integrations category (this section). MyZen app features unrelated to payout are in the MyZen category.


Communication (Zoom, WhatsApp)

Is WhatsApp Business the same as HyperConnect?

No. WhatsApp Business integration in this category configures the Meta WhatsApp Business API for transactional template messages. HyperConnect's conversational messaging UI is in the HyperConnect category.

What happens when a Zoom meeting creation fails?

The appointment itself is not cancelled β€” the booking stands. Staff can generate a meeting link manually from the appointment context panel. See Communication β€” Zoom integration.

Why does my WhatsApp template keep getting rejected by Meta?

Meta rejects templates that include promotional language in a transactional category, that use formatting or variables incorrectly, or that fall outside the approved template category. Review Meta's feedback on the rejected template, edit, and resubmit.


Club (CSI Software)

What happens if a member exists in both CSI and Zenoti with different data?

The outcome depends on the sync direction. CSI-to-Zenoti overwrites Zenoti; Zenoti-to-CSI overwrites CSI; bidirectional uses the per-field authority configured under mapping. See Club integrations (CSI).

Do I need a CSI bridge for the integration?

It depends on your CSI deployment. Self-hosted CSI typically requires a CSI-provided on-premise connector; CSI-hosted deployments may use a public API. Confirm with your CSI account representative.


Zenoti University

Is Zenoti University the same as Northpass?

Zenoti University is Zenoti's packaging of Northpass LMS. The integration calls Northpass APIs for course catalog and learning-group provisioning. See Configure Zenoti University.

Do employees need a separate login for Zenoti University?

No, if SSO is enabled. With SSO Mode off, employees sign in to Northpass with Northpass credentials.


Webhooks and API

How many webhook subscriptions can I create?

By default, organizations can create up to 40 webhook subscriptions. Contact Zenoti Support to increase this limit.

What events can I subscribe to with webhooks?

Zenoti supports webhook events for appointments, guests, invoices, memberships, and other business objects. Configure subscriptions via Configuration > Integrations > Webhooks. For webhook event details, see the Zenoti APIs category.


Fitness networks

How do ClassPass reservation statuses map in Zenoti?

ClassPass reservations appear in Zenoti with one of the following statuses: Enrolled, Attended, Cancelled, Late Cancelled, Class Cancelled, or Missed.

Does Zenoti support BILT and Gympass?

Yes. BILT, Gympass, and FitReserve are enabled or disabled via simple toggles. See Enable BILT, Gympass, and FitReserve.


Regional compliance

Which countries require fiscal invoicing through Zenoti?

Zenoti supports fiscal invoicing integrations for Spain (Fiskaly), Saudi Arabia (ZATCA), Montenegro (DDDI), and Malaysia (LHDN).

What is the difference between COMPLETE and SIMPLIFIED invoices in Spain?

In Spain, transactions over 3,000 EUR require a COMPLETE invoice (buyer NIF required). Transactions of 3,000 EUR or less can use a SIMPLIFIED invoice.


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