Tienda propia o ERP
Sin plugin, tu desarrollador conecta el configurador al carrito. La regla cabe en una frase: un precio que envió el navegador nunca se convierte en precio de carrito hasta que tu servidor lo haya comprobado con CutOptim.
Acceso anticipado: la API para comercios está construida y se puede probar en una tienda sandbox; los plugins para plataformas de tienda siguen en desarrollo. CutOptim no cobra ningún pago: el carrito, la caja y el pago se quedan en tu tienda.
Las rutas, los nombres de campo, los códigos de error, los nombres de cabecera y los ejemplos de código se quedan en inglés: son el contrato.
Las comprobaciones en el servidor
- Recibe el pedido desde tu página (el evento
cutoptim:order), con el presupuesto y el id del pedido. - Verifica el token del presupuesto con
POST /cfg/v1/quote/verifyy tu clave secreta. Acepta solovalid: trueconredeemed: true;reason: "unavailable"significa no verificado. - Compara las declaraciones del token con tu carrito: tu id de tenant, tu moneda, que no haya caducado.
- Busca el pedido con
GET /cfg/v1/orders/{id}y compara su hash del plan, hash del presupuesto y totales con el token verificado. - Crea la línea de carrito al precio verificado y recuerda el nonce del token para que el mismo presupuesto no pueda convertirse en una segunda línea.
Por qué una comprobación local no basta
El código de referencia puede comprobar un token en local: su forma, las 11 declaraciones, la forma canónica, tu tenant y la caducidad. No puede demostrar la firma, porque la clave de firma se queda en CutOptim. Solo la comprobación remota dice que el precio lo firmó el servicio.
Recibir el webhook
Verifica la firma sobre el cuerpo en bruto, elimina duplicados por id de evento y responde 2xx; el receptor completo está en Webhooks.
Código de referencia
Dos ejemplos pequeños y sin dependencias para leer y copiar: Node (cutoptim-verify.mjs, example-server.mjs) y PHP (CutOptimVerify.php, example-webhook.php). Son código de referencia, no un servicio alojado. Descargas y recorrido: Plataforma propia y la página de ayuda.
Aquí no hay un botón «probar» a propósito: la clave secreta pertenece a tu servidor, nunca a un navegador. La tienda demo muestra la incrustación y el traspaso del pedido funcionando de principio a fin.
Información legalCondiciones del configurador (EN) ·Contrato de encargo de tratamiento (EN) ·Aviso de privacidad para compradores ·Licencias de terceros (EN)