Vlastní e-shop nebo ERP

Bez modulu váš vývojář propojí konfigurátor s košíkem sám. Pravidlo je jedna věta: cena, kterou poslal prohlížeč, se nikdy nestane cenou v košíku, dokud ji váš server neověří u CutOptim.

Předběžný přístup: API pro obchodníky je hotové a lze je vyzkoušet v sandbox obchodě; moduly pro platformy e-shopů jsou stále ve vývoji. CutOptim nevybírá žádné platby: košík, pokladna i platba zůstávají ve vašem obchodě.

Cesty, názvy polí, chybové kódy, názvy hlaviček a ukázky kódu zůstávají anglicky: jsou součástí kontraktu.

Kontroly na straně serveru

Přijměte objednávku z vaší stránky (událost cutoptim:order) s nabídkou a id objednávky.
Ověřte token nabídky pomocí POST /cfg/v1/quote/verify a svého tajného klíče. Přijměte jen valid: true s redeemed: true; reason: "unavailable" znamená neověřeno.
Porovnejte tvrzení tokenu s vaším košíkem: id vašeho tenanta, vaše měna, nevypršelo.
Dohledejte objednávku pomocí GET /cfg/v1/orders/{id} a porovnejte její hash plánu, hash nabídky a součty s ověřeným tokenem.
Vytvořte řádek v košíku za ověřenou cenu a zapamatujte si nonce tokenu, aby se stejná nabídka nemohla stát druhým řádkem.

Proč místní kontrola nestačí

Referenční kód umí token zkontrolovat lokálně: jeho tvar, 11 tvrzení, kanonickou podobu, vašeho tenanta a platnost. Podpis dokázat nemůže, protože podepisovací klíč zůstává u CutOptim. Že cenu podepsala služba, říká jen vzdálená kontrola.

Příjem webhooku

Ověřte podpis nad surovým tělem, deduplikujte podle id události a odpovězte 2xx; kompletní přijímač je v části Webhooky.

Referenční kód

Dva malé příklady bez závislostí ke čtení a kopírování: Node (cutoptim-verify.mjs, example-server.mjs) a PHP (CutOptimVerify.php, example-webhook.php). Jsou to referenční kód, ne hostovaná služba. Stažení a průvodce: Vlastní platforma a nápověda.

Tlačítko „vyzkoušet“ tu záměrně není: tajný klíč patří na váš server, nikdy do prohlížeče. Demo obchod ukazuje vložení i předání objednávky v provozu od začátku do konce.

Otevřít živý demo obchod CutOptim Konfigurátor

Právní informacePodmínky konfigurátoru (EN) ·Smlouva o zpracování údajů (EN) ·Zásady ochrany osobních údajů pro kupující ·Licence třetích stran (EN)