About the Ticket Definitions V3 API

With the Ticket Definitions V3 API, you can create definitions for tickets. A definition includes the following ticket settings:

• Fee type. Determines whether the fee is paid by a guest or a seller.
• Pricing. Defines different ticket prices based on factors such as early bird discounts, VIP packages, group rates, or special promotions. Several pricing methods are available for you to select from: Fixed price, Guest price, Free. Additionally, you can customize prices for different groups of people using Price options.
• Availability. Set the ticket limit available to buy. Also, you are able to check the number of purchased or reserved tickets.
• Sale period. Set the sale start and end dates. Also, when defining the sale period, it's possible to choose to display event tickets to customers even before the sale starts.
• Seating details. These details are read-only and seats can be assigned to ticket definitions only through the dashboard when creating a seating map. Also, you can use this information to display a list of seats for customers to select.

Before you begin

It's important to note the following before starting to code:

• A site must have Wix Events & Tickets installed.
• A ticket definition isn't the same as a ticket. Ticket definitions define settings for a set of tickets. After a customer pays for selected tickets, the Orders API automatically generates the tickets.

Use cases

• Add a specific-price ticket counter for an event
• Sync ticket definitions with an external ticketing system
• Notify customers when tickets go on sale

Terminology

• Pricing method: Different pricing methods are available for events.
  • Fixed price: All tickets in the same definition are sold at the same price, regardless of when they're purchased or other factors.
  • Guest price: The guest enters the ticket price. Optionally, you can set a minimum price guests must pay for a ticket. This pricing method is applied to donations.
  • Price options: All tickets in the same ticket definition are priced at different rates, such as different prices for adults, children, and students.
• Ticket availability: The status of ticket inventory, indicating whether tickets are available or sold out. This can also include availability limits and timeframes for ticket sales.
• Sale period: The duration of time during which event tickets are available for purchase.
• Event dashboard: A control center in the Wix site UI for managing site event settings and features.