Boutique sur mesure ou ERP
Sans plug-in, votre développeur relie le configurateur au panier. La règle tient en une phrase : un prix envoyé par le navigateur ne devient jamais un prix de panier tant que votre serveur ne l’a pas vérifié auprès de CutOptim.
Accès anticipé : l’API marchand est développée et peut être essayée dans une boutique bac à sable ; les plug-ins pour les plateformes de boutique sont encore en développement. CutOptim n’encaisse aucun paiement : le panier, la commande et le paiement restent dans votre boutique.
Les chemins, noms de champs, codes d’erreur, noms d’en-têtes et exemples de code restent en anglais : ils font partie du contrat.
Les vérifications côté serveur
- Recevez la commande depuis votre page (l’événement
cutoptim:order), avec le devis et l’identifiant de commande. - Vérifiez le jeton de devis avec
POST /cfg/v1/quote/verifyet votre clé secrète. N’acceptez quevalid: trueavecredeemed: true;reason: "unavailable"signifie non vérifié. - Comparez les revendications du jeton avec votre panier : votre identifiant de tenant, votre devise, non expiré.
- Retrouvez la commande avec
GET /cfg/v1/orders/{id}et comparez son hash de plan, son hash de devis et ses totaux avec le jeton vérifié. - Créez la ligne de panier au prix vérifié, et mémorisez le nonce du jeton pour que le même devis ne puisse pas devenir une seconde ligne.
Pourquoi une vérification locale ne suffit pas
Le code de référence peut vérifier un jeton localement : sa forme, les 11 revendications, la forme canonique, votre tenant et l’expiration. Il ne peut pas prouver la signature, car la clé de signature reste chez CutOptim. Seule la vérification à distance atteste que le prix a été signé par le service.
Recevoir le webhook
Vérifiez la signature sur le corps brut, dédupliquez sur l’identifiant d’événement et répondez par un 2xx ; le récepteur complet se trouve sur Webhooks.
Code de référence
Deux petits exemples sans dépendances, à lire et à copier : Node (cutoptim-verify.mjs, example-server.mjs) et PHP (CutOptimVerify.php, example-webhook.php). Ce sont du code de référence, pas un service hébergé. Téléchargements et pas-à-pas : Plateforme sur mesure et la page d’aide.
Il n’y a volontairement pas de bouton « essayer » ici : la clé secrète appartient à votre serveur, jamais à un navigateur. La boutique de démonstration montre l’intégration et la transmission de la commande de bout en bout.
Mentions légalesConditions du configurateur (EN) ·Accord de traitement des données (EN) ·Notice de confidentialité pour les acheteurs ·Licences tierces (EN)