Contratos de integración

Los contratos de integración mantienen un comportamiento predecible de las apps entre comerciantes y presets verticales.

Contrato de reservas

• Configuración del tema → Reservas: elige Hollow Reserve (recomendado) o Programador externo.
• Hollow Reserve usa /pages/booking si la URL base está vacía; Externo requiere URL base.
• Conserva el contexto del servicio con el parámetro del handle (por defecto service=product-handle).
• Hollow Reserve también acepta experience= y staff= para deep links.
• Los botones Reservar usan doble ruta: hollow-reserve:open si hay widget, si no navegan a la URL.
• Eventos: studio-arcana:quiz:complete, hollow-reserve:open / open-ack / booked; booking:click es solo analítica.
• Usa los tokens del tema (--sa-*) para que la UI incrustada coincida con tu marca.

Contrato de emparejamiento servicio y retail

• Los productos de servicio pueden exponer aftercare relacionado mediante custom.service_pairing.
• Opcional: custom.pairing_priority en SKUs aftercare controla Top pick frente a Also consider en la PDP.
• Los productos de aftercare pueden enlazar de vuelta a tratamientos con custom.treatment_service.
• Las superficies del carrito deben mostrar upsell retail o CTA de tratamiento según la composición del carrito.

Contrato de verificación

• Prueba en todas las tiendas de desarrollo por vertical.
• Comprueba que no haya errores de consola con y sin bloques de app.
• Comprueba experiencias de respaldo cuando falten metacampos.
• La configuración para comerciantes (metacampos y metaobjetos) está en el hub de documentación Arcanum (/docs) junto a esta página de desarrolladores.