Quickstart — Dokumentacja Fliko

Pobierz klucz API

Zaloguj się do panelu Fliko i przejdź do Ustawienia → Klucze API. Skopiuj klucz ze środowiska live (lub test do testów).

Klucz API ma poziom uprawnień Promotor. Nie udostępniaj go publicznie — przechowuj po stronie serwera lub używaj tokenów sesji generowanych przez API.

# Testowanie klucza
curl -s https://api.fliko.org/v1/ping \
  -H "Authorization: Bearer flk_live_YOUR_KEY" \
  | jq .status
# Oczekiwane: "ok"

Utwórz event przez API

Każdy event w Fliko ma pulę biletów, limity pojemnościowe i konfigurację bot-detection. Utwórz event jednym żądaniem POST:

curl -X POST https://api.fliko.org/v1/events \
  -H "Authorization: Bearer flk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Elektryczny Warszawa vol. 9",
    "date_iso": "2025-09-13T22:00:00+02:00",
    "capacity": 600,
    "ticket_price_pln": 85,
    "currency": "PLN",
    "bot_velocity_window_s": 60,
    "bot_max_tickets_per_ip": 3
  }'

Odpowiedź zawiera event_id — będziesz go potrzebował w kroku 3.

Osadź widget na stronie eventu

Dodaj jeden tag <script> z atrybutem data-event-id w dowolnym miejscu strony eventu. Widget wyrenderuje się responsywnie i obsłuży wszystkie metody płatności.

<!-- Fliko checkout widget -->
<div id="fliko-checkout"></div>
<script
  src="https://widget.fliko.org/v1/checkout.js"
  data-event-id="evt_YOUR_EVENT_ID"
  data-key="flk_pub_YOUR_PUBLIC_KEY"
  defer
></script>

Użyj klucza publicznego (flk_pub_) na froncie — ten klucz jest bezpieczny do ekspozycji. Klucz prywatny (flk_live_) przechowuj tylko na serwerze.

Testuj płatności w trybie sandbox

Użyj środowiska testowego i danych testowych poniżej. Blik sandbox generuje kody 6-cyfrowe po stronie Fliko bez połączenia z bankiem.

Metoda	Dane testowe	Wynik
Blik	`777777`	Sukces
Blik	`888888`	Timeout (symulacja)
Visa/MC	`4111 1111 1111 1111`	Sukces
Visa/MC	`4000 0000 0000 0002`	Odrzucona
Apple Pay	Simulator token	Sukces

Przejście na produkcję

Przed uruchomieniem na live zamień klucze testowe na produkcyjne i zweryfikuj listę kontrolną:

Klucz flk_live_ (nie flk_test_) w zmiennych środowiskowych serwera
HTTPS na stronie eventu (wymagane przez Apple Pay i Blik tokenizację)
Endpoint webhook skonfigurowany i przetestowany
Limity bot-detection ustawione dla specyfiki eventu (premierowa sprzedaż vs. standardowa)
Test płatności live — 1 transakcja za 1 PLN przed uruchomieniem pełnej sprzedaży

Gotowe! Przy pierwszym problemie technicznym pisz na [email protected] — reagujemy w ciągu jednego dnia roboczego.

API Reference

Quickstart: embed widget w 5 krokach

1 Pobierz klucz API

2 Utwórz event przez API

3 Osadź widget na stronie eventu