Introduction
Jetron Fluid lets you sell Jetron Ticket events from your own site, either with an embedded checkout or our API.
Jetron Ticket is the ticketing platform: it owns your events, ticket inventory, payments, and ticket delivery. Jetron Fluid is how you bring that platform into your own product, so attendees buy tickets on your site under your brand instead of being sent somewhere else.
Fluid gives you two ways to sell, and you can mix them across events.
Checkout Embed
Add one line of code to your page. Jetron shows the tickets, collects the buyer's details, and takes payment, all in your brand colour.
API
Build the buying experience yourself with our REST API and TypeScript SDK. Jetron tracks what is left, takes payment, and sends out the tickets.
Both options are backed by the same events and the same inventory, and both can notify your server through webhooks when a purchase completes.
Which one should I use?
| Checkout Embed | API | |
|---|---|---|
| What you do | Paste one line of code into your page | Build the ticket buying screens yourself |
| Who sets it up | Anyone who can edit your website | A developer |
| How it looks | Your brand colour, in light or dark | Exactly how you design it |
| Taking payment | Built in | Built in |
| Best for | Selling quickly from a page you already have | A buying experience that is completely your own |
If you are not sure, start with the embed. You can move an event to the API later without changing anything about the event itself.
How the API flow works
Browse events
List your public events and their tickets with GET /events,
GET /events/{slug}, and GET /events/{slug}/tickets.
Reserve tickets
POST /events/{slug}/reservations prices the cart and holds the stock for a
limited window. You get back a reservationToken and a quoteReference.
Check out
POST /events/{slug}/orders completes checkout. Paid orders return a
checkoutUrl to redirect the attendee to. Free orders are confirmed
immediately.
Read the checkout flow guide for the full walkthrough.
See it running
boba.jtr.rsvp is a complete white-labelled event site built on Fluid. It uses the embed on some events and the API on others, and it receives and verifies webhooks. The whole site is open source at jetronmall/boba-event, and Example site walks through how it is put together.
Next steps
Quickstart
Make your first request in minutes with curl or the SDK.
TypeScript SDK
@jetronticket/api, a typed zero-dependency client for browsers and Node.js.
Webhooks
Get notified server-side when a purchase completes, and verify the signature.
API Reference
Every endpoint, with schemas, code samples, and an interactive playground.
Good to know
- All events are automatically scoped to the event host that owns your API key.
- Successful responses are wrapped in an envelope:
{ "data": <payload>, "status": true }. - Monetary amounts are integers in the smallest currency unit. See Money.
- Seat Map events cannot be sold through the API yet and return
400. Use the embed for those events.