Sell memberships using APIs
The membership sale workflow lets you list available memberships, generate invoices, process payments, and send confirmation emails through the Zenoti API. This four-step process supports both recurring and non-recurring membership 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.
- Membership plans must be created in Zenoti (recurring or non-recurring).
- Payment criteria must be configured for the membership (especially for recurring memberships).
- A payment processor must be active for the center.
Permission: Manage API Keys (under Administrator) -- Required to access Zenoti APIs.
Membership types
| Type | Payment model | Duration | Behavior |
|---|---|---|---|
| Recurring | Regular interval payments (typically monthly) | Ongoing until cancelled | Credits or services refresh each period; can be paused, stopped, or resumed |
| Non-recurring | One-time payment | Fixed duration (3, 6, or 12 months) | Auto-expires after credits are consumed or duration ends |
Steps
Step 1: Select a membership
Use the List All Memberships in a Center API to retrieve the available membership plans for the center. Select the membership plan the guest wants to purchase.
Step 2: Generate an invoice
Search for the guest. Use the Search for a Guest API to find the guest purchasing the membership.
Create a membership invoice. Use the Create an Invoice for Memberships API with the guest ID and selected membership details.
Alternatively, if the guest already has an open invoice, use the Add Membership to an Invoice API to add the membership 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 payment was applied.
Step 4: Close the invoice and send confirmation
Close the invoice. Use the Close an Invoice API to finalize the transaction.
Verify invoice status. Use the Retrieve Invoice Details API to confirm the invoice is closed.
Send confirmation email. Use the Send Email to Guest API to send a membership purchase confirmation to the guest.
Zenoti also supports configuring default post-closure actions for automated confirmation workflows.
Tips
- For recurring memberships, ensure the guest has a saved payment method on file for future automatic collections.
- Use the Guest Memberships APIs to manage the membership lifecycle after sale (change membership, cancel auto-renewal, freeze, unfreeze).
- Track membership sales and revenue through the Report APIs.