Sell products using APIs
The product sale workflow lets you retrieve product catalogs, generate invoices, and process payments through the Zenoti API. This three-step process supports retail product sales through external storefronts, kiosks, or custom applications.
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.
- Products must be added to the center with the Retail designation.
- A payment processor must be active for the center.
Permission: Manage API Keys (under Administrator) -- Required to access Zenoti APIs.
Steps
Step 1: Choose a product
Use the List All Products of a Center API to retrieve the product catalog for the center.
Important: Select only products where the retail parameter is
true. Products not marked as retail are not available for direct sale to guests.
Step 2: Generate an invoice
Search for the guest. Use the Search for a Guest API to find the guest purchasing the product.
Create a product invoice. Use the Create an Invoice for Products API with the guest ID and selected product details.
Alternatively, if the guest already has an open invoice (for example, from a service booking), use the Add a Product to the Invoice API to add the product to the existing invoice.
Step 3: Collect payment
After generating the invoice, collect payment:
Verify invoice details. Use the Retrieve Invoice Details API to confirm the invoice amount.
Retrieve saved cards. Use the Retrieve Saved Cards API to check for a card on file.
Collect payment. Use one of the following approaches:
- Saved card -- Process payment with the guest'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.
- Verify completion. Use the Retrieve Invoice Details API to confirm the invoice is closed.
Tips
- Filter the product list by category or search term to help guests find products quickly in your external storefront.
- Combine product sales with service bookings on a single invoice for a faster checkout experience.
- Track inventory levels using the Inventory APIs to display stock availability in your application.