Skip to main content
TMT uses Seats.io to power interactive, visual seat selection for events with assigned seating. Seats.io manages the spatial layout of a venue — rows, sections, general admission areas — and tracks seat-level status in real time. TMT’s native ticket system handles everything downstream: ticket generation, order processing, access control, and payment. The two systems are linked at the event level: a Seats.io event references a chart (the venue layout) and a TMT event ID. When a customer selects seats, TMT calls Seats.io to hold them, processes payment, then calls Seats.io again to confirm the booking — keeping the interactive chart in sync with the sold state.

​
Key concepts

ConceptDescription
ChartA reusable venue layout designed in the Seats.io chart designer. Contains sections, rows, seats, and general admission (GA) areas.
Seats.io eventAn instance of a chart tied to a specific TMT event. The chart defines the layout; the event tracks per-seat status (available, held, booked).
Hold tokenA short-lived token that temporarily reserves a set of seats while a customer completes checkout. Created with a configurable expiry (default: 10 minutes).
Seat bookingThe final confirmation step that marks seats as booked in Seats.io. This is separate from TMT ticket generation, which produces scannable ticket documents.
GA areaA general admission section where seats are not individually numbered. Booked by specifying an objectId and a quantity rather than individual seat labels.

​
Typical seat reservation flow

Customer selects seats
        │
        ▼
  hold_seats_seatsio          ← seats are held; hold token returned
        │
        ▼
  Payment processing
   ┌────┴────┐
Success    Failure
   │           │
   ▼           ▼
book_seats  release_seats     ← or expire_hold_token on timeout
   │
   ▼
TMT ticket generation & order creation
Seats.io seat status and TMT ticket status are independent. book_seats_seatsio updates the Seats.io chart so the seat appears sold to other buyers. TMT ticket documents must be generated separately via tickets_generate.

​
Subsystems

Seating Charts

Manage venue layouts: list charts, retrieve published versions, inspect seat objects, copy charts, and apply tags for organisation.

Seat Management

Create Seats.io events, hold and release seats, expire hold tokens, and confirm bookings for both assigned and general admission seating.

Build docs developers (and LLMs) love

Get started for freeTalk to us