Integracija narudžbi rezanja u vlastiti web shop ili ERP

CutOptim Configurator povezuje se s vlastitim web shopom ili ERP-om dvjema provjerama na vašem poslužitelju: potpisanom ponudom i potpisanim webhookom. Oboje je obični HMAC-SHA256 koji može provjeriti svaki jezik, a referentni primjeri u Nodeu i PHP-u pokazuju kako.

Dvije provjere, obje na vašem poslužitelju

Vlastita platforma nema dodatak na koji bi se oslonila, pa povjerenje počiva na dva potpisa. Preglednik može prikazati cijenu, ali samo vaš poslužitelj odlučuje hoće li joj vjerovati.

Provjerite ponudu prije košarice

Token ponude je obećanje cijene. Vaš poslužitelj pita CutOptim je li autentičan, nije li istekao i nije li već iskorišten, a zatim uspoređuje što tvrdi sa stavkom u košarici.

1. Primite narudžbu

   Stranica predaje vašoj skripti događaj cutoptim:order s narudžbom i njezinim tokenom ponude.

2. Pitajte CutOptim

   Vaš poslužitelj šalje token na /cfg/v1/quote/verify s vašim tajnim ključem. Odgovor kaže je li važeći, je li ga već iskoristila neka narudžba i koje tvrdnje nosi.

3. Usporedite tvrdnje

   Najmoprimac, valuta, istek i sažetak procijenjenih stavki moraju odgovarati stavci koju namjeravate dodati. Sve ostalo se odbija.

4. Dodajte ili odbijte

   U košaricu stiže samo token koji prođe. Cijena promijenjena u pregledniku ovdje pada.

Primajte narudžbe webhookom

Kad se narudžba zaprimi, CutOptim je šalje na adresu koju ste upisali, potpisanu da možete prepoznati da dolazi od nas.

• — Zaglavlje CutOptim-Signature nosi vremensku oznaku t i potpis v1: HMAC-SHA256 vremenske oznake, točke i sirovog tijela.
• — Provjeravajte sirove bajtove točno onako kako su stigli; tijelo koje je parsirano i ponovno zapisano više se ne podudara.
• — Odbijte vremensku oznaku stariju ili noviju od pet minuta i uspoređujte potpise u konstantnom vremenu.
• — Spremite identifikator događaja i na već viđeni identifikator odgovorite uspjehom: ponovni pokušaj ga ponavlja.

Referentni kod u Nodeu i PHP-u

Dva mala primjera rade upravo to, bez frameworka i bez ovisnosti: Node modul i jedna PHP datoteka. Kopirajte onaj koji vam odgovara, zamijenite spremnik u memoriji tablicom s jedinstvenim ključem na identifikatoru događaja i čuvajte tajne u okruženju.

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();

Što ostaje kod vas

Konfigurator izračunava cijenu i planira rezanje; vaša platforma zadržava sve što slijedi nakon toga.

• — Košarica, blagajna i plaćanje: CutOptim ne naplaćuje.
• — Zapis narudžbe i njezina isporuka, u vašoj bazi podataka ili ERP-u.
• — Vaši kupci i stranice vašeg web shopa: ne postoji hostirani web shop.

Gdje se uklapa

Svaki sustav koji može primiti HTTPS zahtjev i izračunati HMAC može preuzimati ove narudžbe: web shop pisan u kući, headless storefront, alat za ponude ili ERP. Ako vam treba samo mehanizam rezanja, a ne zaslon za narudžbe, to pokriva Engine API.

Povezani kalkulatori, vodiči i djelatnosti

• Kako naručiti ploče po mjeri bez dorade →

Više o konfiguratoru

Treba vam samo motor za rezanje? Pogledajte Engine API

Pravne informacijeUvjeti konfiguratora (EN) ·Ugovor o obradi podataka (EN) ·Obavijest o privatnosti za kupce ·Licencije trećih strana (EN)