Ugrás a tartalomhoz
← Vissza: CutOptim ConfiguratorSaját platform

Lapszabászati rendelések integrációja a saját webshopodba vagy ERP-dbe

A CutOptim Configurator két ellenőrzéssel kapcsolódik egy saját fejlesztésű webshophoz vagy ERP-hez, a szervereden: az aláírt ajánlattal és az aláírt webhookkal. Mindkettő sima HMAC-SHA256, bármelyik nyelven ellenőrizhető, és a Node és PHP referenciapéldák megmutatják, hogyan.

Gyors válasz

Ha a saját platformodon fogadsz konfigurátor-rendeléseket, a szervered két dolgot tesz. Az aláírt ajánlatot ellenőrzi, mielőtt egy tétel a kosárba kerülne, és az aláírt webhookot ellenőrzi, mielőtt elmentene egy rendelést. A CutOptim nem szed be fizetést és nem üzemeltet webshopot: a kosár, a fizetés és a rendelés rekordja nálad marad.

Két ellenőrzés, mindkettő a te szervereden

Egy saját platformnak nincs pluginja, amire támaszkodhatna, ezért a bizalom két aláíráson múlik. A böngésző mutathat árat, de hinni neki csak a te szervered dönthet.

PillanatMi érkezikMit ellenőriz a szervered
A vevő megrendel az oldalonA cutoptim:order esemény a rendeléssel és az aláírt ajánlattalAz ajánlat-tokent, a titkos kulcsoddal a /cfg/v1/quote/verify címen
A rendelés leadvaAláírt webhook az általad megadott címreAz aláírást, az ötperces időablakot és az esemény azonosítóját
Újrapróbálkozás vagy újraküldésUgyanaz az esemény még egyszerSemmi újat: az esemény azonosítója már el van mentve

Ellenőrizd az ajánlatot a kosár előtt

Az ajánlat-token az ár ígérete. A szervered megkérdezi a CutOptimot, hogy valódi, lejáratlan és még fel nem használt-e, majd összeveti az állításait a kosártétellel.

  1. Fogadd a rendelést

    Az oldal átadja a szkriptednek a cutoptim:order eseményt a rendeléssel és az ajánlat-tokennel.

  2. Kérdezd meg a CutOptimot

    A szervered a titkos kulcsoddal elküldi a tokent a /cfg/v1/quote/verify címre. A válasz megmondja, érvényes-e, felhasznált-e már egy rendelés, és milyen állításokat hordoz.

  3. Vesd össze az állításokat

    A bérlő, a pénznem, a lejárat és az árazott tételek hash-e egyezzen a hozzáadni kívánt tétellel. Minden más elutasítandó.

  4. Add hozzá vagy utasítsd el

    Csak az átmenő token jut a kosárba. A böngészőben átírt ár itt elbukik.

Az aláíró kulcsot soha nem adjuk ki boltoknak. A token alakját és lejáratát helyben is ellenőrizheted, ez egy kérést megspórol, de az aláírást csak a /cfg/v1/quote/verify tudja megerősíteni.

Fogadd a rendelést webhookkal

Amikor egy rendelés leadásra kerül, a CutOptim elküldi az általad megadott címre, aláírva, hogy felismerd: tőlünk jött.

  • — A CutOptim-Signature fejléc egy t időbélyeget és egy v1 aláírást hordoz: az időbélyeg, egy pont és a nyers törzs HMAC-SHA256 értékét.
  • — A nyers bájtokat pontosan úgy ellenőrizd, ahogy megérkeztek; az a törzs, amelyet feldolgoztak és újra kiírtak, már nem egyezik.
  • — Utasítsd el az öt percnél régebbi vagy újabb időbélyeget, és az aláírásokat állandó idejű összehasonlítással vesd össze.
  • — Mentsd el az esemény azonosítóját, és egy már látott azonosítóra válaszolj sikerrel: az újrapróbálkozás ugyanazt küldi.

Referenciakód Node-ban és PHP-ban

Két kis példa pontosan ezt teszi, keretrendszer és függőség nélkül: egy Node-modul és egyetlen PHP-fájl. Másold ki a megfelelőt, a memóriabeli tárolót cseréld egy olyan táblára, amelyen az esemény azonosítója egyedi kulcs, a titkaidat pedig tartsd a környezetben.

Referenciakód: webhook ellenőrzése (Node)
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();

Mi marad nálad

A konfigurátor árazza és megtervezi a szabást; a platformod megtartja mindazt, ami utána jön.

  • — A kosár, a pénztár és a fizetés: a CutOptim nem szed be fizetést.
  • — A rendelés rekordja és teljesítése, a saját adatbázisodban vagy ERP-dben.
  • — A vevőid és a webshopod oldalai: nincs üzemeltetett webshop.

Indíts ingyenes sandboxot a konzolban a kulcsaidhoz és a webhook-titkodhoz. A referenciapéldák ezen az oldalon letölthetők.

Hová illik

Minden rendszer fogadhatja ezeket a rendeléseket, amely HTTPS-kérést tud fogadni és HMAC-ot tud számolni: házon belül írt webshop, headless frontend, ajánlatkészítő eszköz vagy ERP. Ha csak a szabásmotorra van szükséged, a rendelőfelületre nem, azt az Engine API szolgálja ki.

Gyakori kérdések

Kell plugin ahhoz, hogy a saját platformomat bekössem?
Nem. Egy saját platformnak két ellenőrzésre van szüksége a szerverén, az aláírt ajánlatra és az aláírt webhookra, és a Node és PHP példák mindkettőt megmutatják. Nincs olyan CutOptim-kód, amelyet a webshopodba kellene telepíteni.
Honnan tudom, hogy az árat nem írták át a böngészőben?
A szervered a titkos kulcsoddal elküldi az ajánlat-tokent a /cfg/v1/quote/verify címre, és az állításait összeveti a kosártétellel. Az átírt vagy lejárt tokent érvénytelennek jelzi. Az a token, amelyet egy rendelés már felhasznált, érvényes marad, de redeemed: true értékkel tér vissza: nézd mindkét mezőt, és vezess saját nyilvántartást a felhasznált tokenekről.
Mi történik, ha a végpontom nem elérhető, amikor rendelés érkezik?
A CutOptim növekvő időközökkel újrapróbálja a kézbesítést, legfeljebb hat kísérletig, több órán át. Minden újrapróbálkozás ugyanazt az esemény-azonosítót hordozza, így az azonosítókat tároló fogadó a rendelést csak egyszer dolgozza fel.
A CutOptim beszedi a fizetést vagy üzemelteti a webshopomat?
Nem. A konfigurátor árazza és megtervezi a szabást, és az aláírt rendelést átadja a platformodnak. A kosár, a fizetés és a teljesítés a saját rendszeredben marad.
Milyen programozási nyelveket fednek le a példák?
Node-ot és PHP-t. Az aláírás sima HMAC-SHA256 a nyers törzs felett, így ugyanez a pár sor működik Pythonban, Javában, C#-ban vagy bármely más, titkosítási könyvtárral rendelkező nyelven.

Kapcsolódó kalkulátorok, útmutatók és szakmák

Még több a konfigurátorról

Csak a vágásoptimalizáló motor kell? Nézd meg az Engine API-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)