Eigener Shop oder ERP

Ohne Plug-in verbindet Ihr Entwickler den Configurator mit dem Warenkorb. Die Regel passt in einen Satz: Ein vom Browser gesendeter Preis wird erst dann zum Warenkorbpreis, wenn Ihr Server ihn bei CutOptim geprüft hat.

Early Access: Die Händler-API ist gebaut und lässt sich in einem Sandbox-Shop ausprobieren; Plug-ins für Shopsysteme sind noch in Entwicklung. CutOptim nimmt keine Zahlung entgegen: Warenkorb, Kasse und Zahlung bleiben in Ihrem Shop.

Pfade, Feldnamen, Fehlercodes, Header-Namen und Codebeispiele bleiben englisch: Sie sind der Vertrag.

Die serverseitigen Prüfungen

Empfangen Sie die Bestellung von Ihrer Seite (das Ereignis cutoptim:order), mit dem Angebot und der Bestell-ID.
Prüfen Sie das Angebots-Token mit POST /cfg/v1/quote/verify und Ihrem geheimen Schlüssel. Akzeptieren Sie nur valid: true mit redeemed: true; reason: "unavailable" bedeutet nicht geprüft.
Vergleichen Sie die Claims des Tokens mit Ihrem Warenkorb: Ihre Tenant-ID, Ihre Währung, nicht abgelaufen.
Rufen Sie die Bestellung mit GET /cfg/v1/orders/{id} ab und vergleichen Sie ihren Plan-Hash, Angebots-Hash und ihre Summen mit dem geprüften Token.
Legen Sie die Warenkorbposition zum geprüften Preis an und merken Sie sich den Nonce des Tokens, damit dasselbe Angebot nicht zu einer zweiten Position werden kann.

Warum eine lokale Prüfung nicht genügt

Der Referenzcode kann ein Token lokal prüfen: seine Form, die 11 Claims, die kanonische Form, Ihren Tenant und den Ablauf. Die Signatur kann er nicht beweisen, weil der Signaturschlüssel bei CutOptim bleibt. Nur die Prüfung beim Dienst belegt, dass der Preis vom Dienst signiert wurde.

Den Webhook empfangen

Prüfen Sie die Signatur über den rohen Body, deduplizieren Sie anhand der Ereignis-ID und antworten Sie mit 2xx; den vollständigen Empfänger finden Sie unter Webhooks.

Referenzcode

Zwei kleine, abhängigkeitsfreie Beispiele zum Lesen und Kopieren: Node (cutoptim-verify.mjs, example-server.mjs) und PHP (CutOptimVerify.php, example-webhook.php). Sie sind Referenzcode, kein gehosteter Dienst. Downloads und Anleitung: Eigene Plattform und die Hilfeseite.

Eine Schaltfläche "Ausprobieren" gibt es hier mit Absicht nicht: Der geheime Schlüssel gehört auf Ihren Server, nie in einen Browser. Der Demo-Shop zeigt Einbettung und Bestellübergabe von Anfang bis Ende.

Live-Demo-Shop öffnen CutOptim Configurator

RechtlichesKonfigurator-Bedingungen (EN) ·Auftragsverarbeitungsvertrag (EN) ·Datenschutzhinweis für Käufer ·Drittanbieter-Lizenzen (EN)