Referencia de la API del configurador
La API para comercios del configurador CutOptim: las llamadas que la incrustación hace desde la página de tu tienda, las dos comprobaciones que hace tu servidor antes de que nada llegue a un carrito y los webhooks firmados que recibe tu servidor cuando se hace un pedido o cambia su estado.
URL base https://cfg.cutoptim.com · Versión del contrato v1 · Documento OpenAPI 3.1
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.
Referencia de la API →Referencia completa de la CutOptim Engine API: endpoints, estructuras de solicitud y respuesta, todas las opciones, códigos de error, motores, versionado y límites.Tres reglas detrás de cada integración
La integración es pequeña, pero tres reglas deciden si es segura. Cada página de esta referencia vuelve a ellas.
- El precio viene del servicio, nunca del navegador. La incrustación muestra un precio que el servicio calculó a partir de tu configuración publicada; un número en un evento del navegador no demuestra nada.
- Tu servidor verifica antes del carrito. Envía el token del presupuesto a
POST /cfg/v1/quote/verifycon tu clave secreta y busca el pedido conGET /cfg/v1/orders/{id}. - Un webhook solo es de fiar cuando su firma se comprueba sobre los bytes en bruto que recibiste, y se procesa una sola vez por id de evento.
Por dónde empezar
¿Primera vez con el configurador? Lee primero el Inicio rápido y después Claves y autenticación. La página Rutas de la API lista todas las rutas; el documento OpenAPI que hay detrás es el contrato legible por máquina que puede leer tu generador de código.
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)