BrightStar supports unlimited ticket types per event with flexible pricing, availability windows, and purchase limits. This guide covers the complete ticket configuration options.
Ticket Object Schema
json
{
"id": "tkt_abc123",
"event_id": "evt_xyz789",
"name": "Early Bird",
"description": "Save 20% - limited availability",
"price": 8000, // In cents ($80.00)
"currency": "usd",
"quantity_total": 100,
"quantity_sold": 45,
"quantity_available": 55, // Computed
"sale_start": "2025-01-01T00:00:00Z",
"sale_end": "2025-03-01T00:00:00Z",
"min_per_order": 1,
"max_per_order": 10,
"visibility": "public", // public | hidden | members
"hidden_url": null, // For hidden tickets
"sort_order": 1,
"category_id": null, // For grouped display
"metadata": {} // Custom key-value pairs
}Interactive ticket builder
Interactive component coming soon
Pricing Options
Fixed Price
Standard ticket at set price
Example: $100.00 General Admission
Free Tickets
Price: 0 (zero)
Use case: RSVPs, community events
Donation-Based
Min price: $0, Max: unlimited
Buyer chooses amount at checkout
Tiered/Sliding Scale
Multiple ticket types at different prices
Same access level, different price points
Pay What You Can
Suggested price with $0 minimum
Configure via description guidance
Availability Windows
Sale Start/End Dates Tickets only purchasable within this window. Times displayed in event timezone.
Quantity Limits • quantity_total: Maximum tickets available • Reserved: Held in cart (5 minutes) • Sold: Completed purchases • Available: Computed real-time
Per-Order Limits • min_per_order: Minimum purchase (default: 1) • max_per_order: Maximum per transaction (default: 10)
Visibility Settings
Public
Visible to everyone on event page.
Hidden
Only accessible via direct URL.
Generate link: Settings → Hidden Ticket Link
Use case: VIP invites, comps, special offers
Members Only
Visible only to logged-in members.
Requires membership system integration.
Ticket availability flow diagram
Interactive component coming soon
Advanced Features
Configure these in ticket settings:
- Ticket categories (group related tickets visually)
- Add-ons (meals, merchandise, upgrades)
- Bundle pricing (buy 3 get 10% off)
- Group discounts (10+ tickets = discount)
- Transfer restrictions (allow/prevent sharing)
- Waitlist (auto-enable when sold out)
Set min_per_order > 1 for couples tickets or group experiences. This ensures buyers purchase the correct quantity for the experience.