Korzystanie z API Passtastic
Co umożliwia Ci API
API Passtastic łączy Twoje własne systemy — niestandardowy POS, CRM, wewnętrzną aplikację — bezpośrednio z Twoim programem lojalnościowym. Dzięki niemu możesz:
- Rejestrować klientów i wydawać karty wallet z własnego procesu rejestracji
- Dodawać pieczątki lub punkty oraz sprawdzać saldo klienta z własnej kasy lub systemu back office
- Otrzymywać powiadomienia w czasie rzeczywistym dzięki webhookom — zamiast ciągle odpytywać API, Passtastic wysyła zdarzenie do Twojego systemu w momencie, gdy coś się dzieje (klient się rejestruje, nagroda zostaje zrealizowana i inne)
To rozwiązanie dla firm, które budują niestandardową integrację. Jeśli chcesz po prostu gotowe połączenie, zobacz Połącz Square POS lub Systemy POS i integracje — bez pisania kodu.
Dostęp do API zależy od Twojego planu. Jeśli nie jest w nim zawarty, po otwarciu API i webhooki w Ustawieniach zobaczysz propozycję ulepszenia planu.
Utwórz klucz API
1. Otwórz Ustawienia, a potem API i webhooki (w sekcji Firma).
2. Na karcie Klucze API kliknij Utwórz klucz.
3. Nadaj kluczowi nazwę, żebyś później wiedział, do czego służy (np. „CRM produkcyjny").
4. Twój nowy klucz zostanie pokazany jednorazowo, w oknie Twój nowy klucz API. Skopiuj go teraz — nie będziesz mógł zobaczyć go ponownie. Kliknij Kopiuj albo Pokaż, żeby najpierw go zobaczyć.
Traktuj ten klucz jak hasło. Każdy, kto go ma, może działać na Twoim koncie przez API.
5. Przechowuj klucz bezpiecznie we własnym systemie (zmienna środowiskowa, menedżer sekretów) i wysyłaj go jako nagłówek uwierzytelniający przy każdym zapytaniu — dokładny format znajdziesz w dokumentacji technicznej poniżej.
Klucze API mogą tworzyć i unieważniać wyłącznie administratorzy.
Zgubiłeś klucz lub podejrzewasz wyciek?
Klucze nie są ponownie pokazywane po utworzeniu. Jeśli zgubiłeś klucz lub podejrzewasz, że wyciekł, otwórz Klucze API i kliknij przy nim Unieważnij — to natychmiast go zablokuje — a potem utwórz nowy i zaktualizuj swoją integrację.
Skonfiguruj webhook
Webhooki sprawiają, że Twój system reaguje w momencie, gdy coś dzieje się w Passtastic, bez konieczności ciągłego odpytywania API.
1. Na karcie Webhooki kliknij Dodaj endpoint.
2. Wpisz URL endpointu — adres w Twoim systemie, który odbierze zdarzenie (np. `https://twoj-system.com/hook`).
3. W sekcji Zdarzenia wybierz, które chcesz otrzymywać:
- Klient zarejestrowany
- Saldo zaktualizowane
- Poziom zmieniony
- Nagroda zrealizowana
4. Zapisz. Twój sekret podpisujący zostanie pokazany jednorazowo, w oknie Sekret podpisujący — skopiuj go teraz. Użyj go, żeby sprawdzić, czy zapytanie webhook naprawdę pochodzi z Passtastic (dokumentacja techniczna wyjaśnia, jak zweryfikować podpis).
Webhooki mogą tworzyć i edytować wyłącznie administratorzy.
Każdy endpoint webhooka pokazuje swoje ostatnie dostawy, dzięki czemu możesz sprawdzić, czy wywołanie się powiodło, czy nie, oraz wysłać ponownie nieudaną dostawę, gdy tylko Twój system znów zadziała — bez czekania na kolejne zdarzenie.
Edycja lub wyłączanie webhooka
Otwórz endpoint i kliknij Edytuj, żeby zmienić jego URL lub zdarzenia, albo ustaw status na Wyłączony, żeby wstrzymać dostawy bez jego usuwania. Kliknij Usuń, żeby usunąć go na stałe.
Gdzie znaleźć pełną dokumentację techniczną
Ten przewodnik obejmuje część dotyczącą panelu — tworzenie kluczy i webhooków. Endpointy, formaty żądań/odpowiedzi, nagłówki uwierzytelniające, kody błędów i przykłady kodu znajdziesz w pełnej dokumentacji API. Możesz też do niej wejść w każdej chwili z linku Przeczytaj dokumentację API na górze strony API i webhooki.