Centrum Pomocy

Poradniki dotyczące konfiguracji wydarzeń, płatności Stripe oraz kontroli wejścia.

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 id zamiast 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 ma checkoutSessionId.
  • 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.