Payments FAQ
Answers to common questions about Zenoti Payments features, configuration, and troubleshooting.
- What payment processors does Zenoti support?
- What is the difference between the Payments category and the Integrations category?
- What permissions do I need for payment features?
- Can I apply both a surcharge and a tips convenience fee?
- Can I surcharge debit card transactions?
- Are surcharges allowed in every U.S. state?
- What is the surcharge calculated on?
- Which processors support iDEAL?
- Is iDEAL available on the mobile app?
- Does iDEAL require separate setup?
- Are there item type restrictions for iDEAL?
- What is the difference between Sunbit and Stripe Express BNPL (Buy Now, Pay Later)?
- Is BNPL available on the mobile app?
- How do I change the minimum or maximum amount a guest can finance through a Buy Now, Pay Later provider?
- Why don't I see the payment-methods control in my e-commerce settings?
- What is the difference between a guest statement and a merchant processing statement?
- What happens if an invoice has items from multiple business units?
- Are service deposits supported with multi-entity routing?
- What are orphan charges?
- How often should I reconcile?
- Why was a card declined, and where do I see the reason?
- What is the difference between a hard and a soft decline?
- Payments are failing on only one card brand. Is that an org configuration problem?
- Can a card be declined because of what my business sells?
- A guest's card keeps declining at the POS. Should I retry it?
- The terminal approved the payment but Zenoti says the guest still owes. What happened?
- Does adding or re-adding a terminal affect bank deposits?
- Another business appears on our terminals without our consent. Is this a security issue?
- Can Apple Pay be enabled for payment links at our centers?
- Is a guest's card saved automatically when they use the card machine?
- I get a "business details incorrect" message when I finalize the payment processor. What should I do?
- What is 3DS?
- Which card networks support 3DS?
- Which regions support 3DS?
- Does 3DS guarantee chargeback protection?
- What happens to 3DS-authenticated transactions that are later disputed as fraud?
- Will 3DS reduce my authorization success rate?
- What if the cardholder's bank doesn't support 3DS?
- How do I enable or disable 3DS?
Before you begin
No special permissions are needed to read this FAQ. To perform configuration tasks referenced in answers below, you need the relevant permission under Payments in your security role. See What permissions do I need for payment features? for the full list.
General
What payment processors does Zenoti support?
Zenoti Payments supports multiple payment processors including Adyen, Stripe (Connect and Express), FreedomPay, WorldPay, and others. The processors available to your organization depend on your country and configuration. For payment processor setup and configuration, see the Integrations category.
What is the difference between the Payments category and the Integrations category?
The Payments category covers platform features built on top of processors β the payment dashboard, reconciliation, payouts, disputes, recurring collections, business payments, and more. The Integrations category covers processor setup, terminal configuration, stored payment accounts, and card migration between processors.
What permissions do I need for payment features?
| Feature | Permission |
|---|---|
| Payment dashboard and transaction search | Payment-configuration permissions; specific security object under verification |
| Export transactions | Payment-configuration permissions; specific security object under verification |
| Card migration | Configure Payment Settings (under Payments) β the Card migration row is shown to Zenoti support logins only |
| Reconciliation | Reconcile Payments (under Payments) |
| Rates and settings | Configure Payment Settings or Manage Payment Settings (under Payments) |
| Processor onboarding | Configure Payment Settings or Manage Payment Settings (under Payments) |
| Disputes | Dispute Payments (under Payments) |
| Payouts | Payment-configuration permissions; specific security object under verification |
| Business payments (royalty, cross-center) | Manage Business Payments (under Payments) |
Surcharges and fees
Can I apply both a surcharge and a tips convenience fee?
No. Surcharge and tips convenience fee are mutually exclusive per center. You can enable one or the other, but not both at the same time.
Can I surcharge debit card transactions?
In the United States, surcharges are permitted on credit card transactions only. You cannot surcharge debit card transactions. Zenoti enforces this rule automatically.
Are surcharges allowed in every U.S. state?
No. Surcharging is prohibited in Connecticut, Maine, and Massachusetts. Colorado and Oklahoma each cap surcharges at 2%. Check your local regulations before enabling surcharges.
What is the surcharge calculated on?
Surcharges are calculated on the total transaction amount including tips and taxes, not the base invoice amount alone.
iDEAL (Online Banking)
Which processors support iDEAL?
Both Adyen and Stripe support iDEAL for businesses in the Netherlands.
Is iDEAL available on the mobile app?
No. iDEAL is available on the Webstore only. It is not available on the Customer Mobile App (CMA).
Does iDEAL require separate setup?
No. iDEAL is automatically enabled when your organization is based in the Netherlands and has Adyen or Stripe configured. No separate toggle or setup is required.
Are there item type restrictions for iDEAL?
No. Unlike BNPL providers, iDEAL has no item type restrictions. It is available for all purchasable items on the Webstore.
Buy Now, Pay Later (BNPL)
What is the difference between Sunbit and Stripe Express BNPL?
Sunbit and Stripe Express BNPL are completely separate integrations with different onboarding processes, commercial models, and fee structures:
- Sunbit β Standalone BNPL provider. US only. $60 minimum / $10,000 maximum. 5% processing fee.
- Stripe Express BNPL β Integrated with Affirm, Afterpay, and Klarna (US/CA) or Clearpay and Klarna (UK/AU/NZ). 5.9% processing fee.
Is BNPL available on the mobile app?
No. BNPL is available on the POS (Point of Sale) and Webstore only. It is not available on the Customer Mobile App (CMA).
How do I change the minimum or maximum amount a guest can finance through a Buy Now, Pay Later provider?
BNPL financing limits β both minimums and maximums β are set by the BNPL provider, not by Zenoti. These limits are not held in any Zenoti configuration screen. To change them, log in to the provider's own merchant portal and update the limits there.
For example, Sunbit's $60 minimum and $10,000 maximum are defined in Sunbit's merchant portal. Stripe Express BNPL limits for Affirm, Afterpay, and Klarna are defined in the Stripe dashboard. Zenoti has no setting that overrides or adjusts these values.
For background on how BNPL providers connect to Zenoti, see Set up Stripe Express BNPL.
E-commerce payment methods
Why don't I see the payment-methods control in my e-commerce settings?
There are two reasons the payment-methods control may be absent:
Permission β You need the Configure Payment Settings permission (under Payments) to view and change e-commerce payment method configuration. Without this permission, the control does not appear.
Processor support β The payment methods available in the control depend on what your connected processor supports. If a method is not offered by your processor, it will not appear as an option regardless of your permission level.
For steps to configure e-commerce payment methods, see Configure e-commerce payment methods.
Statements and reporting
What is the difference between a guest statement and a merchant processing statement?
These are two distinct documents that serve different purposes:
Guest statement β Shows what a specific guest was charged. It reflects the amounts billed to that guest across their invoices and is used to answer guest-facing billing questions.
Merchant processing statement β Shows what your business was paid by the processor and what was deducted (processing fees, chargebacks, adjustments). This is the business-side view of payment activity, not the guest-side view.
The two are routinely confused because both use the word "statement." If you are looking for information about what your business received from the processor and what fees were deducted, use the merchant-side reporting tools rather than the guest statement.
To review merchant-side payout and processing activity, see View and manage payouts and Digital payments report.
Multi-entity payment routing
What happens if an invoice has items from multiple business units?
The system rejects the payment and displays an error. When multi-entity payment routing is enabled, each invoice must contain items from a single business unit only.
Are service deposits supported with multi-entity routing?
No. Service deposits are not supported when multi-entity payment processing is enabled.
Reconciliation
What are orphan charges?
Orphan charges are processor charges that do not have a matching transaction in Zenoti. They are identified during reconciliation and should be investigated to determine their origin.
How often should I reconcile?
Reconcile regularly β at minimum, weekly β to catch discrepancies early. The system automatically imports processor settlement data, so your reconciliation view is always up to date.
Declined and failed payments
Why was a card declined, and where do I see the reason?
The payment provider decides the outcome, and Zenoti records the reason it returns. Open Reports > Zenoti Payments > Failed Payments and check the Failure Reason column β it holds the message or code the provider sent back. For the full decline detail behind that code, check your processor's own dashboard. See View the Failed Transaction Report.
What is the difference between a hard and a soft decline?
A hard decline means the card cannot be used at all β closed, expired, stolen, restricted, or invalid. A soft decline is one the issuer might approve on a later attempt, such as insufficient funds. Zenoti treats them differently: a hard decline flags the saved card and stops automatic retries on it. See Flag payment accounts for hard declines.
Payments are failing on only one card brand. Is that an org configuration problem?
Usually not. Filter the Failed Transaction Report by date range and compare the Card Brand and Failure Reason columns. Failures concentrated in a single brand, across every channel, point to the issuer or the card network rather than your Zenoti configuration β which you can confirm by taking a test payment on a card of a different brand. Failures spread across brands are more likely to be a processor or configuration issue; start with Set up a payment processor.
Can a card be declined because of what my business sells?
Yes. A card may not be enabled for your processor's merchant category code, which declines the transaction regardless of the card's balance or status. Confirm the category code with your processor β see Set up a payment processor.
A guest's card keeps declining at the POS. Should I retry it?
Not repeatedly. Repeated attempts on the same card can trigger the issuer's fraud rules and make the next attempt more likely to fail. Ask for a different payment method. See Payment processing.
The terminal approved the payment but Zenoti says the guest still owes. What happened?
The guest has not been charged. What happened is that the terminal captured an authorization hold on the card, but that hold was not confirmed as a completed payment in Zenoti β for example, if the connection between the terminal and Zenoti dropped after the card was tapped but before the result was recorded. The temporary hold is released automatically by the guest's bank, typically within 3 to 7 business days, depending on the guest's bank; no money leaves the guest's account. Do not charge the guest again straight away. For the full steps to resolve this, see the payment-errors article: Resolve payment errors.
Does adding or re-adding a terminal affect bank deposits?
No. Payouts are tied to the center's Zenoti Payments business account and its linked bank account, not to any specific terminal. Re-adding a terminal refreshes its configuration and rules out pairing problems between the device and Zenoti β it does not change payout routing in any way.
Another business appears on our terminals without our consent. Is this a security issue?
No, this is by design. The landing page on the terminal lists every business reachable under the same merchant account, including businesses that have no linked centers currently active. If you believe a business was added to your merchant account without authorization, contact Zenoti Support with your organization name and the name of the business shown on the terminal so the account can be reviewed. If the business is confirmed as unauthorized, Zenoti engineering can remove it from the merchant account.
Can Apple Pay be enabled for payment links at our centers?
Enabling Apple Pay for payment links is handled by Zenoti and is not a self-service setting. Contact Zenoti Support with your center name to have it enabled at the organization and center level. To check the current state of payment options at your center, navigate to Configuration > Payments > Process payments > Payment processor onboarding > Payment Options.
Is a guest's card saved automatically when they use the card machine?
It depends on the center's payment processor configuration and its card-on-file settings. In some configurations, a card used at the terminal is saved to the guest's profile for future use. To check whether a card was saved for a specific guest, open the guest's record and review their payment profile. If the behavior needs to change, or you notice an unexpected change in card-saving behavior, review the card-on-file configuration with Zenoti Support.
I get a "business details incorrect" message when I finalize the payment processor. What should I do?
Work through each of the following checks in order:
Confirm KYC is complete for the center β Know Your Customer verification must be fully approved before you can finalize the processor. Navigate to Configuration > Payments > Process payments > Payment processor onboarding and confirm the center's KYC/KYB status shows as verified.
Confirm the terminal serial number matches the label on the physical device β The serial number entered during onboarding must exactly match the number printed on the device label. A mismatch causes this error.
Confirm the terminal is powered on and connected to Wi-Fi β The terminal must be reachable on the network at the time you finalize the processor configuration.
Complete the terminal step under Payment processor onboarding β Navigate to Configuration > Payments > Process payments > Payment processor onboarding and ensure the terminal registration step is fully completed, not partially saved.
Check whether the terminal was purchased through Zenoti β A terminal that was not purchased through Zenoti can cause this message, because it may not be registered in the expected way. When contacting Zenoti Support, state where the terminal was purchased so the support team can identify the correct resolution path.
3D Secure (3DS)
3D Secure (3DS) is an additional authentication layer for online card transactions. Supported on Zenoti Payments with the Adyen processor.
What is 3DS?
3DS requires cardholders to authenticate their identity during online checkout (via OTP, card PIN, or a passphrase set with their bank). The authentication step happens on a hosted page provided by the card issuer β not within Zenoti.
Which card networks support 3DS?
Visa, Mastercard, and American Express.
Which regions support 3DS?
3DS is currently supported for USA, UK, Australia, New Zealand, South Africa, UAE, and India. Zenoti is expanding 3DS to additional regions β verify current availability with your account manager.
Does 3DS guarantee chargeback protection?
No. 3DS shifts liability for fraud-category chargebacks to the issuing bank β meaning if a fraudulent transaction passes 3DS authentication, the bank (not the merchant) bears the loss. 3DS does not protect against service disputes, non-delivery claims, or any non-fraud reason code. Do not rely on 3DS as blanket chargeback protection.
What happens to 3DS-authenticated transactions that are later disputed as fraud?
When a 3DS-authenticated transaction is disputed for fraud, Zenoti Payments auto-defends the dispute using the 3DS authentication evidence. The dispute is typically resolved in the merchant's favor without requiring manual evidence submission.
Will 3DS reduce my authorization success rate?
No. 3DS authentication does not reduce authorization success rates. The additional authentication step happens before authorization; a completed 3DS flow proceeds to authorization on the same card network path as a non-3DS transaction.
What if the cardholder's bank doesn't support 3DS?
When the issuing bank does not support 3DS (for example, older prepaid cards or cards from banks that haven't implemented 3DS), the transaction routes through the standard non-3DS flow automatically. 3DS is attempted but not required for transaction completion.
How do I enable or disable 3DS?
3DS is configurable from Other Payment Settings in your Zenoti Payments configuration. Contact Zenoti Support if the option is not visible in your configuration.