Integracja zamówień na cięcie na wymiar z własnym sklepem lub ERP

CutOptim Configurator łączy się z własnym sklepem lub ERP przez dwie weryfikacje na Twoim serwerze: podpisaną wycenę i podpisany webhook. Oba to zwykły HMAC-SHA256, który zweryfikuje każdy język, a przykłady referencyjne w Node i PHP pokazują, jak to zrobić.

Dwie weryfikacje, obie na Twoim serwerze

Własna platforma nie ma wtyczki, na której mogłaby się oprzeć, więc zaufanie opiera się na dwóch podpisach. Przeglądarka może pokazać cenę, ale tylko Twój serwer decyduje, czy jej uwierzyć.

Sprawdź wycenę przed koszykiem

Token wyceny to obietnica ceny. Twój serwer pyta CutOptim, czy jest autentyczny, nieprzeterminowany i jeszcze niewykorzystany, a potem porównuje jego oświadczenia z pozycją koszyka.

1. Odbierz zamówienie

   Strona przekazuje Twojemu skryptowi zdarzenie cutoptim:order z zamówieniem i jego tokenem wyceny.

2. Zapytaj CutOptim

   Twój serwer wysyła token pod /cfg/v1/quote/verify z Twoim kluczem tajnym. Odpowiedź mówi, czy jest ważny, czy użyło go już jakieś zamówienie i jakie oświadczenia niesie.

3. Porównaj oświadczenia

   Najemca, waluta, termin ważności i skrót wycenionych pozycji muszą zgadzać się z pozycją, którą chcesz dodać. Wszystko inne jest odrzucane.

4. Dodaj albo odrzuć

   Do koszyka trafia tylko token, który przejdzie weryfikację. Cena zmieniona w przeglądarce odpada tutaj.

Odbieraj zamówienia przez webhook

Gdy zamówienie zostaje złożone, CutOptim wysyła je na zarejestrowany przez Ciebie adres, podpisane, byś mógł poznać, że pochodzi od nas.

• — Nagłówek CutOptim-Signature niesie znacznik czasu t i podpis v1: HMAC-SHA256 znacznika czasu, kropki i surowej treści.
• — Weryfikuj surowe bajty dokładnie tak, jak przyszły; treść sparsowana i zapisana ponownie już się nie zgadza.
• — Odrzucaj znacznik czasu starszy lub nowszy niż pięć minut i porównuj podpisy w stałym czasie.
• — Zapisz identyfikator zdarzenia i odpowiadaj sukcesem na identyfikator, który już znasz: ponowna próba go powtarza.

Kod referencyjny w Node i PHP

Dwa małe przykłady robią dokładnie to, bez frameworka i bez zależności: moduł Node i pojedynczy plik PHP. Skopiuj ten, który pasuje, zastąp magazyn w pamięci tabelą z unikalnym kluczem na identyfikatorze zdarzenia i trzymaj sekrety w środowisku.

import { createWebhookReceiver } from './cutoptim-verify.mjs';

const receive = createWebhookReceiver({
  secrets: [process.env.WEBHOOK_SECRET],          // whsec_... from the admin route, never in the repository
  async onEvent(event) { /* store event.data.order, keyed by event.id */ },
});

// in your HTTP handler - the RAW body, not parsed JSON:
const { status } = await receive({ rawBody, headers: req.headers });
res.writeHead(status).end();

Co zostaje u Ciebie

Konfigurator wycenia i planuje cięcie; Twoja platforma zachowuje wszystko, co następuje potem.

• — Koszyk, kasa i płatność: CutOptim nie pobiera płatności.
• — Rekord zamówienia i jego realizacja, w Twojej bazie danych lub ERP.
• — Twoi klienci i strony Twojego sklepu: nie ma hostowanego sklepu.

Gdzie to pasuje

Każdy system, który potrafi przyjąć żądanie HTTPS i obliczyć HMAC, może przyjmować te zamówienia: sklep napisany we własnym zakresie, headless storefront, narzędzie do wycen albo ERP. Jeśli potrzebujesz samego silnika rozkroju, bez ekranu zamówień, służy do tego Engine API.

Powiązane kalkulatory, poradniki i branże

• Jak zamówić płyty na wymiar i nie poprawiać formatek →

Więcej o konfiguratorze

Potrzebujesz tylko silnika rozkroju? Zobacz Engine API

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