Ugrás a tartalomhoz
← API-referencia

Egyedi webshop vagy ERP

Plugin nélkül a fejlesztőd köti össze a konfigurátort a kosárral. A szabály egy mondat: a böngésző által küldött ár addig nem válhat kosárárrá, amíg a szervered nem ellenőrizte a CutOptimmal.

Korai hozzáférés: a kereskedői API elkészült, és sandbox webshopban kipróbálható; a webshop-platformok pluginjai még fejlesztés alatt állnak. A CutOptim nem szed be fizetést: a kosár, a pénztár és a fizetés a te webshopodban marad.

Az elérési utak, mezőnevek, hibakódok, fejlécnevek és kódpéldák angolul maradnak: ezek jelentik a szerződést.

A szerveroldali ellenőrzések

  • Fogadd a rendelést az oldaladról (a cutoptim:order esemény), az ajánlattal és a rendelésazonosítóval együtt.
  • Ellenőrizd az ajánlattokent a POST /cfg/v1/quote/verify hívással és a titkos kulcsoddal. Csak a valid: true és redeemed: true párost fogadd el; a reason: "unavailable" azt jelenti, hogy nincs ellenőrizve.
  • Vesd össze a token claimjeit a kosaraddal: a tenant azonosítód, a pénznemed, nem járt le.
  • Kérdezd le a rendelést a GET /cfg/v1/orders/{id} hívással, és vesd össze a tervhashét, ajánlathashét és összegeit az ellenőrzött tokennel.
  • Hozd létre a kosártételt az ellenőrzött áron, és jegyezd meg a token noncét, hogy ugyanabból az ajánlatból ne lehessen második tétel.

Miért nem elég a helyi ellenőrzés

A referenciakód helyben ellenőrizheti a tokent: az alakját, a 11 claimet, a kanonikus formát, a tenantodat és a lejáratot. Az aláírást nem tudja bizonyítani, mert az aláíró kulcs a CutOptimnál marad. Csak a távoli ellenőrzés mondja meg, hogy az árat a szolgáltatás írta alá.

A webhook fogadása

Ellenőrizd az aláírást a nyers törzs felett, deduplikálj az eseményazonosító alapján, és válaszolj 2xx-szel; a teljes fogadó a Webhookok oldalon van.

Referenciakód

Két kicsi, függőségmentes példa olvasásra és másolásra: Node (cutoptim-verify.mjs, example-server.mjs) és PHP (CutOptimVerify.php, example-webhook.php). Referenciakód, nem üzemeltetett szolgáltatás. Letöltések és végigvezetés: Egyedi platform és a súgóoldal.

Szándékosan nincs itt "kipróbálom" gomb: a titkos kulcs a szerveredre való, soha nem a böngészőbe. A demó webshop elejétől végéig megmutatja a beágyazást és a rendelés átadását.

Jogi tudnivalókKonfigurátor feltételek (EN) ·Adatfeldolgozási szerződés (EN) ·Vásárlói adatvédelmi tájékoztató ·Harmadik féltől származó licencek (EN)