ZenotiHelp

External gift card providers overview

ZTZenoti Docs Team Updated September 5, 2026 5 min readGuide

Zenoti can integrate with external gift card providers to manage gift card issuance, redemption, balance checks, and refunds through a third-party system. This integration uses the Credit Pooling Service (CPS), which acts as a bridge between Zenoti and the external provider. When an external provider is active, core gift card operations are routed through the provider instead of being handled natively within Zenoti.

Before you begin

  • No special permissions are required to read this overview.
  • To configure an external provider, you need the Edit permission under GiftCards in the Loyalty Manager section.
  • Obtain connection details and credentials from your external gift card provider before configuration.

How the Credit Pooling Service works

The Credit Pooling Service (CPS) is the integration layer that connects Zenoti to an external gift card provider. When you enable an external provider, the CPS handles communication between Zenoti and the provider for the following operations:

  • Purchase β€” When a gift card is sold, the CPS sends an issuance request to the provider. The provider assigns and activates the card, and Zenoti records the transaction locally.
  • Redemption β€” When a gift card is used as payment at checkout, the CPS sends a redemption request to the provider. The provider deducts the balance and returns a confirmation. If the transaction includes tips or surcharges, each component is sent as a separate redemption request.
  • Balance check β€” When a guest or staff member checks a gift card balance, the CPS queries the external provider for the current balance and card validity. Fraud indicators are also checked during balance lookups.
  • Refund β€” When a gift card sale is refunded or a redemption is reversed, the CPS sends the corresponding refund request to the provider. The provider restores the balance and Zenoti updates its local records.
  • Deactivation β€” When a gift card needs to be deactivated, the CPS sends a deactivation request to the provider.

All CPS transactions are logged in Zenoti for audit purposes, recording the Zenoti transaction ID, the CPS transaction ID, the gift card code, and whether the operation succeeded.

Supported providers

Zenoti supports three external gift card providers through the CPS integration.

Provider Description
SVS A third-party gift card processor that handles card issuance, activation, redemption, and balance management externally. SVS integration is supported on tablet only β€” it is not supported on phone POS. Centers configured for SVS cannot sell Zenoti gift cards, and an SVS card must be the only item on the invoice at the time of redemption.
ZenotiGiftCard Zenoti's native gift card provider routed through the Credit Pooling Service. Use this option when you want CPS-based processing while keeping gift card management within the Zenoti ecosystem.
DG (Digital Glue / Blackhawk) A third-party gift card processor that provides card issuance, redemption, and balance management services. Requires third-party gift card integration to be enabled for your organization.

Important: Zenoti supports only SVS, ZenotiGiftCard, and DG as external gift card providers. No other third-party providers are supported.

Only one provider can be active for an organization at a time. You select and activate the provider during the integration setup.

Provider configuration fields

Configuration fields differ by provider. The table below summarizes what each provider requires.

Provider Organization-level fields Center-level fields
SVS Provider-specific connection and authentication details Provider-specific center details
ZenotiGiftCard Provider-specific connection and authentication details Provider-specific center details
DG (Digital Glue / Blackhawk) API URL, API alias, username, password Store code only

Settlement information β€” including frequency, delay, type, start date, and readjustment percentages β€” applies where the provider supports it.

Important: For Blackhawk (DG), the organization-level fields are API URL, API alias, username, and password. The center-level field is the store code only. Do not attempt to configure WSDL URL, Merchant ID, Merchant Group ID, or Currency for Blackhawk β€” these fields are not present in the live product for this provider.

How external integration affects core flows

When an external provider is active, it changes how several core gift card operations work.

Purchase

During a gift card sale, Zenoti sends the purchase details to the external provider through the CPS. The provider issues the card and returns a confirmation. If the provider is unavailable or returns an error, the sale does not complete. Bonus gift cards configured on a template are also issued through the provider, provided they have not already been issued for the same transaction.

Redemption

At checkout, when a guest pays with a gift card, Zenoti sends the redemption amount to the provider. If the transaction includes tips or a service surcharge, each component is processed as a separate redemption transaction through the provider. A partial success is possible if one component fails while others succeed. Redemption through the Zenoti Mobile App (ZMA) is also supported when an external provider is active.

Refund

When you refund a gift card sale or reverse a redemption, Zenoti sends the refund request to the provider for each component that was originally redeemed β€” amount, tips, and service surcharge are each reversed separately. The provider restores the balance on its side, and Zenoti updates the local gift card record to reflect the change.

Balance check

Balance checks query the external provider directly. The provider returns the current balance and indicates whether the card is valid. Zenoti also checks for fraud indicators during balance lookups.

Deactivation

You can permanently deactivate a gift card through the provider integration. Deactivation is irreversible. Before deactivating a card, verify that the guest does not have a remaining balance they intend to use.

Organization vs center level configuration

External gift card integration can be configured at two levels:

  • Organization level β€” The active provider is set for the entire organization. All centers use the same provider by default. Zenoti checks whether external gift card integration is active at the organization level before routing operations through the CPS.
  • Center level β€” Individual centers can have their own provider settings, such as different authentication credentials or store codes. When both organization-level and center-level configurations exist, the center-level configuration takes precedence for that center.

For online guest transactions, Zenoti creates a master gift card record to ensure the card is properly tracked across the organization.

Active provider management

You manage the active provider for your organization from the gift card integration settings page. From this page, you can:

  • Set the active provider β€” Select which provider handles gift card operations for your organization.
  • Test the connection β€” Verify that Zenoti can communicate with the provider before activating it.
  • Update provider settings β€” Modify connection details, credentials, or merchant information.
  • Void a provider β€” Disable a provider configuration when you no longer use external integration.

When you change or void a provider, gift cards that were previously issued through the old provider remain in the system. Their balances and history are preserved, but new operations route through the new provider or through Zenoti's native processing.

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