Documentatie

Bouw op Tikitfy

Een REST API, webhooks, een embeddable checkout en native scanning-SDK's. Alles wat je dashboard kan, kan je code ook.

QuickstartAPI-referentie
Quickstart

Je eerste event in drie calls

1

Maak een API key aan

Dashboard → Instellingen → Developers. Test keys beginnen met sk_test_ en verplaatsen nooit echt geld.

2

Maak een event en een tickettype aan

Twee POST-requests. Prijzen zijn hele getallen in centen; tijden zijn ISO 8601 met tijdzone.

3

Publiceer en embed

Zet het event op live en plaats de checkout-embed op je site — of link direct naar je hosted shop.

# 1. Create an event
curl https://api.tikitfy.nl/v1/events 
  -u sk_test_51Hxk…: 
  -d name="Neon Night · Friday" 
  -d starts_at="2026-10-09T23:00:00+02:00" 
  -d venue="ven_9f2a" 
  -d currency=eur

# 2. Add a ticket type (price in cents)
curl https://api.tikitfy.nl/v1/events/evt_7c1d/ticket_types 
  -u sk_test_51Hxk…: 
  -d name="Early Bird" -d price=1750 -d quantity=400

# 3. Go live
curl -X POST https://api.tikitfy.nl/v1/events/evt_7c1d/publish 
  -u sk_test_51Hxk…:
Handleidingen

Leer per taak

Authenticatie

API keys, scoped tokens voor scanners en OAuth voor marketplace-apps.

Events, tickettypes & plattegronden

Modelleer alles, van een clubnacht tot een stadion met 40.000 plaatsen, inclusief vakken en holds.

Orders & refunds

Maak orders server-side aan, geef gedeeltelijke refunds en lees uitbetalingsrapporten uit.

Webhooks

order.paid, ticket.scanned, refund.created en nog 14 andere — signed, met retries, opnieuw af te spelen.

Scanning-SDK

Offline-first validatie voor iOS, Android en Zebra-apparaten, met regels per toegangszone.

Embeds & hosted shop

Drop-in checkout, agenda-widgets en theming met je eigen CSS-variabelen.
API-referentie

Belangrijkste endpoints

Base URL https://api.tikitfy.nl/v1 · JSON erin en eruit · idempotency keys op elke POST.

Endpoint Omschrijving
GET /events Events ophalen, filter op status, datumbereik of locatie
POST /events Een event aanmaken
POST /events/{id}/ticket_types Een tickettype toevoegen met prijs, aantal en verkoopperiode
GET /orders Orders ophalen; tickets, koper en betaling meeladen
POST /orders Een vrijkaart- of box-office-order aanmaken
POST /refunds Een order, een ticket of een bedrag refunden
GET /tickets/{id}/validate Een barcode valideren voor een apparaat en zone
POST /webhooks Een endpoint registreren en events kiezen
DELETE /webhooks/{id} Een webhook-endpoint verwijderen
GET /payouts Uitbetalingsbatches met uitsplitsing per order

Rate limit van 600 requests / minuut per key. De sandbox op api.sandbox.tikitfy.nl spiegelt productie, met testkaarten.

SDK's

Officiële client libraries

Node.js npm i tikitfy PHP composer Python pip install tikitfy Ruby gem iOS Swift Package Android Maven

Plus integraties voor WordPress, Shopify, Mailchimp, Klaviyo, HubSpot en Zapier — zonder code.

Developers

Vragen over de API?

Ons developer-supportteam antwoordt in het #api-kanaal van de Tikitfy Community Slack en op [email protected].

Vraag een sandbox key aanMail developer support