Skip to main content

Architecture Overview

Coras acts as an aggregator between your application (the distributor) and multiple ticketing providers (Spektrix, Secutix, TourCMS, etc.). As a distributor, you interact only with the Coras API — you never communicate directly with providers.

┌──────────────┐ ┌──────────────┐ ┌──────────────────┐
│ Your App │ ──────▶ │ Coras API │ ──────▶ │ Ticket Providers│
│ (Distributor)│ ◀────── │ (Exchange) │ ◀────── │ (Spektrix, etc.)│
└──────────────┘ └──────────────┘ └──────────────────┘
│
▼
┌──────────────┐
│ Stripe │
│ (Payments) │
└──────────────┘

Key concepts:

ConceptDescription
AttractionA bookable event — either a theater show or a tour/activity
InstanceA specific date/time occurrence of an attraction
Price BandA seating section or tier with its own pricing (theater)
Price TypeA category of ticket (e.g., Adult, Child, Senior)
Booking SessionA temporary session (20 min TTL) that holds your reservations
ReservationA hold on tickets within a booking session
TransactionA confirmed and paid booking for one or more reservations

Attraction types:

IDTypeDescription
1THEATERTheater shows, concerts, sports matches, events with assigned seating
2TOURTours, activities, and sightseeing experiences