Własny sklep lub ERP

Bez wtyczki Twój programista łączy konfigurator z koszykiem. Zasada mieści się w jednym zdaniu: cena wysłana przez przeglądarkę nigdy nie staje się ceną w koszyku, dopóki Twój serwer nie sprawdzi jej w CutOptim.

Wczesny dostęp: API dla sprzedawcy jest gotowe i można je wypróbować w sklepie sandbox; wtyczki do platform sklepowych są jeszcze w przygotowaniu. CutOptim nie pobiera płatności: koszyk, finalizacja zamówienia i płatność zostają w Twoim sklepie.

Ścieżki, nazwy pól, kody błędów, nazwy nagłówków i przykłady kodu pozostają po angielsku: to jest kontrakt.

Kontrole po stronie serwera

Odbierz zamówienie ze swojej strony (zdarzenie cutoptim:order) wraz z wyceną i identyfikatorem zamówienia.
Zweryfikuj token wyceny przez POST /cfg/v1/quote/verify z Twoim kluczem tajnym. Akceptuj tylko valid: true z redeemed: true; reason: "unavailable" oznacza brak weryfikacji.
Porównaj twierdzenia tokenu z Twoim koszykiem: identyfikator Twojego tenanta, Twoja waluta, brak wygaśnięcia.
Pobierz zamówienie przez GET /cfg/v1/orders/{id} i porównaj jego hash planu, hash wyceny i sumy ze zweryfikowanym tokenem.
Utwórz pozycję koszyka po zweryfikowanej cenie i zapamiętaj nonce tokenu, aby ta sama wycena nie mogła stać się drugą pozycją.

Dlaczego kontrola lokalna nie wystarcza

Kod referencyjny potrafi sprawdzić token lokalnie: jego kształt, 11 twierdzeń, formę kanoniczną, Twój tenant i termin ważności. Nie może udowodnić podpisu, bo klucz podpisujący zostaje w CutOptim. Tylko kontrola zdalna potwierdza, że cenę podpisała usługa.

Odbieranie webhooka

Zweryfikuj podpis na surowej treści, deduplikuj po identyfikatorze zdarzenia i odpowiedz 2xx; pełny odbiornik jest w Webhookach.

Kod referencyjny

Dwa małe przykłady bez zależności, do przeczytania i skopiowania: Node (cutoptim-verify.mjs, example-server.mjs) i PHP (CutOptimVerify.php, example-webhook.php). To kod referencyjny, nie usługa hostowana. Pliki do pobrania i omówienie: Własna platforma oraz strona pomocy.

Nie ma tu przycisku „wypróbuj” celowo: klucz tajny należy do Twojego serwera, nigdy do przeglądarki. Sklep demonstracyjny pokazuje osadzenie i przekazanie zamówienia działające od początku do końca.

Otwórz sklep demonstracyjny CutOptim Configurator

Informacje prawneWarunki konfiguratora (EN) ·Umowa powierzenia przetwarzania danych (EN) ·Informacja o prywatności dla kupujących ·Licencje stron trzecich (EN)