Configure gift card provider
The gift card provider accordion connects Zenoti to an external gift card network so cards issued on that network can be sold, balance-checked, redeemed, and refunded at the Point of Sale. It also hosts Zenoti's own credit pooling service, which settles gift card liability between the centers of a franchise. This article covers the accordion at organization and center scope for each provider tile.
Note: For conceptual background on how integrations work in Zenoti, see Integrations overview.
On this page
- Scope and when to use this
- Before you begin
- External-system prerequisites
- Network requirements
- Choose the provider
- Configure SVS
- Configure the Zenoti Gift Card credit pooling service
- Configure DG
- Verify the integration
- Delete the configuration
- Tips
- Troubleshooting
- Reconciliation
- What to configure next
- Related articles
Scope and when to use this
Use an external gift card provider when:
- Your organization belongs to a national or multi-brand gift card network whose cards must be honoured outside Zenoti's own database.
- You need real-time balance and transaction sync with an external gift card issuer.
Use the Zenoti Gift Card credit pooling service when:
- Your centers are separate legal entities (a franchise) and a gift card sold at one center is redeemed at another, so the liability has to be settled between them.
Do not use this accordion when:
- You sell Zenoti-issued gift cards at a single legal entity. Those are handled by built-in gift card functionality; see the gift card configuration articles in the Configurations category.
A center uses one gift card provider at a time.
Before you begin
Permission: Organization administrator access to configure gift card provider integrations.
- For an external network, your organization must have an active merchant relationship with the provider, and the provider must have issued the credentials listed below.
- For the credit pooling service, each participating center needs its bank account details at hand for the settlement payments.
- Test cards or a test merchant account from the provider let you verify the integration before going live.
External-system prerequisites
These are the responsibility of the gift card provider's merchant services team, not Zenoti:
- Merchant account active with the provider.
- Card program configured on the provider side: card ranges, denominations, issuing rules.
- Test credentials issued for integration testing, then production credentials once testing is complete.
- For SVS, division and store numbering assigned per Zenoti center.
Network requirements
The integration calls from Zenoti to the provider's API (outbound). Your network does not need to accept inbound traffic.
| Direction | Endpoint | Port | Purpose |
|---|---|---|---|
| Zenoti → Provider API | Provider-issued WSDL or API URL | 443 (HTTPS) | Balance query, redemption, activation, refund |
Choose the provider
- Navigate to Configuration > Integrations > Integration settings and expand the gift card provider accordion.
- In Provider, under
Select Your Gift Card Provider, select the tile for your provider: SVS, Zenoti Gift Card, or DG. The tiles offered depend on your organization's setup. - Select Continue. The Configuration panel opens with the fields for that provider.
Configure SVS
SVS is configured once for the organization and then per center.
Organization scope
In Configuration, under Account, enter the values SVS issued to you.
Field What to enter WSDL The SVS service endpoint URL (test or production). Merchant name Your registered merchant name with SVS. Merchant number The SVS merchant number. User name, User password The API credentials SVS issued. Invoice number The prefix Zenoti uses for the invoice references it sends to SVS. Routing Id The SVS routing identifier. Currency Canadian Dollar or United States Dollar; must match the SVS program. Default Provider Turn on to make SVS the default route for gift card numbers that match its card range. Select Test connection. Zenoti reports
Connection successorConnection failed.Select Save. Zenoti confirms with
Changes saved successfully.
Center scope
- Select the center in the center selector, expand the accordion, and open Configuration.
- Enter the center's Division and Store number as assigned by SVS.
- Select Save.
Centers without a saved division and store number fall back to Zenoti's built-in gift card behaviour.
Configure the Zenoti Gift Card credit pooling service
The credit pooling service is Zenoti's own settlement route for franchises. The organization defines how liability is settled; each center enrolls with its bank account.
Organization scope
- In Configuration, choose the Configuration type: New to create a corporate account, or Existing to link one that already exists.
- Enter the Merchant code and select Verify (or Generate a new code for a new account). Zenoti asks for the code with
Please enter merchant code. - Enter the Merchant name and the Subscriber name.
- Choose the Liability settlement type: Corporate pooling of funds, Franchise to Franchise settlement, or No funds transfer.
- Set the Settlement frequency (Monthly or Weekly), the Start date (Choose a date), and the Settlement delay in days. Zenoti rejects a delay above the cycle:
Delay cannot be greater than 7 days for monthly payouts,Delay cannot be greater than 6 days for weekly payouts. - Optionally set Sale amount adjustment (in %) and Redemption amount adjustment (in %) to adjust the settled amounts.
- Turn on Default Provider if pooled cards should be the default route, then select Save.
Center scope
- Select the center, open Configuration, and choose New or Existing for the center's account.
- Enter the Franchise Code and select Verify, then the Franchise Name.
- Under Centers, choose the centers that belong to this franchise (Select centers or Select all centers), and answer Is this a corp center? for the corporate location.
- Enter the bank account used for settlements: Account Owner Name, Aba Routing Number, Account Number, Confirm Account Number, Bank Name, and Bank Account Type (Business Checking or Business Savings). Zenoti validates the routing number (
Routing number should be a 9 digit number.) and the account number length. - Read the Authorization for Direct Payment via ACH (ACH Debits) text and select I authorize direct payments via ACH and accept the terms and conditions. Zenoti requires it:
Please check the Terms and Condition checkbox. - Select Save, then Verify bank account. Zenoti makes a small debit; when it clears, open the verification, read
Please check and enter the amount below to verify your bank account., enter the amount in Enter Amount, and select Verify. The account showsBank account verified; until then it readsBank account not verified. - Turn on Active for the center.
A corporate center cannot be deleted while franchises are attached to it (Cannot delete subscriber that is associated with a Corp franchise).
Configure DG
- In Configuration, enter the API URL, the API Alias, and the center's Store code issued by DG.
- Turn on Default Provider if DG cards should be the default route.
- Select Test connection, then Save.
Verify the integration
- Use a provider-issued test card (or a low-value live card, with permission).
- At the Point of Sale, check the card's balance, sell a test card if the provider supports Zenoti-initiated sales, redeem a small amount, and refund it. Confirm each step on the provider's portal.
- Clean up test invoices and deactivate the test card on the provider side.
If the provider is not configured for the center, the Point of Sale reports External GC not configured.
Delete the configuration
Select Delete configuration on the accordion to remove the provider setup for the current scope. Centers then fall back to Zenoti's built-in gift card behaviour. A configured corporate account that still has franchises reports Cannot delete already configured corporate. Please contact Zenoti support.
Tips
- Test before assigning centers. Run Test connection and a test transaction at one center before entering divisions and store numbers for the rest.
- Keep store and division numbers in a reference document. Each center has its own SVS values.
- For the credit pooling service, verify every bank account before the first settlement date. Unverified accounts are skipped at settlement.
- Reconcile weekly during the first month, then monthly once the integration is stable.
Troubleshooting
| Problem | Likely cause | Resolution |
|---|---|---|
Test connection reports Connection failed |
The WSDL or API URL is wrong or unreachable, or the credentials are wrong. | Confirm the endpoint and credentials with the provider; leading or trailing spaces are a common cause. |
Please enter values for all the fields on save |
A required field is empty. | Complete the highlighted fields. |
| External-card operations fail at one center but succeed at others | Division or Store number is missing or wrong for that center. | Confirm the values with the provider and save them at center scope. |
External GC not configured at the Point of Sale |
The center has no saved provider configuration. | Configure the center, or accept that it uses built-in gift cards only. |
Bank account not verified persists |
The micro-debit amount has not been entered, or was entered incorrectly. | Check the bank statement for the debit and enter the exact amount in Verify bank account. |
Delay cannot be greater than 7 days for monthly payouts |
The settlement delay exceeds the cycle. | Reduce Settlement delay. |
| Provider portal shows a transaction but Zenoti does not | A mid-flight transaction was lost after the provider processed it. | Use the provider portal as the source of truth and reconcile the invoice in Zenoti manually. |
Reconciliation
Reconcile external gift card activity against the provider's portal.
| Item | Zenoti side | Provider side | Match key | Cadence |
|---|---|---|---|---|
| Card sales | Invoice report filtered by gift card sales | Provider activation ledger | Card number + activation timestamp | Weekly |
| Redemptions | Payment report filtered by the external gift card payment method | Provider redemption ledger | Card number + redemption timestamp | Weekly |
| Refunds / reversals | Point of Sale refund report | Provider reversal ledger | Card number + reversal timestamp | Weekly |
| Settlements (credit pooling) | Settlement statements per franchise | Bank statement | Settlement date + amount | Every cycle |
What to configure next
Required:
- Gift card provider integration — day-to-day workflow for selling, redeeming, voiding, and refunding external cards.
Recommended:
- Integration metrics & monitoring — add the provider to the health dashboard.