Da biste dodali prilagođenu validaciju naplate na Shopify-ju, pravite Shopify Function na Cart and Checkout Validation Function API-ju, isporučujete je u okviru aplikacije i uključujete je kao pravilo za checkout u Settings > Checkout. Funkcija se izvršava na Shopify serverima, u korpi i na checkout-u (stranici za plaćanje), uključujući brze načine plaćanja kao što su Shop Pay, PayPal, Google Pay i Apple Pay, i blokira porudžbinu porukom koju vi napišete kada korpa prekrši neko od vaših pravila.
To je jedini način da se korpa i checkout validiraju na serverskoj strani na Shopify-ju. Prodavnice na bilo kom planu mogu da koriste javnu aplikaciju iz App Store-a koja sadrži funkciju za validaciju. Za prilagođenu aplikaciju napravljenu samo za vašu prodavnicu potreban je Shopify Plus. Ovaj vodič pokriva šta API može da proveri, planove i ograničenja, kako se greške prikazuju na checkout-u i primer koji radi, a sve je provereno u odnosu na Shopify API referencu za verziju 2026-10.
Šta funkcija za validaciju checkout-a može da proveri?
Funkcija za validaciju čita korpu preko GraphQL ulaznog upita i vraća greške. Shopify navodi ove primere upotrebe:
- tokengating, odnosno obavezno članstvo kupca na checkout-u;
- proveru starosti ili identiteta kupca tokom checkout-a;
- B2B minimume, maksimume i umnoške za proizvode;
- B2B minimume i maksimume porudžbine ili kreditne limite po lokaciji;
- ograničenja količine tokom flash rasprodaje;
- validaciju brojeva narudžbenica (purchase order) za B2B kupce;
- ograničenja za adresu za naplatu.
Shopify-jevi primeri dodaju blokiranje adresa poštanskih fahova (PO box), obaveznu poruku uz poklon, obavezna lokalna poreska polja u poslednjem koraku i ograničenje količine proizvoda vrednošću upisanom u metafield proizvoda.
Ulaz može da sadrži stavke korpe i količine, podatke o proizvodima i varijantama, metafield-e proizvoda i kupaca, atribute korpe, identitet kupca (uključujući broj prethodnih porudžbina), adrese za dostavu i naplatu, podatke o B2B kompaniji i lokalizovana polja checkout-a. Funkcija ne može da koristi nasumične vrednosti ni sat, i ne može da poziva vaš API, osim ako je u pitanju prilagođena aplikacija na Enterprise prodavnici sa odobrenim mrežnim pristupom. Za sve ostalo podatke prosledite preko metafield-a ili atributa korpe.
Koji planovi mogu da koriste funkcije za validaciju checkout-a?
| Postavka | Ko može da je koristi |
|---|---|
| Javna aplikacija iz Shopify App Store-a koja sadrži funkciju za validaciju | Prodavnice na bilo kom planu |
| Prilagođena aplikacija sa vašom funkcijom za validaciju | Shopify Plus prodavnice |
| Fetch target, koji funkciji dozvoljava poziv spoljnog API-ja | Prilagođene aplikacije na Enterprise prodavnicama, posle zahteva za mrežni pristup. Nije dostupno na razvojnim prodavnicama. |
| Checkout UI ekstenzije na koracima za informacije, dostavu i plaćanje, za provere na samoj stranici | Shopify Plus prodavnice |
Dakle, prodavnica koja nije na Plus-u validaciju dobija preko aplikacija, a Plus prodavnica može i da napravi sopstvenu. Shopify-jeva besplatna aplikacija Checkout Blocks, na primer, ima validaciju ograničenja porudžbine napravljenu na Shopify Functions, koja blokira checkout kada je međuzbir ispod minimuma ili iznad maksimuma.
Koja su ograničenja?
| Ograničenje | Vrednost |
|---|---|
| Aktivne funkcije za validaciju po prodavnici | 25 |
| Instrukcije po izvršavanju (korpe do 200 stavki) | 11 miliona |
| Ulaz funkcije | 128 kB |
| Izlaz funkcije | 20 kB |
| Cena ulaznog upita | 30 |
| Veličina ulaznog upita, bez komentara | 3.000 bajtova |
| Kompajlirani binarni fajl | 256 kB |
| Linearna memorija pri izvršavanju | 10.000 kB |
Ograničenja za instrukcije, ulaz i izlaz se povećavaju za korpe sa više od 200 stavki. Izbor jezika je ovde bitan. U Shopify-jevom primeru za ograničenje količine, na kom se zasniva kod u nastavku, verzija u Rust-u troši oko 19.000 instrukcija, a verzija u JavaScript-u oko 183.000. Obe se lako uklapaju, ali Shopify preporučuje Rust kao najbrži izbor, što je važno kada je logika zahtevna ili su korpe velike.
Gde se funkcije za validaciju izvršavaju?
| Podržano | Nije podržano |
|---|---|
| Korpa i checkout online prodavnice, uključujući brze načine plaćanja | Point of Sale |
| Headless korpe napravljene na Storefront API-ju | Obnove pretplata (ponavljajuće porudžbine) |
| B2B checkout | Izmene porudžbina, u adminu ili na checkout-u |
| Draft porudžbine, u adminu i na checkout-u | Porudžbine napravljene preko Create Order API-ja |
| Shopify admin | Prednarudžbine i opcija "probaj pre kupovine" |
Pravila za checkout podrazumevano važe i za draft porudžbine. Zaposleni mogu da ih zaobiđu pre nego što završe draft porudžbinu.
Kako se greške validacije prikazuju na checkout-u?
Svaka greška koju funkcija vrati ima dva dela: message, poruku koju kupac čita, i target, koji određuje gde se poruka pojavljuje.
| Target | Gde se poruka pojavljuje |
|---|---|
$.cart | Na nivou stranice, na koraku checkout-a na kom je kupac |
$.cart.buyerIdentity.email | Ispod polja za email |
$.cart.deliveryGroups[0].deliveryAddress.zip | Ispod poštanskog broja za dostavu (address1, city, countryCode, provinceCode i ostala polja adrese rade na isti način) |
$.cart.billingAddress.countryCode | Ispod države za naplatu |
$.cart.poNumber | Ispod broja narudžbenice (B2B) |
$.cart.localizedField.KEY | Ispod lokalizovanog polja, na primer poreskog broja |
Van checkout-a Shopify iste greške prikazuje na Cart objektu u Storefront API-ju i u temama koje koriste cart šablon. U Storefront API-ju mutacija korpe, na primer cartLinesAdd, ne uspeva i vraća korisničku grešku sa kodom VALIDATION_CUSTOM. Ako vaša tema koristi fioku korpe (cart drawer) ili prilagođenu korpu, proverite da prikazuje ove poruke, jer kupac koji ne vidi razlog jednostavno odlazi.
Ulaz vam govori i gde se kupac nalazi, preko buyerJourney.step:
CART_INTERACTION: kupac menja korpu;CHECKOUT_INTERACTION: kupac prolazi kroz checkout;CHECKOUT_COMPLETION: kupac završava porudžbinu.
Koristite korak da blokirate u pravom trenutku. Shopify-jev primer za obavezna poreska polja proverava samo na CHECKOUT_COMPLETION, da kupci ne budu zaustavljeni dok još popunjavaju formular. Ograničenje količine je, s druge strane, najbolje prikazati u korpi, pre nego što kupac stigne do checkout-a.
Pišite poruke koje kažu šta nije u redu i kako to da se ispravi. "Porudžbine preko 1.000 $ zahtevaju nalog sa najmanje pet prethodnih porudžbina" je dobra poruka. "Validacija nije uspela" nije.
Kako se pravi funkcija za validaciju checkout-a?
Potrebni su vam Shopify CLI aplikacija instalirana na razvojnoj prodavnici, Node.js i verzija API-ja 2025-07 ili novija. Primer ograničava koliko komada proizvoda kupac može da kupi, pomoću metafield-a proizvoda, pa trgovac može da menja ograničenja bez novog objavljivanja koda.
- Generišite ekstenziju iz foldera aplikacije i izaberite Rust, JavaScript, TypeScript ili Wasm kada vas CLI pita:
shopify app generate extension --template cart_checkout_validation --name cart-checkout-validation - Napišite ulazni upit u
src/cart_validations_generate_run.graphql. Traži samo ono što pravilu treba:query CartValidationsGenerateRunInput { cart { lines { quantity merchandise { __typename ... on ProductVariant { product { title metafield(namespace: "custom", key: "max_per_order") { value } } } } } } } - Napišite logiku u
src/cart_validations_generate_run.js:// @ts-check /** * @typedef {import("../generated/api").CartValidationsGenerateRunInput} CartValidationsGenerateRunInput * @typedef {import("../generated/api").CartValidationsGenerateRunResult} CartValidationsGenerateRunResult */ /** * @param {CartValidationsGenerateRunInput} input * @returns {CartValidationsGenerateRunResult} */ export function cartValidationsGenerateRun(input) { const errors = []; for (const line of input.cart.lines) { if (line.merchandise.__typename !== "ProductVariant") { continue; } const product = line.merchandise.product; const limit = parseInt(product.metafield?.value ?? "", 10); if (!Number.isNaN(limit) && line.quantity > limit) { errors.push({ message: `Najveća dozvoljena količina za ${product.title} je ${limit} po porudžbini.`, target: "$.cart", }); } } return { operations: [{ validationAdd: { errors } }] }; } - Generišite tipove i pokrenite pregled. U JavaScript-u ponovo generišite tipove posle svake izmene upita, pa pokrenite razvojni pregled:
Izlaz komandeshopify app function typegen shopify app devdevprikazuje svako izvršavanje funkcije sa logovima.shopify app function replayponovo pokreće prethodno izvršavanje dok ispravljate kod. - Dodajte podatke. Napravite definiciju celobrojnog metafield-a proizvoda,
custom.max_per_order, i postavite ga na proizvodima kojima treba ograničenje. - Objavite komandom
shopify app deployi instalirajte aplikaciju na živu prodavnicu.
Funkcije napisane pre verzije API-ja 2025-07 koriste target purchase.validation.run. Od verzije 2025-07 Shopify ga je preimenovao u cart.validations.generate.run, a funkcija sada vraća operacije sa validationAdd, kao u primeru. Starije verzije i dalje rade, ali prelazak na noviju verziju API-ja znači i izmenu koda.
Kako se pravilo za checkout uključuje u Shopify adminu?
- Idite na Settings > Checkout.
- Kliknite na Checkout rules, pa na Add rule.
- Izaberite pravilo koje vaša aplikacija nudi i podesite ga.
- Opciono: isključite Allow all customers to complete checkout ako porudžbine ne smeju da prođu kada samo pravilo padne sa greškom.
- Kliknite na Save, pa na Turn on.
To podešavanje pokriva samo greške pri izvršavanju, kada funkcija baci izuzetak ili pređe ograničenja resursa. Funkcija koja se izvrši i vrati grešku uvek blokira. Da kasnije izmenite, isključite ili uklonite pravilo, otvorite ga iz istog odeljka Checkout rules.
Funkcije na serveru ili checkout UI ekstenzije?
| Funkcija za validaciju | Checkout UI ekstenzija | |
|---|---|---|
| Gde se izvršava | Na Shopify serverima | U pretraživaču kupca, unutar checkout-a |
| Pokriva | Korpu, checkout, brze načine plaćanja, Storefront API korpe, draft porudžbine | Korake checkout-a na kojima je ekstenzija postavljena |
| Kako blokira | Vraća greške sa targetima | Presreće napredovanje preko Buyer Journey API-ja |
| Planovi | Bilo koji plan preko javnih aplikacija, Plus za prilagođene aplikacije | Koraci za informacije, dostavu i plaćanje traže Plus |
| Podešavanje | Pravilo za checkout u Settings > Checkout | Traži dozvolu block_progress, a trgovac mora da je odobri u podešavanjima ponašanja checkout-a u checkout editoru |
| Najbolje za | Pravila koja moraju da važe za svaku porudžbinu | Povratnu informaciju u okviru koraka checkout-a, pre nego što kupac nastavi |
Ekstenziju koristite za povratnu informaciju, a funkciju za sprovođenje pravila. Funkcija je ta koja pokriva svaki put do porudžbine, uključujući Shop Pay i druga dugmad za brzo plaćanje.
Šta da testirate pre puštanja u rad?
- Kupovine bez naloga.
buyerIdentityicustomermogu biti prazni, pa kupca koji nedostaje tretirajte kao novog. - Brze načine plaćanja. Napravite probnu porudžbinu preko Shop Pay-a ili drugog dugmeta za brzo plaćanje i potvrdite da pravilo i dalje blokira.
- Korpu i fioku korpe. Proverite da se poruka pojavljuje tamo gde će je kupac videti.
- Podeljene korpe. Checkout može da ima više grupa za dostavu, na primer dostavu i preuzimanje. Shopify savetuje da prođete kroz sve grupe za dostavu umesto da pretpostavite samo jednu.
- Velike korpe. Testirajte sa korpama blizu vaših najvećih stvarnih porudžbina i držite ulazni upit malim, jer svako polje troši instrukcije.
- Izvršavanja u produkciji. Shopify čuva svako izvršavanje funkcije, sa ulazom i izlazom, u Dev Dashboard-u. Proverite ga posle puštanja u rad i posle svakog objavljivanja.
Da li vam je prilagođena funkcija za validaciju uopšte potrebna?
Ne uvek. Prvo proverite ovo:
- Minimumi i maksimumi porudžbine: Checkout Blocks ima validaciju ograničenja porudžbine kojoj ne treba kod.
- B2B pravila za količinu: Shopify-jevi B2B katalozi podržavaju pravila za minimum, maksimum i korak količine po varijanti, bez funkcije.
- Uobičajena pravila kao što su provera starosti ili ograničenja kupovine: neka aplikacija iz App Store-a to možda već radi, na bilo kom planu.
Prilagođena funkcija ima smisla kada pravilo zavisi od vaših podataka, kombinuje više uslova ili mora da radi za više tržišta i B2B na jednom mestu. Time se bavi naš tim za prilagođavanje checkout-a, najčešće uz prilagođenu aplikaciju i ekran u adminu na kom trgovac menja pravilo. Za širu sliku o tome šta danas možete da menjate na checkout-u, pročitajte naš vodič za Shopify checkout extensibility u 2026., a ako vas na validaciju navodi B2B, pogledajte da li vam za B2B i dalje treba Shopify Plus.
FAQ
Šta je Cart and Checkout Validation Function API?
To je Shopify Function API za validaciju korpe i checkout-a na serverskoj strani. Vaša funkcija čita korpu i vraća greške sa porukom i targetom. Shopify tada zaustavlja kupca u tom trenutku i prikazuje poruku. Izvršava se na Shopify serverima i pokriva brze načine plaćanja kao što su Shop Pay, PayPal, Google Pay i Apple Pay.
Da li mi za validaciju checkout-a treba Shopify Plus?
Ne da biste je koristili. Na bilo kom planu možete da instalirate javnu aplikaciju iz App Store-a koja sadrži funkciju za validaciju. Shopify Plus vam treba za prilagođenu aplikaciju sa sopstvenom funkcijom za validaciju.
Kako da napravim validaciju u Shopify-ju?
Instalirajte ili napravite aplikaciju koja sadrži funkciju za validaciju, pa idite na Settings > Checkout, kliknite na Checkout rules, pa na Add rule, izaberite pravilo, sačuvajte ga i kliknite na Turn on.
Koliko funkcija za validaciju prodavnica može da koristi?
Najviše 25 aktivnih funkcija za validaciju po prodavnici.
Da li funkcije za validaciju rade sa Shop Pay-om i drugim brzim načinima plaćanja?
Da. Shopify navodi da validacija korpe i checkout-a obuhvata i brze načine plaćanja kao što su Shop Pay, PayPal, Google Pay i Apple Pay.
Može li funkcija za validaciju da pozove spoljni API?
Samo preko fetch targeta, koji je ograničen na prilagođene aplikacije na Enterprise prodavnicama sa odobrenim mrežnim pristupom. U ostalim slučajevima podatke koji su funkciji potrebni stavite u metafield-e ili atribute korpe.
Treba vam prilagođena logika checkout-a?
Izrađujemo validaciju checkout-a, popuste i UI ekstenzije pomoću Shopify Functions i Checkout Extensibility-ja.
Checklista koju prolazimo pre nego što dotaknemo kod klijenta
Stiže vam na email, uz nekoliko kratkih poruka u naredne dve nedelje: šta najčešće vidimo na Shopify prodavnicama i šta zaista pomaže.
Želite više naših tekstova u Google pretrazi? Dodajte Codersy kao željeni izvor.
Dodaj Codersy na Google(otvara se u novom prozoru)


