About the Ticket Definitions V3 API

With the Ticket Definitions 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.

Before you begin

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

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

Use cases

Terminology

  • Pricing method: Different pricing methods are available for events.
    • Fixed price: All tickets in the same definition are sold at the exact same price, regardless of when they're purchased or other factors.
    • Guest price: The guest enters the ticket price. Optionally, you can set the minimum price guests must pay for a ticket. This pricing method is applied to donation.
    • 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 type can also include availability limits and timeframes for ticket sales.
  • Sale period: Duration of time during which event tickets are available for purchase.
  • Event dashboard: Control center in the Wix site UI for managing site event settings and features.
Did this help?