Jak sprawdzić, że integracja z Rezeri działa

Informatyk mówi, że integracja jest gotowa: formularz na Twojej stronie pokazuje wolne terminy, a Twój system dostaje informacje o nowych rezerwacjach. Zanim puścisz to na klientów, chcesz wiedzieć, że naprawdę działa. Problem w tym, że Rezeri nie ma osobnego środowiska testowego, więc nie ma „wersji na próbę”, którą można by mu wskazać.

Nie jest potrzebna. Integrację sprawdzisz na własnym koncie, tymi samymi wywołaniami, których potem użyje Twoja strona. Pierwsza część tego tekstu jest dla Ciebie: co kliknąć w panelu i czego się spodziewać. Druga to lista kontrolna, którą przekażesz informatykowi.

Na jakim koncie testować

API i webhooki są dostępne od planu Team — w planach Team i Business. Okres próbny liczy się jak plan Team, więc całą integrację sprawdzisz przez 14 dni okresu próbnego, zanim zapłacisz.

Jeśli po okresie próbnym zostaniesz na planie Free albo Starter, klucze API przestaną działać, ale nie znikną. Po przejściu na Team zadziałają znowu, bez ponownej konfiguracji. Jak działa okres próbny, opisuje cennik.

Osobnej „wersji testowej” API nie ma. Jest jedno środowisko — produkcja — a testujesz na własnej organizacji, swoimi danymi.

Co przygotowujesz w panelu

Wszystko jest w Ustawienia → API i webhooki. Ten ekran widzi tylko właściciel konta organizacji. Każde pole tego ekranu opisuje krok po kroku artykuł Jak podłączyć swoją stronę przez API.

Klucz API. Kliknij „Utwórz klucz”, nadaj mu nazwę (np. „Strona www”) i zaznacz uprawnienia, których informatyk potrzebuje: Usługi, Specjaliści, Dostępność, Rezerwacje — odczyt, Rezerwacje — zapis. Uprawnienie „Webhooki” zaznacz tylko wtedy, gdy informatyk ma sam zakładać webhooki przez API. Jeśli przyjmujesz płatności online, w polu „Dozwolone domeny powrotu po płatności” wpisz domenę swojej strony — tam klient wróci po zapłacie.

Klucz zobaczysz tylko raz, zaraz po utworzeniu. Przekaż go informatykowi bezpiecznym kanałem, nie w treści maila. Gdy klucz wycieknie albo informatyk skończy współpracę, odwołasz go przyciskiem „Odwołaj”.

Webhook. To adres, pod który Rezeri wysyła informację, że coś się stało z rezerwacją: utworzona, zaakceptowana, przełożona, anulowana, opłacona albo płatność nieudana. W karcie „Webhooki” kliknij „Dodaj endpoint”, wpisz adres od informatyka, wybierz zdarzenia i zakres danych: „Pełne dane rezerwacji” albo „Bez danych klienta”. Sekret webhooka też zobaczysz tylko raz — przekaż go informatykowi razem z kluczem.

Sprawdź webhook jednym przyciskiem

Żeby zobaczyć, czy Twój system odbiera zdarzenia, nie musisz zakładać nowej rezerwacji. Wejdź w szczegóły endpointu i kliknij „Wyślij zdarzenie testowe”. Wybierasz rodzaj zdarzenia:

• Test połączenia — zdarzenie bez danych rezerwacji. Sprawdza tylko, czy adres odpowiada i podpis się zgadza.
• Jedno ze zdarzeń, które endpoint odbiera, np. „Opłacona” — przykładowe zdarzenie z danymi Twojej najnowszej rezerwacji. Tak informatyk sprawdzi obsługę płatności bez prawdziwej płatności.

Zdarzenie testowe niczego nie zmienia: rezerwacja zostaje taka, jaka była, a zdarzenie ma oznaczenie testu, po którym Twój system odróżni je od prawdziwego. Wynik widzisz od razu, np. „Zdarzenie testowe dostarczone (kod 200).”

Przykład z danymi rezerwacji wymaga, żeby na koncie była choć jedna rezerwacja. Jeśli żadnej nie ma, panel poprosi: „Żeby wysłać zdarzenie rezerwacji, najpierw utwórz rezerwację testową.”

Gdzie zobaczysz, czy zdarzenie doszło

Prawdziwe zdarzenia znajdziesz w szczegółach endpointu, w sekcji „Ostatnie dostawy”: 50 najnowszych, z czasem, nazwą zdarzenia, kodem odpowiedzi Twojego serwera i numerem próby. Kod z zakresu 200 oznacza, że zdarzenie doszło.

Gdy dostawa się nie udała, obok jest przycisk „Ponów”. Po naprawie po stronie informatyka nie trzeba czekać na kolejną automatyczną próbę — „Ponów” wysyła zdarzenie od razu.

Jeśli przez dobę żadna dostawa się nie uda, Rezeri wyłączy endpoint i wyśle Ci o tym e-mail. Po naprawie włączasz go ponownie.

Rezerwacja testowa, która nie trafi do klienta

Najpełniejszy test to prawdziwa rezerwacja przez Twoją nową stronę — i potem jej anulowanie. To jest zwykła rezerwacja: zajmuje termin w kalendarzu i wysyła te same wiadomości co każda inna. Potwierdzenie dostaje klient (e-mailem, a SMS-em, jeśli wysyłasz SMS-y), a osoba, która przyjmuje rezerwację, dostaje powiadomienie.

Dlatego jako dane klienta wpisz swoje: swój e-mail i — jeśli usługa wymaga telefonu — swój telefon. Wiadomości trafią do Ciebie, a przy okazji zobaczysz, co dostanie klient. Nigdy nie wpisuj cudzych ani wymyślonych adresów.

Kilka zasad, żeby test nie przeszkodził prawdziwym klientom:

• wybierz usługę bez płatności online — płatność sprawdzisz osobno, niżej;
• anuluj rezerwację zaraz po teście, żeby nie blokowała terminu i nie wysłała przypomnienia przed spotkaniem — anulowanie też wysyła wiadomość o odwołaniu, więc i ona trafi do Ciebie;
• pamiętaj, że zwolniony termin może trafić do osób z listy oczekujących — wybierz termin, na który nikt nie czeka.

Uważaj też na dane klientów w webhooku. Endpoint dostaje zdarzenia ze wszystkich rezerwacji na koncie, także tych od prawdziwych klientów, a przykładowe zdarzenie testowe niesie Twoją najnowszą rezerwację — czyjąkolwiek. Jeśli informatyk testuje na narzędziu firmy trzeciej (np. tymczasowym adresie do podglądu żądań), ustaw na czas testu zakres danych „Bez danych klienta”.

Jeśli wolisz, żeby test w ogóle nie dotykał Twoich klientów, informatyk może testować na osobnej organizacji bez prawdziwych klientów. Ona też potrzebuje planu Team albo okresu próbnego.

Płatność online bez prawdziwych pieniędzy

Płatność sprawdzisz w trybie testowym bramki płatności. Bramkę podłączasz w panelu w Integracje → Płatności. Tpay, Przelewy24, PayU, Paynow i Stripe mają przy podłączaniu przełącznik trybu testowego, a w HotPay tryb testowy włączasz w panelu HotPay (Ustawienia → Podstawowe), nie w Rezeri. Przy bramce z przełącznikiem:

1. Odłącz bramkę i podłącz ją ponownie z danymi konta testowego operatora i z włączonym trybem testowym.
2. Zarezerwuj usługę płatną online i zapłać danymi testowymi operatora. Żadne pieniądze nie są pobierane.
3. Odłącz bramkę i podłącz ją z powrotem z danymi produkcyjnymi, z wyłączonym trybem testowym.

Tryb testowy dotyczy całego konta, nie tylko integracji. Dopóki jest włączony, także klienci z Twojej strony rezerwacji płacą „na niby” — nie zostawiaj go włączonego.

Jak działają płatności przy rezerwacji, opisujemy na stronie przedpłata przy rezerwacji.

Lista do przekazania informatykowi

Skopiuj tę część i wyślij informatykowi. Szczegóły techniczne — przewodniki, referencję API i stronę Testowanie integracji — znajdzie w dokumentacji dla developerów.

1. Klucz. API ma jedno środowisko: produkcję (https://api.rezeri.com/v1, klucze rez_live_…). Klucz ma tylko uprawnienia, które zaznaczyłem w panelu.
2. Wolne terminy. Pobierz usługi, specjalistów i dostępność, porównaj z tym, co widać w kalendarzu Rezeri.
3. Rezerwacja. Zarezerwuj wolny termin z moimi danymi jako danymi klienta, na usługę bez płatności online.
4. Płatność i powrót na stronę. W trybie testowym bramki zarezerwuj usługę płatną online. Adres powrotu (return_url) musi być na https i w domenie z listy dozwolonych domen klucza (subdomeny tylko przez wpis *.domena.pl). Klient wraca z wynikiem success, failure albo pending, ale o stanie płatności decyduje status rezerwacji albo webhook, nie ten parametr.
5. Anulowanie. Anuluj rezerwację testową przez API i sprawdź, że termin znów jest wolny.
6. Podpis webhooka. Każda dostawa ma nagłówek Rezeri-Signature: t=…,v1=…, gdzie v1 to HMAC-SHA256 sekretem webhooka z ciągu t + . + surowe body. Weryfikuj go przed parsowaniem JSON, tak jak opisuje portal, i odpowiadaj kodem 2xx w ciągu 10 sekund. Zdarzenie z "test": true nie zmienia stanu u Ciebie.
7. Ponowienia. Nieudana dostawa jest ponawiana do 8 prób w ciągu około 24 godzin, więc to samo zdarzenie może przyjść więcej niż raz — deduplikuj po id. Po dobie samych porażek endpoint jest wyłączany.
8. Odbiornik na własnym komputerze. Na localhost dostawa nie dotrze — wystaw odbiornik przez tunel z adresem https, jak opisuje strona „Testowanie integracji”.

Zanim puścisz integrację na klientów

Jeśli wszystkie osiem punktów przeszło, a w „Ostatnich dostawach” widzisz kody z zakresu 200, integracja działa. Zostało tylko wyłączyć tryb testowy bramki i odwołać klucze, których nikt już nie używa.

Rezeri wypróbujesz przez 14 dni bez podawania karty, a w okresie próbnym masz API i webhooki jak w planie Team — czyli dokładnie tyle czasu, ile potrzeba na test integracji.