API dla Twojego CRM
Połącz swój CRM lub narzędzia raportowe z TixFlow i odczytuj swoje wydarzenia, zamówienia, uczestników i klientów.
Co daje API
REST API tylko do odczytu Twoich własnych danych: wydarzenia, zamówienia (z biletami), uczestnicy (bilety z nazwiskami gości i wejściami) oraz klienci (każdy, kto u Ciebie kupił, jeden wpis na adres e-mail). Pełna dokumentacja jest pod adresem /developers/api.
Tworzenie klucza
Portal → Ustawienia → API & MCP → Klucze API → Utwórz klucz.
- Nadaj kluczowi nazwę (np. „Synchronizacja HubSpot”) i wybierz, co może odczytywać.
- Potwierdź, że Twoja organizacja jest administratorem eksportowanych danych kupujących.
- Skopiuj klucz od razu – jest wyświetlany tylko raz. Jeśli go zgubisz, unieważnij go i utwórz nowy.
Klucze może tworzyć i unieważniać tylko właściciel profilu organizatora. Klucz odczytuje wyłącznie dane organizatora, dla którego został utworzony.
Wywoływanie API
Wysyłaj klucz w nagłówku Authorization:
curl https://tixflow.org/api/v1/orders?createdFrom=2026-10-01T00:00:00Z \
-H "Authorization: Bearer tf_live_…"
Listy zwracają data, nextCursor i hasMore. Dopóki hasMore jest true, wywołuj ponownie z cursor=<nextCursor>.
Bieżąca synchronizacja CRM
Sortuj według updatedAt i zapisz ostatni nextCursor. Następnym razem odeślij go, a otrzymasz tylko zmiany – nowe zamówienia, zwroty, wejścia.
# first run: everything, oldest change first
GET /api/v1/orders?sort=updatedAt
# store nextCursor; next run, only what changed since:
GET /api/v1/orders?sort=updatedAt&cursor=<stored nextCursor>
- Ten sam rekord może przyjść dwa razy – aktualizuj według
idzamiast dodawać nowy. - Zmiany z ostatnich kilku sekund pojawią się przy kolejnym wywołaniu.
- Usunięcia nie są zgłaszane.
Zgoda marketingowa
Przy każdym zakupie online kupujący może zaznaczyć dobrowolne pole, że chce otrzymywać Twoje nowości. API zwraca odpowiedź jako marketingConsent: true, false lub null, jeśli nigdy nie zapytano (sprzedaż na miejscu, starsze zamówienia). API eksportuje wszystkich kupujących niezależnie od odpowiedzi – to Ty jako administrator decydujesz, na co ona pozwala.
Dopasowanie zamówień do Stripe
Każde zamówienie zawiera identyfikatory Stripe swojej płatności – checkoutSessionId (cs_…) i paymentIntentId (pi_…), również starsze zamówienia. Płatności trafiają bezpośrednio na Twoje własne konto Stripe, więc oba znajdziesz w swoim panelu Stripe. W modelu Merchant of Record znajdują się natomiast na koncie Stripe TixFlow.
- Sprzedaż przez Tap to Pay ma
paymentIntentId, ale nie macheckoutSessionId. - Zamówienia z listy gości i bezpłatne nie mają żadnego z nich (
null) – przez Stripe nie przeszły żadne pieniądze.
Skąd przyszło zamówienie
Zamówienie, które przyprowadził jeden z Twoich linków śledzących, zawiera go jako trackingLink: jego code i label nadany w Analityka → Źródła ruchu. Dla pozostałych zamówień jest to null. Link się liczy, jeśli kupujący kliknął go jako ostatni przed zapłatą albo użył przypisanego do niego kodu promocyjnego.
Limity
120 zapytań na minutę na klucz. Każda odpowiedź zawiera X-RateLimit-Remaining; po osiągnięciu limitu odczekaj Retry-After sekund.
Często zadawane pytania (FAQ)
Czy mogę zmieniać dane przez API?
Nie. API służy tylko do odczytu: zwraca Twoje wydarzenia, zamówienia, gości i klientów, ale niczego nie tworzy, nie zmienia ani nie zwraca. Zmiany wprowadzaj w portalu.
Czy API zwraca kody QR biletów?
Nie. Kody QR nigdy nie są eksportowane, więc wyciek klucza nie pozwoli wejść na Twoje wydarzenia. Goście dostają bilety e-mailem jak zwykle.
Dlaczego e-mail kupującego jest pusty (null)?
Przy sprzedaży przez Tap to Pay adres kupującego jest nieznany, dopóki nie poprosi o paragon, więc API zwraca null zamiast wartości zastępczej.
Czy id zamówienia jest takie samo jak w portalu?
Nie. API nadaje każdemu zamówieniu własny publiczny identyfikator. Aby dopasować zamówienie do płatności, użyj checkoutSessionId lub paymentIntentId – zobacz sekcję o Stripe powyżej.
Co się stanie, gdy unieważnię klucz?
Od razu przestaje działać: każde żądanie z jego użyciem jest odrzucane. Utwórz nowy klucz i zaktualizuj go w CRM.