Contratos de integración

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

Contrato de reservas

• Configura un destino de reserva (patrón booking_base_url o destino de bloque de app).
• Conserva el contexto del servicio mediante claves de parámetros de URL (por defecto service=product-handle; Hollow Reserve también acepta experience=blueprint-slug).
• Usa los tokens del tema (--sa-*) para que la UI incrustada coincida con la marca del comerciante.
• Hollow Reserve escucha los eventos studio-arcana:quiz:complete y hollow-reserve:open para prellenar el contexto de reserva (staff= en CTAs de resultado del quiz y tarjetas de service-menu).

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.