Trzy powitania po jednym zakupie. Ojciec Kampanii widzi w tym troskę o klienta. Klient sprawdza, ile razy obciążono mu kartę.
W takim przypadku warto zajrzeć do integracji. Powiadomienie o płatności mogło dotrzeć ponownie, a odbiorca wykonał wszystko od początku. Automatyzacja powinna umieć przyjąć tę powtórkę bez ponownego nadawania dostępu, wystawiania dokumentu czy wysyłania powitania.
Powiadomienie może przyjść więcej niż raz
Webhook to powiadomienie wysyłane przez jeden system do drugiego, na przykład informacja o potwierdzonej płatności. Odbiorca może na tej podstawie nadać dostęp albo rozpocząć obsługę zamówienia. Dostarczenie informacji i wykonanie dalszej czynności to dwa osobne etapy.
Stripe opisuje możliwość powtórnego otrzymania zdarzenia i brak gwarancji kolejności dostarczenia. Oznacza to, że system nie powinien zakładać jednego idealnego przebiegu: „najpierw A, potem B, każde dokładnie raz”. W innych integracjach sprawdź ich własne zasady dostarczenia i ponawiania.
Są tu dwa miejsca do sprawdzenia. Po stronie odbiorcy trzeba rozpoznać powtórnie dostarczone zdarzenie. Przy ponawianiu wywołania API dostawca może obsługiwać klucz idempotencji, dzięki któremu ta sama operacja nie wykona się drugi raz. Te zabezpieczenia dotyczą różnych odcinków procesu.
Co identyfikuje zdarzenie, a co zamówienie
Zapisz zdarzenie startowe i rzeczywisty skutek: „płatność potwierdzona” prowadzi do „dostęp aktywny”. Wybierz identyfikator zdarzenia oraz identyfikator operacji biznesowej. To pozwala odróżnić ponowne dostarczenie od innego zdarzenia dotyczącego tego samego zamówienia.
Sprawdź podpis powiadomienia zgodnie z dokumentacją dostawcy. Następnie zapisz zdarzenie w trwałym miejscu lub kolejce przed potwierdzeniem przyjęcia, jeśli dalsze przetwarzanie odbywa się później. Sama odpowiedź „200 OK” nie może być jedynym śladem informacji, która zniknie przy restarcie.
Obsługa duplikatów musi działać także wtedy, gdy dwie kopie przyjdą niemal równocześnie. Samo „sprawdź, czy istnieje, a potem utwórz” może nie wystarczyć. Potrzebny jest mechanizm atomowego zapisu, unikalności lub równoważne zabezpieczenie dostosowane do używanej platformy.
Dostęp nadany, potwierdzenie zginęło
Klient płaci za szkolenie. System otrzymuje zdarzenie, zapisuje je i nadaje dostęp. Odpowiedź potwierdzająca odbiór ginie po drodze, więc dostawca wysyła zdarzenie ponownie. Poprawny wynik to nadal jedno uprawnienie i jeden zaplanowany komunikat powitalny.
W kolejnym wariancie awaria następuje po nadaniu dostępu, ale przed zapisaniem zakończenia zadania. Powtórka musi sprawdzić stan operacji, zamiast bezwarunkowo zaczynać wszystko od początku. Taki wariant warto dopisać do prób przed uruchomieniem integracji.
Zabezpieczenie rekordu zamówienia nie chroni jeszcze wszystkich dalszych czynności. Powiadomienia, faktury i nadanie dostępu mogą potrzebować własnego klucza lub sprawdzenia stanu. Każdą istotną czynność rozpatruj osobno.
Kto zauważy utknięte zadanie
Ustal ograniczoną liczbę ponowień, odstępy zgodne z wymaganiami dostawcy i miejsce dla zadań wymagających interwencji. Zapisuj identyfikator, etap i komunikat błędu bez niepotrzebnych danych klienta. Powiadomienie o problemie powinno trafić do konkretnego opiekuna.
Przygotuj instrukcję: jak rozpoznać niedokończone zadanie, sprawdzić rzeczywisty stan i wznowić je bez duplikacji. Gdy platforma nie daje potrzebnych mechanizmów, uprość zakres albo dodaj kontrolę człowieka. Nie zakrywaj ograniczenia kolejną strzałką na diagramie.
Pięć prób w środowisku testowym
W środowisku testowym przeprowadź pięć prób: zwykłe zdarzenie, jego duplikat, dwie kopie równocześnie, chwilowa niedostępność odbiorcy i awaria po pierwszej wykonanej czynności. Sprawdź wynik w systemie docelowym, a nie tylko status scenariusza.
Oczekiwany rezultat zapisz przed testem. Mierz liczbę niezamierzonych powtórzeń, liczbę zadań utkniętych bez alarmu oraz czas od wykrycia błędu do przywrócenia poprawnego stanu. Zero błędów w pięciu próbach potwierdza tylko te pięć przypadków.
Każda platforma ma własne zasady ponowień, przechowywania danych i idempotencji. Nie przenoś ustawień Stripe do innego narzędzia bez sprawdzenia. Przy pieniądzach lub dostępie do produktu potrzebna jest ocena całego procesu, włącznie z ręczną naprawą.
Opisz integrację i czynność, która nie może wykonać się dwa razy. To dobry początek przeglądu, szczególnie gdy proces dotyka płatności albo dostępu do produktu.
Źródła i zakres
- Stripe: odbieranie webhooków - podpisy, powtórzenia i kolejność zdarzeń.
- Stripe: idempotent requests - działanie kluczy idempotencji przy obsługiwanych wywołaniach API.
Scenariusz i lista prób są autorską propozycją kontroli. Źródła sprawdzono 17.10.2026.
Powtórne dostarczenie zdarzenia powinno być bezpieczne, a awaria widoczna i możliwa do naprawienia.

