WooCommerce provjera punoljetnosti mora povezati službeni rezultat verifikacije s kontrolom završetka kupnje. Prikaz gumba za provjeru samo je vidljivi dio. Integracija mora prepoznati obuhvaćene proizvode, sigurno obraditi odgovor sustava i spriječiti dovršetak njihove kupnje bez valjane potvrde.
Za internetsku prodaju alkohola i energetskih pića NN 59/2026 propisuje provjeru posredstvom e-Građani. U nastavku opisujemo preporučeni postupak implementacije na postojećoj WooCommerce trgovini.
1. Pregled postojeće trgovine
Prije instalacije plugina potrebno je utvrditi kako webshop zapravo obrađuje narudžbu. Posebno treba pregledati vrstu blagajne, načine plaćanja, kupnju bez korisničkog računa i dodatke koji mijenjaju završetak kupnje.
Klasična WooCommerce blagajna i blokovska blagajna ne koriste nužno iste točke proširenja. Store API podržava funkcionalnosti košarice i checkouta, pa nije dovoljno pretpostaviti da kontrola napravljena za jedan način naručivanja štiti sve ostale.
Kompatibilnost s konkretnom temom, ubrzanim plaćanjem i dodatnim prodajnim tokovima treba potvrditi testiranjem. Popis instaliranih dodataka sam po sebi nije dokaz kompatibilnosti.
2. Određivanje proizvoda za koje je provjera potrebna
Pravila se mogu temeljiti na oznakama proizvoda ili odabranim kategorijama, ovisno o izvedbi plugina. Važno je obuhvatiti jednostavne proizvode, varijacije i pakete te dogovoriti kako administrator označava nove artikle.
Preporučena logika je jasna: ako košarica sadrži barem jedan obuhvaćeni proizvod, njegova kupnja zahtijeva provjeru. Nakon izmjene košarice potrebu za provjerom treba ponovno izračunati. Posebno treba testirati dodavanje alkohola nakon ranijeg pregleda košarice bez ograničenih artikala.
3. Konfiguriranje službene integracije
Potrebni su dodijeljeni client_id, registrirana povratna adresa i podaci odgovarajućeg okruženja. Ako prijava još nije provedena, krenite od uputa kako dobiti client_id.
Službena tehnička uputa opisuje tok s autorizacijskim kodom i PKCE zaštitom. Poslužitelj mora provjeriti state, zamijeniti kod za token te provjeriti potpis i vrijednosti iss, aud, nonce i exp. Tek nakon valjane provjere smije koristiti rezultat age.alcohol. Samo dekodiranje sadržaja tokena nije provjera njegove vjerodostojnosti.
4. Kontrola završetka narudžbe na poslužitelju
Potvrdu treba vezati uz odgovarajuću sesiju i postupak kupnje. Vrijednost koju preglednik sam pošalje, primjerice verified=true, ne smije biti dovoljan dokaz.
Preporučujemo provjeru neposredno prije dopuštanja završetka kupnje obuhvaćenih proizvoda. Kod načina plaćanja koji započinju ranije treba uskladiti redoslijed verifikacije, naplate i promjene statusa narudžbe.
Neuspjela ili prekinuta provjera mora ostaviti kupcu razumljivu poruku i mogućnost novog pokušaja. Nedostupnost vanjskog sustava ne smije automatski ukloniti kontrolu.
5. Testiranje stvarnih scenarija
| Scenarij | Očekivano ponašanje |
|---|---|
| Košarica bez obuhvaćenih proizvoda | Za ovu obvezu ne uvodi se nepotrebna provjera. |
| Obuhvaćeni proizvod i valjana pozitivna potvrda | Kupnja može nastaviti uz ostale redovne kontrole. |
| Odbijena, prekinuta ili negativna provjera | Kupnja obuhvaćenog proizvoda ne može se dovršiti. |
| Izmijenjen, istekao ili nepripadajući odgovor | Odgovor se odbacuje. |
| Promjena košarice i više otvorenih kartica | Kontrola se primjenjuje na stvarnu kupnju, bez preuzimanja tuđe ili nevažeće potvrde. |
| Mobitel, računalo i svaki aktivni način plaćanja | Povratak u webshop i završetak kupnje rade u svim podržanim tokovima. |
6. Produkcija i održavanje
Službena uputa predviđa završetak testiranja i komunikaciju s MPUDT-om o produkcijskoj spremnosti. Promjena postavke iz „test” u „produkcija” zato nije jedini organizacijski korak.
Prije puštanja u rad provjerite produkcijske adrese, HTTPS, iznimke predmemoriranja i ponašanje zaštitnih dodataka na povratnoj adresi. Nakon većih promjena WooCommercea, blagajne ili naplate ponovite ključne testove.
Ne zapisujte cijele tokene i povratne parametre u uobičajene zapisnike. Dijagnostiku treba oblikovati tako da daje dovoljno podataka za otklanjanje pogreške uz ograničenu obradu i čuvanje podataka.
Želite ugradnju u postojeću trgovinu? Pogledajte Domini Studio rješenje za provjeru punoljetnosti i pošaljite URL webshopa. Pregled postojeće blagajne omogućuje da opseg implementacije i testiranja definiramo prema stvarnom prodajnom procesu.
Izvori: službena tehnička uputa; WooCommerce Store API; NN 59/2026. Testna matrica i preporuke za WooCommerce predstavljaju predloženi inženjerski postupak, a ne popis funkcija potvrđenih za svaku konfiguraciju plugina.
