Webhook je automatska obavijest koju jedan sustav šalje drugome čim se dogodi neki događaj. Šalje se kao HTTP zahtjev na unaprijed zadanu adresu, s podacima o događaju. Kad u webshopu nastane narudžba, webshop odmah javi knjigovodstvu, skladištu ili servisu za račune, a da ga nitko nije pitao.
Kako webhook radi
Postavljanje ima tri dijela. Prvo sustav koji prima poruke (primatelj) otvori adresu na kojoj ih čeka, na primjer https://racuni.primjer.hr/webhooks/narudzbe. Zatim se u sustavu koji šalje (pošiljatelj) ta adresa upiše uz događaj koji vas zanima: nova narudžba, uspješna uplata, otkazana pretplata. Na kraju se dogovori tajni ključ kojim pošiljatelj potpisuje svaku poruku.
Od tog trenutka pošiljatelj, kad se događaj dogodi, složi poruku, najčešće u formatu JSON, i pošalje je metodom POST na zadanu adresu. Primatelj provjeri potpis, potvrdi primitak kodom 200 i tek onda obradi podatke. Ako potvrda ne stigne, pošiljatelj poruku šalje ponovno, po rasporedu koji propisuje njegova dokumentacija.
Zato se webhook često zove i obrnuti API. Kod API-ja vaš sustav šalje zahtjev i čeka odgovor. Kod webhooka druga strana šalje zahtjev vama.
Webhook ili stalno provjeravanje
Bez webhooka sustav mora sam pitati ima li novosti, što se zove polling. Recimo da program za račune svakih pet minuta pita webshop za nove narudžbe. To je 288 upita dnevno, a u danu s deset narudžbi gotovo svi vrate „ništa novo”. Narudžba koja stigne odmah nakon upita čeka do sljedećeg, pa račun kasni do pet minuta.
S webhookom stiže deset poruka, po jedna za svaku narudžbu, nekoliko sekundi nakon kupnje. Manje je prometa, manje opterećenja na obje strane i nema kašnjenja.
Polling ipak ima mjesto. Kad druga strana ne nudi webhookove, kad vaš sustav nije stalno dostupan s interneta ili kad trebate povremeno uskladiti podatke za slučaj da je neka poruka izgubljena, upit preko API-ja je jedini ili sigurniji put. Dobre integracije koriste oboje: webhook za brzinu, povremenu provjeru za kontrolu.
Primjer: poruka o novoj narudžbi
Ovako otprilike izgleda webhook koji WooCommerce pošalje kad nastane narudžba. Adresa, broj narudžbe, kupac i iznosi su izmišljeni, a tijelo je skraćeno:
POST /webhooks/narudzbe HTTP/1.1
Host: racuni.primjer.hr
Content-Type: application/json
X-WC-Webhook-Topic: order.created
X-WC-Webhook-Delivery-ID: 54
X-WC-Webhook-Signature: <base64 HMAC-SHA256 potpis tijela poruke>
{
"id": 1045,
"status": "processing",
"currency": "EUR",
"date_created": "2026-11-11T09:14:00",
"shipping_total": "4.00",
"total": "89.90",
"billing": { "first_name": "Ana", "email": "ana@primjer.hr" },
"line_items": [
{ "name": "Maslinovo ulje 1 l", "quantity": 2, "total": "48.00" },
{ "name": "Poklon paket", "quantity": 2, "total": "37.90" }
]
}
Zaglavlja kažu o kojem je događaju riječ i nose potpis. Tijelo nosi podatke koji primatelju trebaju: broj, iznos, valutu, kupca i stavke. Program za račune iz toga složi račun, a broj narudžbe 1045 zapamti da istu narudžbu ne bi obradio dvaput.
Webhookovi u Shopifyju, WooCommerceu i Stripeu
| Platforma | Zaglavlje s potpisom | Kako se potpisuje | Što se događa kad primatelj ne odgovori |
|---|---|---|---|
| Shopify | X-Shopify-Hmac-Sha256 | HMAC-SHA256 tijela poruke, kodiran u base64 | odgovor mora stići u pet sekundi; do osam ponovnih pokušaja u četiri sata, zatim se pretplata uklanja |
| WooCommerce | X-WC-Webhook-Signature | HMAC-SHA256 tijela, base64, tajnim ključem webhooka | nakon pet uzastopnih neuspjelih isporuka webhook se isključuje i treba ga ponovno uključiti |
| Stripe | Stripe-Signature (vrijeme t= i potpis v1=) | HMAC-SHA256 tajnom koja počinje s whsec_ | ponovni pokušaji do tri dana, sa sve duljim razmacima |
Podaci su iz dokumentacije svake platforme. Shopify uz svaku poruku šalje i X-Shopify-Webhook-Id, po kojem se prepoznaje ponovljena isporuka. Stripe izričito upozorava da ista poruka može stići više puta i da redoslijed događaja nije zajamčen.
Sigurnost: potpis, HTTPS i ponovljene poruke
Adresa koja prima webhook javno je dostupna, pa joj bilo tko može poslati lažnu narudžbu ili lažnu potvrdu uplate. Obrana je potpis. Pošiljatelj tajnim ključem izračuna HMAC sažetak tijela poruke i pošalje ga u zaglavlju. Primatelj isti izračun ponovi nad sirovim tijelom, onakvim kakvo je stiglo, i usporedi rezultat. Ako se ne poklapa, poruka se odbacuje.
Stripe u potpis uključuje i vrijeme slanja, a njegove biblioteke po zadanom odbijaju poruke starije od pet minuta. Tako napadač ne može presresti stvarnu poruku i poslati je ponovno sutra.
Poruke se primaju samo preko HTTPS-a, a tajni ključ stoji na serveru, nikad u kodu koji učitava preglednik. Primatelj treba brzo odgovoriti kodom 200, a sporu obradu, poput izdavanja računa, odraditi nakon toga. Inače pošiljatelj zaključi da poruka nije stigla i pošalje je ponovno.
Webhook često nosi i osobne podatke kupca, poput imena i e-adrese. Dogovorite da se šalje samo ono što primatelju stvarno treba i zapisujte samo ono što morate čuvati.
Gdje ga susrećete u hrvatskom webshopu
Najvažniji primjer je račun. Od 2026. svaki račun koji webshop izda građaninu mora biti fiskaliziran, bez obzira na način plaćanja. Globalne platforme to nemaju ugrađeno, pa se program za račune na narudžbe spaja webhookom: dobije narudžbu, izda račun, dobije JIR i pošalje račun kupcu. Kad kupac plati karticom, payment gateway webhookom javlja da je uplata potvrđena, pa se narudžba tek tada šalje u obradu.
Isti obrazac vrijedi za upit s obrasca koji stiže u CRM, za promjenu statusa pošiljke kod dostavne službe i za prodaju koja se sa servera šalje oglasnim sustavima, kao kod server-side trackinga. Koje veze trebaju webhook, a koje periodičnu provjeru, odlučuje se pri izradi webshopa, dok je promjena još jeftina.
Česte greške
Najčešća je obrada bez provjere potpisa. Radi na testu, a u produkciji ostavlja otvorena vrata za lažne narudžbe.
Druga su duplikati. Pošiljatelj ponavlja poruku kad ne dobije odgovor na vrijeme, pa bez provjere broja događaja ili narudžbe isti kupac dobije dva računa.
Treća je spora obrada prije odgovora. Ako primatelj prvo izdaje račun pa tek onda odgovara, a to traje dulje od roka pošiljatelja, poruka se ponavlja i problem se gomila.
Četvrta je tišina. WooCommerce webhook se nakon pet neuspjelih isporuka sam isključi, a Shopify nakon neuspjelih pokušaja ukloni pretplatu. Ako nitko ne dobiva obavijest, narudžbe danima ne stižu u knjigovodstvo, a to se otkrije tek na kraju mjeseca.
Česta pitanja
Koja je razlika između webhooka i API-ja?
Preko API-ja vaš sustav pita kad mu nešto treba. Webhook radi obrnuto: drugi sustav javi sam čim se nešto dogodi. U praksi se koriste zajedno, webhook javi da je stigla narudžba, a vaš sustav po potrebi preko API-ja povuče pojedinosti.
Je li webhook siguran?
Jest, ako primatelj provjerava potpis svake poruke, prima ih samo preko HTTPS-a i čuva tajni ključ na serveru. Bez provjere potpisa adresa za webhook je javni obrazac na koji svatko može poslati bilo što.
Što se dogodi ako moj server ne radi kad stigne webhook?
Pošiljatelj poruku ponavlja po svom rasporedu: Shopify do osam puta u četiri sata, Stripe do tri dana. Ako server ne proradi u tom roku, poruka je izgubljena, a neke platforme isključe webhook, pa je dobro imati povremenu provjeru preko API-ja.
Mogu li koristiti webhookove bez programiranja?
Mogu. Alati poput Zapiera i Make daju gotovu adresu za primanje webhooka i povezuju je s drugim aplikacijama klikanjem. Za veze o kojima ovisi naplata ili račun ipak je sigurnije imati vlastitu obradu s provjerom potpisa i zaštitom od duplikata.
Povezani pojmovi
API
Application Programming Interface: dogovoreni način na koji dva programa razmjenjuju podatke, na primjer webshop i knjigovodstvo ili web obrazac i CRM.
Shopify
SaaS platforma za izradu i vođenje webshopa. Trgovac plaća mjesečnu pretplatu, a hosting, sigurnost i ažuriranja jezgre nosi sam Shopify.
CRM
Customer Relationship Management — sustav za upravljanje odnosima s klijentima i leadovima. Centralizira kontakte, prati prodaju i automatizira komunikaciju.
Fiskalizacija
Zakonska obveza slanja podataka o svakom izdanom računu Poreznoj upravi u stvarnom vremenu. Od 2026. vrijedi bez obzira na način plaćanja.
HTTPS
Šifrirana verzija HTTP protokola koja štiti podatke između preglednika i servera. Obavezan standard i potvrđen, iako slab, signal rangiranja.
Server-side tracking
Praćenje konverzija preko vlastitog servera umjesto izravno iz preglednika. Daje više kontrole nad podacima, ali pravila o privoli i dalje vrijede.
