ZenotiHelp

Sell gift cards using APIs

ZTZenoti Docs Team Updated March 7, 2026 3 min readGuide

The gift card sale workflow lets you select templates, generate invoices, process payments, and send confirmation emails through the Zenoti API. This four-step process supports amount-based, service-based, and predefined gift card sales.

For complete endpoint documentation including request/response schemas and code examples, see the individual API reference articles linked below.

Before you begin

  • You need a valid API key or access token. See Set up API authentication.
  • Gift card templates must be configured in Zenoti (under Admin > Setup > Gift Card Templates).
  • A payment processor must be active for the center.

Permission: Manage API Keys (under Administrator) -- Required to access Zenoti APIs.

Gift card types

Type Description
Amount gift card A gift card with a specific monetary value
Service gift card A gift card redeemable for specific services or day packages at set prices
Predefined gift card An administrator-configured combination with a custom name and bundled items

Implementation methods

You can sell gift cards through the API using two methods:

  • Method 1: Direct invoice creation -- Create a gift card invoice without using templates.
  • Method 2: Template-based (recommended) -- Use the four-step workflow described below for a structured approach with gift card templates.

Steps

Step 1: Select a gift card template

Choose a template based on the gift card type:

  • Predefined amount: Use the List All Templates API to retrieve templates configured in Zenoti. Select the template matching the desired amount.
  • Custom amount: Use the Create a Gift Card Template with Custom Amount API to create a one-time template with a specific value.
  • Service or package gift card: Use the creation API with service and package IDs. Retrieve available services with the List All Services of a Center API and packages with the List All Packages of a Center API.

Step 2: Generate an invoice

  1. Search for the guest. Use the Search for a Guest API to find the purchaser.

  2. Retrieve occasions. Use the List All Occasions API to get available gift card occasions (for example, Birthday, Holiday) and associated images.

  3. Generate the invoice. Use the Create a Gift Card Sale Invoice After Using a Gift Card Template API with the guest ID, template ID, and occasion details.

Step 3: Add payment

After generating the invoice, collect payment:

  1. Verify invoice details. Use the Retrieve Invoice Details API to confirm the invoice amount.

  2. Retrieve saved cards. Use the Retrieve Saved Cards API to check for a card on file.

  3. Collect payment. Use one of the following approaches:

  • Saved card -- Process payment with the purchaser's saved card.
  • New card -- Process a new card payment.
  • Custom payment -- Use the Insert Custom Payments API for third-party processors.
  • Cash -- Record a cash payment.
  1. Verify completion. Confirm the payment was applied to the invoice.

Step 4: Send confirmation

  1. Send the gift card email. Use the Send Email to Guest API to send the gift card to the recipient's email address.

  2. Verify the balance. Use the Check Gift Card Balance API to confirm the gift card was created with the correct value.

Tips

  • Use occasions to categorize gift cards (Birthday, Holiday, Thank You) and provide occasion-specific imagery in your storefront.
  • For eGift cards, the recipient receives the gift card details by email. For physical gift cards, coordinate shipping or pickup through your fulfillment process.
  • Guests can check their gift card balance through the API or through the guest-facing portal.

API reference

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