Salta al contenuto principale
← Riferimento API

Shop personalizzato o ERP

Senza plug-in, è il tuo sviluppatore a collegare il configuratore al carrello. La regola è una frase: un prezzo inviato dal browser non diventa mai un prezzo del carrello finché il tuo server non l'ha verificato con CutOptim.

Accesso anticipato: l'API per i commercianti è pronta e si può provare in uno shop sandbox; i plug-in per le piattaforme di e-commerce sono ancora in sviluppo. CutOptim non incassa alcun pagamento: il carrello, il checkout e il pagamento restano nel tuo shop.

Percorsi, nomi dei campi, codici di errore, nomi degli header ed esempi di codice restano in inglese: sono il contratto.

I controlli lato server

  • Ricevi l'ordine dalla tua pagina (l'evento cutoptim:order), con il preventivo e l'id dell'ordine.
  • Verifica il token del preventivo con POST /cfg/v1/quote/verify e la tua chiave segreta. Accetta solo valid: true con redeemed: true; reason: "unavailable" significa non verificato.
  • Confronta le rivendicazioni del token con il tuo carrello: il tuo id tenant, la tua valuta, non scaduto.
  • Recupera l'ordine con GET /cfg/v1/orders/{id} e confronta il suo hash del piano, l'hash del preventivo e i totali con il token verificato.
  • Crea la riga del carrello al prezzo verificato e ricorda il nonce del token, così lo stesso preventivo non può diventare una seconda riga.

Perché un controllo locale non basta

Il codice di riferimento può controllare un token in locale: la sua forma, le 11 rivendicazioni, la forma canonica, il tuo tenant e la scadenza. Non può dimostrare la firma, perché la chiave di firma resta presso CutOptim. Solo il controllo remoto attesta che il prezzo è stato firmato dal servizio.

Ricevere il webhook

Verifica la firma sul corpo grezzo, deduplica sull'id evento e rispondi 2xx; il ricevitore completo è in Webhook.

Codice di riferimento

Due piccoli esempi senza dipendenze da leggere e copiare: Node (cutoptim-verify.mjs, example-server.mjs) e PHP (CutOptimVerify.php, example-webhook.php). Sono codice di riferimento, non un servizio ospitato. Download e procedura guidata: Piattaforma personalizzata e la pagina di aiuto.

Qui non c'è un pulsante "provalo" di proposito: la chiave segreta appartiene al tuo server, mai a un browser. Lo shop demo mostra l'incorporamento e il passaggio dell'ordine in funzione da un capo all'altro.

Note legaliCondizioni del configuratore (EN) ·Accordo sul trattamento dei dati (EN) ·Informativa privacy per gli acquirenti ·Licenze di terze parti (EN)