Magazin propriu sau ERP
Fără plugin, dezvoltatorul dumneavoastră conectează configuratorul la coș. Regula este o singură propoziție: un preț trimis de browser nu devine niciodată preț de coș până când serverul dumneavoastră nu l-a verificat la CutOptim.
Acces anticipat: API-ul pentru comercianți este construit și poate fi încercat într-un magazin sandbox; pluginurile pentru platformele de magazine sunt încă în dezvoltare. CutOptim nu încasează nicio plată: coșul, finalizarea comenzii și plata rămân în magazinul dumneavoastră.
Căile, numele câmpurilor, codurile de eroare, numele anteturilor și exemplele de cod rămân în engleză: ele sunt contractul.
Verificările pe server
- Primiți comanda din pagina dumneavoastră (evenimentul
cutoptim:order), cu oferta și id-ul comenzii. - Verificați tokenul ofertei cu
POST /cfg/v1/quote/verifyși cheia dumneavoastră secretă. Acceptați doarvalid: truecuredeemed: true;reason: "unavailable"înseamnă neverificat. - Comparați revendicările tokenului cu coșul dumneavoastră: id-ul tenantului, moneda, neexpirat.
- Căutați comanda cu
GET /cfg/v1/orders/{id}și comparați hashul planului, hashul ofertei și totalurile ei cu tokenul verificat. - Creați linia de coș la prețul verificat și rețineți nonce-ul tokenului, ca aceeași ofertă să nu poată deveni o a doua linie.
De ce o verificare locală nu este suficientă
Codul de referință poate verifica local un token: forma lui, cele 11 revendicări, forma canonică, tenantul dumneavoastră și expirarea. Nu poate dovedi semnătura, pentru că cheia de semnare rămâne la CutOptim. Doar verificarea de la distanță arată că prețul a fost semnat de serviciu.
Primirea webhookului
Verificați semnătura peste corpul brut, deduplicați după id-ul evenimentului și răspundeți cu 2xx; receptorul complet se află la Webhookuri.
Cod de referință
Două exemple mici, fără dependențe, de citit și copiat: Node (cutoptim-verify.mjs, example-server.mjs) și PHP (CutOptimVerify.php, example-webhook.php). Sunt cod de referință, nu un serviciu găzduit. Descărcări și parcurgere: Platformă proprie și pagina de ajutor.
Aici nu există intenționat un buton „încearcă”: cheia secretă aparține serverului dumneavoastră, niciodată unui browser. Magazinul demo arată integrarea și predarea comenzii funcționând de la cap la coadă.
JuridicTermenii configuratorului (EN) ·Acord de prelucrare a datelor (EN) ·Notă de confidențialitate pentru cumpărători ·Licențe terțe (EN)