ZenotiHelp

External gift card provider settings β€” SVS and ZenotiGiftCard behavior

ZTZenoti Docs Team Updated October 16, 2026 6 min readHow-to

This article explains how Zenoti's point of sale (POS) distinguishes between external gift card providers and applies provider-specific rules during balance lookups and gift card number generation. Understanding this behavior helps you avoid accidentally deactivating unissued cards when using the SVS provider.

Note: For conceptual background on gift card operations at checkout, see Sell and redeem gift cards with the New POS Experience.


On this page


Before you begin

  • Your organization must have an external gift card provider configured and active.
  • You need access to the point of sale (POS) to perform gift card balance lookups at checkout.
  • Confirm with your administrator which external gift card provider your organization uses (SVS or ZenotiGiftCard) before training staff on balance lookup procedures.

Permission: Performing gift card transactions at checkout requires the Add, Edit, and ContextMenu permissions under Security Roles > [your role] > Permissions tab > Appointment Book.


How provider identification works

When a guest presents an external gift card at checkout, the POS identifies the provider from the configuration payload associated with the gift card. The system reads the provider identity from either a settings or config key in the payload, and from either the processor identifier or name field β€” whichever is present. This ensures the POS handles both older and current configuration formats correctly without requiring manual intervention.

Once the provider is identified, the POS applies the rules specific to that provider for all subsequent actions on the card, including balance lookups and gift card number generation.

The two supported external gift card providers and their key behavioral differences are summarized below.

Attribute SVS ZenotiGiftCard
Provider type Stored Value Systems Zenoti-native gift card path
Second balance lookup on unissued card Deactivates the card No effect
User warning on second lookup Yes β€” POS informs the user Not applicable
External gift card number generation Supported Supported

SVS provider β€” balance lookup behavior

The SVS (Stored Value Systems) provider treats a second balance inquiry on an unissued card as a deactivating action. This is a constraint of the SVS platform, not a Zenoti setting.

What this means in practice:

When a front desk employee looks up the balance of an SVS gift card that has not yet been issued to a guest:

  • The first balance lookup is safe and returns the card's current balance.
  • A second balance lookup on the same unissued card causes SVS to deactivate the card.
  • The POS informs the user that a second balance check on an unissued SVS card will deactivate it, so the user can avoid performing the extra lookup.

To look up an SVS gift card balance safely:

  1. At the POS checkout screen, select the gift card payment option.
  2. Enter or scan the gift card number.
  3. Review the balance returned from the first lookup.
  4. Do not perform a second balance lookup on the same unissued card.

Important: If the POS displays a warning that a second balance lookup will deactivate the card, do not proceed with the second inquiry. Inform the guest and use the balance returned from the initial lookup to complete the transaction.


ZenotiGiftCard provider β€” balance lookup behavior

For the ZenotiGiftCard provider, performing a second balance lookup on an unissued card does not deactivate it. Staff can check the balance of a ZenotiGiftCard-issued card more than once during a checkout session without any risk to the card's status.

To look up a ZenotiGiftCard balance:

  1. At the POS checkout screen, select the gift card payment option.
  2. Enter or scan the gift card number.
  3. Review the balance displayed.
  4. If needed, perform an additional balance lookup β€” this does not affect the card's issued status.

Generate a gift card number from an external provider

When your organization's external gift card provider supports external gift card number generation, the POS can request a card number directly from the provider rather than using Zenoti's internal number generator. This section describes how the generation flow works at the gift card sell screen.

How the Generate action works:

  • When the gift card sell screen determines that an external card number can be generated and no generation is currently in progress, a Generate GC # action becomes available.
  • While number generation is in progress, the Generate GC # action is disabled to prevent duplicate requests.
  • If generation succeeds, the card number field is populated with the number returned by the provider.
  • If generation fails, an error message is displayed and the card number field remains editable so you can enter the number manually.

To generate a gift card number from the external provider:

  1. On the gift card sell screen, locate the Card Number field.

  2. Select Generate GC # to request a card number from the configured external provider.

    Note: The Generate GC # action is available only when the POS confirms that the provider supports external number generation and a generation request is not already in progress. If the action does not appear, the provider does not support this capability or the card number field already contains a value.

  3. Wait for the provider to return a number. The Generate GC # action is disabled while the request is in progress.

  4. If the card number field is populated after the request completes, the number has been generated successfully. Proceed with the gift card sale.

  5. If an error message is displayed, the provider was unable to generate a number. Enter the card number manually in the Card Number field.

Worked example: A front desk employee is selling a $50 SVS gift card to a guest. On the gift card sell screen, they click Generate GC #. The action greys out for a moment while the POS contacts SVS. A few seconds later, a 16-digit number appears in the Card Number field. The employee confirms the number with the guest and selects Add Gift Card to complete the sale.


Tips

  • Train front desk staff on which external gift card provider your organization uses before they handle gift card transactions. The deactivation risk applies only to SVS cards, but all staff should know which provider is active.
  • If you are unsure whether a card has been issued yet, treat it as unissued and limit lookups to one inquiry per checkout session when using SVS.
  • For organizations using SVS, consider noting the card balance immediately after the first lookup so staff have a reference without needing a second inquiry.
  • When a Generate GC # request fails, the card number field remains editable. Staff can enter the number manually from a physical card or from the number provided by the SVS representative.
  • The POS resolves the provider identity automatically from the configuration format. No manual selection of the provider is required at checkout.

Troubleshooting

An SVS gift card appears deactivated after a balance check

A second balance inquiry on an unissued SVS card triggers deactivation on the SVS platform. This action originates from SVS and cannot be reversed from within Zenoti. Contact your SVS account representative to request card reactivation.

The Generate GC # action is not visible on the gift card sell screen

The Generate GC # action appears only when the configured provider supports external number generation and no generation is currently in progress. If the action is absent, either the provider does not support this capability or the card number field already contains a value. Check with your administrator to confirm whether your provider supports external number generation.

The Generate GC # action is visible but disabled

A generation request is already in progress. Wait for the current request to complete. If the action remains disabled for an extended period, an error message should appear. If it does not, refresh the POS session and try again.

The POS does not display a provider-specific warning during balance lookup

Verify that the external gift card provider configuration is complete and that the provider payload includes the required provider identification fields. If the provider cannot be identified, the POS may not apply the correct provider rules. Contact your Zenoti administrator to review the gift card provider configuration.

Staff are unsure which gift card provider is configured

Review the active external provider in the gift card configuration area in Zenoti. For gift card program configuration and provider setup, see Gift card management.


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