Dokumentacija

Od izmjena Zakona o trgovini (NN 59/2026, članak 11.a) internetske trgovine koje prodaju alkoholna pića, pića koja sadrže alkohol ili energetska pića moraju provjeriti punoljetnost kupca putem nacionalnog sustava e-Građani.

Ovaj dodatak radi upravo to. Kad košarica sadrži proizvod iz kategorije koju označite, blagajna traži da kupac potvrdi punoljetnost u mobilnoj aplikaciji m-Građani. Dok to ne učini, narudžbu nije moguće dovršiti.

Privatnost kupca zaštićena je samim načinom rada: m-Građani trgovini javlja samo „punoljetan: da/ne“. Ime, OIB i datum rođenja ne dolaze u vašu trgovinu, a dodatak ih ne pohranjuje.

Integracija je u cijelosti testirana u testnom okruženju m-Građani Ministarstva (17. 9. 2026.), pa vaša trgovina ne mora ponavljati testiranje — dodatak za vas priprema zahtjev za uključivanje produkcije.

Značajke

• Postavljanje u nekoliko minuta: potrebni su samo client_id od Ministarstva i kategorije za provjeru.
• Nacionalne pristupne točke ugrađene i čitaju se iz službenog discovery dokumenta — bez upisivanja URL-ova.
• Redirect URI za obrazac registracije generira se sam, a cijeli obrazac je unaprijed popunjen podacima vaše trgovine.
• Pripremljen e-mail prema MPUDT-u za uključivanje produkcije.
• Provjera pri svakoj narudžbi, na blagajni — klasična blagajna i blok blagajne.
• Dostava u inozemstvo: m-Građani obuhvaća samo hrvatske građane, pa birate prodaju u inozemstvo bez provjere ili dostavu ograničenih proizvoda samo unutar Hrvatske.
• Sigurno po dizajnu: OpenID Connect s PKCE, razmjena tokena isključivo na vašem poslužitelju, a kod svakog ID tokena provjeravaju se potpis RS256, izdavatelj, publika, nonce i istek. Bez vanjskih biblioteka.
• Zapisnik svakog koraka provjere u WooCommerce → Status → Zapisnici (izvor „mgradjani-av“), bez tajnih podataka.
• Radi s WooCommerce pohranom narudžbi visokih performansi (HPOS).
• Hrvatski i engleski.

• Instalirajte i aktivirajte dodatak (WooCommerce mora biti aktivan).
• Otvorite WooCommerce → Provjera punoljetnosti.
• Prikazani Redirect URI upišite u obrazac registracije i pošaljite ga na evidencija-trgovci@mingo.hr. Stranica prikazuje sve podatke obrasca, spremne za kopiranje.
• Kad vam Ministarstvo (MPUDT) e-poštom pošalje client_id, zalijepite ga.
• Označite kategorije proizvoda za provjeru (alkohol, energetska pića). Podkategorije su uključene.
• Pošaljite pripremljeni e-mail za produkciju MPUDT-u, zatim uključite provjeru.

Stranica mora koristiti HTTPS.

Pohranjuje li dodatak osobne podatke kupaca?

Ne. m-Građani vraća samo potvrdu punoljetnosti (age.alcohol: true/false) i pseudonimni identifikator različit za svaku trgovinu. Ime, OIB i datum rođenja nikad se ne šalju niti pohranjuju. Uz narudžbu dodatak čuva samo da je punoljetnost provjerena i kada — kao dokaz da je provedena zakonom propisana provjera. Dodatak to dodaje u prijedloge za politiku privatnosti te u WordPressove alate za izvoz i brisanje osobnih podataka.

Što s kupcima iz inozemstva?

m-Građani provjerava samo hrvatske građane. Dodatak čita državu iz adrese dostave. Za dostavu izvan Hrvatske birate: prodaja bez provjere (zadano) ili bez dostave ograničenih proizvoda u inozemstvo.

Radi li s blokom blagajne?

Da. Obavijest o provjeri i blokada narudžbe rade i na klasičnoj blagajni i u bloku blagajne.

Mora li kupac provjeru ponoviti za svaku narudžbu?

Da. Potvrda vrijedi za jednu kupnju i briše se nakon što je narudžba zaprimljena.

1.2.0

• Now part of the GrL'Ca plugin family: GrL'Ca menu, updates from grlca.com.
• English source text with a full Croatian translation.
• Checkout block: the verification banner with the "Confirm age" button now shows there too (before, the order was blocked but the button only appeared in the classic checkout).
• Checkout block: a missing verification is reported as a normal checkout error instead of a server error.
• Classic checkout: the "verification required" error no longer shows twice.
• Shop managers can now save the settings (before, only administrators could).
• Privacy: personal-data export and erasure for the verification note on orders, and suggested privacy-policy text.
• New option to delete all plugin data when the plugin is deleted (off by default).
• Declared compatibility with the Cart/Checkout blocks.

1.1.0

• Verification is required only for delivery to Croatia, since m-Građani only verifies Croatian citizens. The country is read from the delivery address (or the billing address when delivering to the same address).
• New setting "Delivery outside Croatia": sell without verification (default) or don't deliver restricted products outside Croatia.
• The verification notice shows only at checkout and follows the country while the customer fills in the form.
• The checkout error about the required verification now contains a link to start it.

1.0.0

• First release. The full flow was confirmed in the Ministry's test environment (m-Građani test, 17 September 2026): authorization with PKCE, code exchange, RS256 signature check via JWKS, and aud, nonce, exp and iss.

1.2.0

Checkout block customers now see the "Confirm age" button; settings can be saved by shop managers.