Preskoči na sadržaj

Prilagođena validacija naplate uz Shopify Functions: vodič za 2026.

Cart and Checkout Validation Function API je jedini način da na serverskoj strani blokirate Shopify korpu ili checkout koji krši vaša pravila. Vodič pokriva planove, ograničenja, prikaz grešaka i provereni primer.

Prilagođena validacija naplate uz Shopify Functions: vodič za 2026.

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?

PostavkaKo može da je koristi
Javna aplikacija iz Shopify App Store-a koja sadrži funkciju za validacijuProdavnice na bilo kom planu
Prilagođena aplikacija sa vašom funkcijom za validacijuShopify Plus prodavnice
Fetch target, koji funkciji dozvoljava poziv spoljnog API-jaPrilagođ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 straniciShopify 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čenjeVrednost
Aktivne funkcije za validaciju po prodavnici25
Instrukcije po izvršavanju (korpe do 200 stavki)11 miliona
Ulaz funkcije128 kB
Izlaz funkcije20 kB
Cena ulaznog upita30
Veličina ulaznog upita, bez komentara3.000 bajtova
Kompajlirani binarni fajl256 kB
Linearna memorija pri izvršavanju10.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žanoNije podržano
Korpa i checkout online prodavnice, uključujući brze načine plaćanjaPoint of Sale
Headless korpe napravljene na Storefront API-juObnove pretplata (ponavljajuće porudžbine)
B2B checkoutIzmene porudžbina, u adminu ili na checkout-u
Draft porudžbine, u adminu i na checkout-uPorudžbine napravljene preko Create Order API-ja
Shopify adminPrednarudž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.

TargetGde se poruka pojavljuje
$.cartNa nivou stranice, na koraku checkout-a na kom je kupac
$.cart.buyerIdentity.emailIspod polja za email
$.cart.deliveryGroups[0].deliveryAddress.zipIspod poštanskog broja za dostavu (address1, city, countryCode, provinceCode i ostala polja adrese rade na isti način)
$.cart.billingAddress.countryCodeIspod države za naplatu
$.cart.poNumberIspod broja narudžbenice (B2B)
$.cart.localizedField.KEYIspod 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.

  1. 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
  2. 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
                }
              }
            }
          }
        }
      }
    }
  3. 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 } }] };
    }
  4. Generišite tipove i pokrenite pregled. U JavaScript-u ponovo generišite tipove posle svake izmene upita, pa pokrenite razvojni pregled:
    shopify app function typegen
    shopify app dev
    Izlaz komande dev prikazuje svako izvršavanje funkcije sa logovima. shopify app function replay ponovo pokreće prethodno izvršavanje dok ispravljate kod.
  5. Dodajte podatke. Napravite definiciju celobrojnog metafield-a proizvoda, custom.max_per_order, i postavite ga na proizvodima kojima treba ograničenje.
  6. Objavite komandom shopify app deploy i 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?

  1. Idite na Settings > Checkout.
  2. Kliknite na Checkout rules, pa na Add rule.
  3. Izaberite pravilo koje vaša aplikacija nudi i podesite ga.
  4. Opciono: isključite Allow all customers to complete checkout ako porudžbine ne smeju da prođu kada samo pravilo padne sa greškom.
  5. 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 validacijuCheckout UI ekstenzija
Gde se izvršavaNa Shopify serverimaU pretraživaču kupca, unutar checkout-a
PokrivaKorpu, checkout, brze načine plaćanja, Storefront API korpe, draft porudžbineKorake checkout-a na kojima je ekstenzija postavljena
Kako blokiraVraća greške sa targetimaPresreće napredovanje preko Buyer Journey API-ja
PlanoviBilo koji plan preko javnih aplikacija, Plus za prilagođene aplikacijeKoraci za informacije, dostavu i plaćanje traže Plus
PodešavanjePravilo za checkout u Settings > CheckoutTraži dozvolu block_progress, a trgovac mora da je odobri u podešavanjima ponašanja checkout-a u checkout editoru
Najbolje zaPravila koja moraju da važe za svaku porudžbinuPovratnu 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. buyerIdentity i customer mogu 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.

Bez spama. Odjava u bilo kom trenutku. Politika privatnosti

Želite više naših tekstova u Google pretrazi? Dodajte Codersy kao željeni izvor.

Dodaj Codersy na Google(otvara se u novom prozoru)