Webhooki to jeden z tych element\u00f3w infrastruktury, kt\u00f3re dzia\u0142aj\u0105 w tle i rzadko zwracaj\u0105 uwag\u0119 \u2013 dop\u00f3ki co\u015b si\u0119 nie zepsuje. A gdy si\u0119 zepsuje, konsekwencje bywaj\u0105 bolesne: utracone zam\u00f3wienia, zdublowane p\u0142atno\u015bci, op\u00f3\u017anienia w realizacji. W ma\u0142ym e-commerce b\u0142\u0119dy w webhookach mog\u0105 zniszczy\u0107 zaufanie klient\u00f3w, kt\u00f3rego budowanie trwa\u0142o miesi\u0105cami.<\/p>\n
W tym artykule poka\u017c\u0119 trzy typowe b\u0142\u0119dy, kt\u00f3re widz\u0119 u klient\u00f3w, i podpowiem, jak ich unikn\u0105\u0107.<\/p>\n
Wi\u0119kszo\u015b\u0107 system\u00f3w wysy\u0142a webhooka, a je\u015bli odpowied\u017a jest b\u0142\u0119dna \u2013 po prostu zapomina o zdarzeniu. To b\u0142\u0105d kardynalny. Wyobra\u017a sobie: klient sk\u0142ada zam\u00f3wienie, p\u0142aci, a Ty nie otrzymujesz powiadomienia. System nie aktualizuje stanu magazynowego, nie wysy\u0142a potwierdzenia, a klient czeka. Po godzinie dzwoni z pretensjami.<\/p>\n
Co robi\u0107?<\/strong> Przyk\u0142ad z \u017cycia:<\/strong> Webhooki s\u0105 cz\u0119sto atakowane \u2013 je\u015bli nie weryfikujesz, sk\u0105d przychodz\u0105, mo\u017cesz przetwarza\u0107 fa\u0142szywe zdarzenia. Kto\u015b mo\u017ce podmieni\u0107 status p\u0142atno\u015bci, zmieni\u0107 adres dostawy, a nawet anulowa\u0107 zam\u00f3wienie.<\/p>\n Co robi\u0107?<\/strong> Przyk\u0142ad z \u017cycia:<\/strong> Idempotentno\u015b\u0107 oznacza, \u017ce przetworzenie tego samego webhooka wielokrotnie daje ten sam efekt. Bez niej, je\u015bli webhook dotrze dwa razy (np. z powodu retry), mo\u017cesz zdublowa\u0107 zam\u00f3wienie, wys\u0142a\u0107 dwa razy ten sam e-mail, naliczy\u0107 podw\u00f3jn\u0105 p\u0142atno\u015b\u0107.<\/p>\n Co robi\u0107?<\/strong> Przyk\u0142ad z \u017cycia:<\/strong> Webhooki to pot\u0119\u017cne narz\u0119dzie, ale wymagaj\u0105 solidnego fundamentu: retry, weryfikacja i idempotentno\u015b\u0107. Zbagatelizowanie kt\u00f3regokolwiek z tych element\u00f3w pr\u0119dzej czy p\u00f3\u017aniej odbije si\u0119 na Twoich klientach i finansach. Zainwestuj czas w poprawne skonfigurowanie \u2013 to si\u0119 op\u0142aca.<\/p>\n A je\u015bli potrzebujesz pomocy przy audycie lub wdro\u017ceniu \u2013 JurskiTech ch\u0119tnie spojrzy na Twoj\u0105 architektur\u0119.<\/p>\n","protected":false},"excerpt":{"rendered":" Dlaczego Tw\u00f3j sklep traci klient\u00f3w przez z\u0142e webhooki? 3 b\u0142\u0119dy Webhooki to jeden z tych element\u00f3w infrastruktury, kt\u00f3re dzia\u0142aj\u0105 w tle i rzadko zwracaj\u0105 uwag\u0119 \u2013 dop\u00f3ki co\u015b si\u0119 nie zepsuje. A gdy si\u0119 zepsuje, konsekwencje bywaj\u0105 bolesne: utracone zam\u00f3wienia, zdublowane p\u0142atno\u015bci, op\u00f3\u017anienia w realizacji. W ma\u0142ym e-commerce b\u0142\u0119dy w webhookach mog\u0105 zniszczy\u0107 zaufanie klient\u00f3w,<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[7],"tags":[10,4,144,349],"class_list":["post-2004","post","type-post","status-publish","format-standard","hentry","category-warto-wiedziec","tag-ai-w-e-commerce","tag-automatyzacja","tag-bledy-techniczne","tag-webhooki"],"_links":{"self":[{"href":"https:\/\/news.jurskitech.pl\/blog\/wp-json\/wp\/v2\/posts\/2004","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/news.jurskitech.pl\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/news.jurskitech.pl\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/news.jurskitech.pl\/blog\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/news.jurskitech.pl\/blog\/wp-json\/wp\/v2\/comments?post=2004"}],"version-history":[{"count":0,"href":"https:\/\/news.jurskitech.pl\/blog\/wp-json\/wp\/v2\/posts\/2004\/revisions"}],"wp:attachment":[{"href":"https:\/\/news.jurskitech.pl\/blog\/wp-json\/wp\/v2\/media?parent=2004"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/news.jurskitech.pl\/blog\/wp-json\/wp\/v2\/categories?post=2004"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/news.jurskitech.pl\/blog\/wp-json\/wp\/v2\/tags?post=2004"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
\nKa\u017cdy webhook powinien mie\u0107 mechanizm ponawiania (retry) z rosn\u0105cymi odst\u0119pami czasowymi \u2013 np. 1 minuta, 5 minut, 30 minut. Po wyczerpaniu pr\u00f3b \u2013 alert do administratora. Dodatkowo warto logowa\u0107 ka\u017cd\u0105 pr\u00f3b\u0119 i odpowied\u017a.<\/p>\n
\nKlient (sklep z odzie\u017c\u0105) straci\u0142 15% zam\u00f3wie\u0144 w Black Friday, bo jego bramka p\u0142atno\u015bci wysy\u0142a\u0142a webhooki raz, a sklep nie sprawdza\u0142, czy dotar\u0142y. Po wdro\u017ceniu retry i monitoringu problem znikn\u0105\u0142.<\/p>\n2. Brak weryfikacji autentyczno\u015bci<\/h3>\n
\nKa\u017cdy webhook powinien zawiera\u0107 podpis \u2013 np. HMAC z tajnym kluczem. Odbiorca musi zweryfikowa\u0107 nag\u0142\u00f3wek (np. X-Signature) przed przetworzeniem. Bez tego jeste\u015b nara\u017cony na ataki.<\/p>\n
\nWidzia\u0142em sklep, kt\u00f3ry przez brak weryfikacji otrzymywa\u0142 fa\u0142szywe webhooki \u201epayment.captured\u201d \u2013 system wysy\u0142a\u0142 towar bez faktycznej p\u0142atno\u015bci. Straty: kilkana\u015bcie tysi\u0119cy z\u0142otych.<\/p>\n3. Brak idempotentno\u015bci<\/h3>\n
\nKa\u017cde zdarzenie powinno mie\u0107 unikalny identyfikator (event_id). Zanim przetworzysz, sprawd\u017a w bazie, czy ju\u017c ten identyfikator obs\u0142u\u017cy\u0142e\u015b. Je\u015bli tak \u2013 odpowiedz sukcesem, ale nie wykonuj akcji ponownie.<\/p>\n
\nSklep z elektronik\u0105 wysy\u0142a\u0142 dwa potwierdzenia zam\u00f3wienia i dwa razy pobiera\u0142 pieni\u0105dze, bo system p\u0142atno\u015bci retransmitowa\u0142 webhooka (b\u0142\u0105d sieci). Klienci w\u015bciekli, zwroty, obs\u0142uga r\u0119czna. Po dodaniu idempotentno\u015bci \u2013 spok\u00f3j.<\/p>\nPodsumowanie<\/h2>\n