Integrarea comenzilor de debitare în magazinul sau ERP-ul dumneavoastră

CutOptim Configurator se conectează la un magazin sau la un ERP propriu prin două verificări pe serverul dumneavoastră: oferta semnată și webhook-ul semnat. Ambele sunt HMAC-SHA256 simplu, verificabil în orice limbaj, iar exemplele de referință în Node și PHP arată cum.

Două verificări, ambele pe serverul dumneavoastră

O platformă proprie nu are un plug-in pe care să se sprijine, așa că încrederea stă în două semnături. Browserul poate afișa un preț, dar numai serverul dumneavoastră decide dacă îl crede.

Verificați oferta înainte de coș

Tokenul ofertei este promisiunea de preț. Serverul dumneavoastră întreabă CutOptim dacă este autentic, neexpirat și încă nefolosit, apoi compară ce declară cu linia din coș.

1. Primiți comanda

   Pagina transmite scriptului dumneavoastră evenimentul cutoptim:order cu comanda și tokenul ei de ofertă.

2. Întrebați CutOptim

   Serverul dumneavoastră trimite tokenul la /cfg/v1/quote/verify cu cheia secretă. Răspunsul spune dacă este valid, dacă o comandă l-a folosit deja și ce declarații poartă.

3. Comparați declarațiile

   Chiriașul, moneda, expirarea și amprenta liniilor cu preț trebuie să corespundă liniei pe care urmează să o adăugați. Orice altceva este refuzat.

4. Adăugați sau refuzați

   Doar un token care trece ajunge în coș. Un preț modificat în browser pică aici.

Primiți comanda prin webhook

Când o comandă este plasată, CutOptim o trimite la adresa pe care ați înregistrat-o, semnată, ca să puteți recunoaște că vine de la noi.

• — Antetul CutOptim-Signature poartă un marcaj de timp t și o semnătură v1: un HMAC-SHA256 al marcajului de timp, al unui punct și al corpului brut.
• — Verificați octeții bruți exact cum au sosit; un corp interpretat și scris din nou nu se mai potrivește.
• — Refuzați un marcaj de timp cu mai mult de cinci minute diferență, în urmă sau în față, și comparați semnăturile în timp constant.
• — Salvați id-ul evenimentului și răspundeți cu succes la un id deja văzut: o reîncercare îl repetă.

Cod de referință în Node și PHP

Două exemple mici fac exact acest lucru, fără framework și fără dependențe: un modul Node și un singur fișier PHP. Copiați-l pe cel potrivit, înlocuiți stocarea din memorie cu un tabel cu cheie unică pe id-ul evenimentului și păstrați secretele în mediu.

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

Ce rămâne la dumneavoastră

Configuratorul calculează prețul și planifică tăierea; platforma dumneavoastră păstrează tot ce urmează după aceea.

• — Coșul, casa și plata: CutOptim nu încasează plăți.
• — Înregistrarea comenzii și onorarea ei, în baza dumneavoastră de date sau în ERP.
• — Clienții dumneavoastră și paginile magazinului: nu există un magazin găzduit.

Unde se potrivește

Orice sistem care poate primi o cerere HTTPS și poate calcula un HMAC poate prelua aceste comenzi: un magazin scris intern, un storefront headless, un instrument de oferte sau un ERP. Dacă aveți nevoie doar de motorul de debitare, nu și de ecranul de comandă, Engine API îl oferă.

Calculatoare, ghiduri și domenii înrudite

• Cum comanzi debitare PAL fără să refaci reperele →

Mai multe despre configurator

Aveți nevoie doar de motorul de debitare? Vedeți Engine API

JuridicTermenii configuratorului (EN) ·Acord de prelucrare a datelor (EN) ·Notă de confidențialitate pentru cumpărători ·Licențe terțe (EN)