Intégrer les commandes de découpe à votre propre boutique ou ERP

Le CutOptim Configurator se relie à une boutique ou à un ERP développé sur mesure par deux vérifications sur votre serveur : le devis signé et le webhook signé. Les deux sont du simple HMAC-SHA256, vérifiable dans n’importe quel langage, et des exemples de référence en Node et PHP montrent comment.

Deux vérifications, toutes deux sur votre serveur

Une plateforme sur mesure n’a pas de plug-in sur lequel s’appuyer, la confiance repose donc sur deux signatures. Le navigateur peut afficher un prix, mais seul votre serveur décide de le croire.

Vérifier le devis avant le panier

Le jeton de devis est la promesse de prix. Votre serveur demande à CutOptim s’il est authentique, non expiré et pas encore utilisé, puis compare ce qu’il déclare avec la ligne du panier.

1. Recevoir la commande

   La page transmet à votre script l’événement cutoptim:order avec la commande et son jeton de devis.

2. Interroger CutOptim

   Votre serveur envoie le jeton à /cfg/v1/quote/verify avec votre clé secrète. La réponse indique s’il est valide, si une commande l’a déjà utilisé et quelles déclarations il porte.

3. Comparer les déclarations

   Le locataire, la devise, l’expiration et l’empreinte des lignes chiffrées doivent correspondre à la ligne que vous allez ajouter. Tout le reste est refusé.

4. Ajouter ou refuser

   Seul un jeton qui passe arrive dans le panier. Un prix modifié dans le navigateur échoue ici.

Recevoir la commande par webhook

Quand une commande est passée, CutOptim l’envoie à l’adresse que vous avez enregistrée, signée pour que vous puissiez savoir qu’elle vient de nous.

• — L’en-tête CutOptim-Signature porte un horodatage t et une signature v1 : un HMAC-SHA256 de l’horodatage, d’un point et du corps brut.
• — Vérifiez les octets bruts exactement comme reçus ; un corps analysé puis réécrit ne correspond plus.
• — Refusez un horodatage à plus de cinq minutes d’écart et comparez les signatures en temps constant.
• — Enregistrez l’identifiant de l’événement et répondez par un succès pour un identifiant déjà vu : une nouvelle tentative le répète.

Code de référence en Node et en PHP

Deux petits exemples font exactement cela, sans framework ni dépendance : un module Node et un seul fichier PHP. Copiez celui qui convient, remplacez le stockage en mémoire par une table à clé unique sur l’identifiant de l’événement.

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 qui reste chez vous

Le configurateur chiffre et planifie la découpe ; votre plateforme garde tout ce qui vient après.

• — Le panier, la caisse et le paiement : CutOptim n’encaisse aucun paiement.
• — La fiche de commande et son exécution, dans votre base de données ou votre ERP.
• — Vos clients et les pages de votre boutique : il n’y a pas de boutique hébergée.

Où cela s’intègre

Tout système capable de recevoir une requête HTTPS et de calculer un HMAC peut prendre ces commandes : boutique développée en interne, vitrine headless, outil de devis ou ERP. Pour le seul moteur de découpe, sans écran de commande, l’Engine API s’en charge.

Calculateurs, guides et métiers liés

• Commander une découpe sur mesure sans refaire les pièces →

En savoir plus sur le configurateur

Vous n’avez besoin que du moteur de découpe ? Voir l’Engine API

Mentions légalesConditions du configurateur (EN) ·Accord de traitement des données (EN) ·Notice de confidentialité pour les acheteurs ·Licences tierces (EN)