ZenotiHelp

Digital Payment Options & Filtering

ZTZenoti Docs Team Updated September 9, 2026 4 min readGuide

Zenoti supports filtering digital payment options using a composable filter framework. You can combine multiple filter criteria with AND or OR logic to control which payment options appear for a given transaction context β€” for example, restricting options by country, currency, payment category, or transaction amount.

Audience: Organization administrators and center managers who configure payment processor behavior for their centers.

Before you begin

  • Your organization must have at least one active payment processor configured. For processor setup, see Set up a payment processor.
  • You need access to payment configuration settings in Zenoti. Contact your organization administrator if you do not have access.

Note: Digital payment option filtering is a configuration capability within the payment processor framework. It does not replace processor setup β€” it refines which options the processor presents based on the criteria you define.

Steps

Understand how the filter framework works

The filter framework evaluates payment options against a set of criteria before presenting them to the guest or front-desk staff. Each filter you configure narrows the set of eligible payment options.

Filters can be combined using:

  • AND logic β€” a payment option must satisfy all specified criteria to be included.
  • OR logic β€” a payment option must satisfy at least one of the specified criteria to be included.

The following filter types are supported:

Filter type What it evaluates
Country or currency Whether the payment option is available for the transaction's country or currency
Country code A specific country code associated with the payment option
Payment option category The category the payment option belongs to (for example, card, digital wallet)
Payment option UI code The specific identifier used to display the payment option in the interface
Transaction amount Whether the transaction amount falls within the range the payment option supports

Define your filter criteria

Before configuring filters, determine which criteria apply to your business:

  1. Identify the countries and currencies your centers operate in.
  2. Identify any payment option categories you want to restrict or allow β€” for example, limiting options to card payments only, or excluding certain digital wallet types.
  3. Identify any transaction amount thresholds that should restrict payment options β€” for example, a payment option that is only valid for transactions above a minimum amount.
  4. Determine whether your criteria should be combined with AND logic (all must match) or OR logic (any must match).

Tip: If you operate centers in multiple countries, use country code filters to ensure guests see only the payment options available in their region. For processing payments at the point of sale, see Payment processing.

Apply filters to payment options

Work with your Zenoti administrator or implementation team to apply filter configurations to your payment processor setup. The filter framework is configured at the organization or center level, depending on your processor configuration.

When configuring filters, specify:

  1. Filter type β€” select from country or currency, country code, payment option category, payment option UI code, or transaction amount.
  2. Filter value β€” enter the specific value for the selected filter type (for example, a country code such as US, a currency code such as USD, or a minimum and maximum transaction amount).
  3. Logical operator β€” specify whether this filter combines with other filters using AND or OR logic.

Repeat this process for each filter criterion you want to apply. Filters are evaluated in combination according to the logical operators you specify.

Verify filter behavior

After applying filter configurations, verify that the correct payment options appear in the expected contexts:

  1. Create a test transaction in a center where the filters apply.
  2. Confirm that only the payment options matching your filter criteria are presented.
  3. If a payment option appears that should be excluded, review the filter criteria and logical operators for that option.
  4. If an expected payment option does not appear, confirm that the option's country, currency, category, UI code, and transaction amount all satisfy the filter conditions you defined.

Important: Test filter configurations before applying them to live transactions. An incorrectly configured filter can prevent valid payment options from appearing at checkout, which affects the guest experience.

Tips

  • Use AND logic when you need strict control β€” for example, a payment option that must match both a specific country code and a minimum transaction amount.
  • Use OR logic when you want to broaden eligibility β€” for example, a payment option that is valid for either of two currencies.
  • If you operate in a region with specific compliance requirements, combine country code filters with payment option category filters to ensure only compliant options are presented. For regional compliance e-invoicing, see the relevant setup articles in this category.
  • Review your filter configurations whenever you add a new payment processor or expand to a new country or currency.
  • Payment option UI codes are specific to your processor configuration. Confirm the correct codes with your payment processor documentation or your Zenoti implementation team before using them as filter criteria.

Troubleshooting

Symptom Likely cause Resolution
A payment option does not appear at checkout A filter is excluding it Review all active filters for that payment option. Check whether AND logic is requiring a condition that the current transaction does not satisfy (for example, a country code or amount threshold).
An unexpected payment option appears at checkout A filter is not applied or is configured with OR logic that is too broad Review the logical operators on your filters. If OR logic is in use, confirm that the conditions are specific enough to exclude unwanted options.
Filters appear to have no effect The filter configuration may not be saved or may be applied at the wrong level (organization vs. center) Confirm with your Zenoti administrator that the filter configuration was saved and is applied to the correct center or organization scope.
Was this article helpful?
Your feedback helps us improve our documentation.