# Integración con menta tech ## Descripción general menta tech es una capa de infraestructura que habilita mercados secundarios oficiales para plataformas de ticketing. Opera completamente sobre tus sistemas existentes. Tu plataforma sigue siendo la fuente de verdad para usuarios, tickets, ownership y fulfillment, mientras que menta provee la orquestación, la lógica y los flujos de usuario necesarios para operar una reventa segura y controlada. La integración está diseñada para ser simple. En lugar de exponer decenas de endpoints desconectados, menta se organiza alrededor de un conjunto reducido de decisiones arquitectónicas que definen cómo funciona la reventa dentro de tu entorno. Una vez que estas decisiones están definidas, la experiencia de reventa pasa a ser totalmente automatizada y gobernada por reglas desde menta. Esta documentación te va a guiar a través de esas decisiones. Cada una representa un punto de contacto entre tu plataforma y menta, y en conjunto conforman una integración completa y preparada para el futuro. ## En qué consiste la integración La integración se estructura en torno a siete componentes clave. Cada uno responde una pregunta específica sobre cómo debe operar la reventa dentro de tu ecosistema: - **Sincronización de Eventos (Event Sync)** - Cómo menta tech recibe la información de tus eventos para habilitar la reventa. - **Estructura de la información** - Cómo se representan tus categorías o niveles de acceso para que el inventario de reventa pueda agruparse y mostrarse correctamente, en cuanto a zonas y niveles de precio. - **Sincronización de tickets** - Cómo menta tech conoce la información de los dueños de los boletos para que los usuarios puedan publicar, gestionar y transferir tickets de reventa. - **Autenticación** - Cómo se autentican los usuarios entre tu plataforma y menta tech, bilateralmente, usando tu sistema de identidad existente. - **Acceso a vender** - Cómo ingresan los usuarios al flujo de publicación en reventa desde tu plataforma. - **Acceso a comprar** - Cómo se muestra el inventario de reventa en tus páginas de evento y cómo ingresan los usuarios al flujo de compra en reventa. - **Entrega del boleto adquirido en reventa** - Cómo menta tech te notifica luego de que la reventa se concretó para que tu sistema pueda darle el boleto al comprador. Esta es toda la superficie de integración. No hay requisitos ocultos adicionales. Todas las capacidades de reventa que ofrece menta tech, desde CTAs dinámicos hasta componentes embebidos y balanceo automatizado de oferta y demanda, se apoyan en alguno de estos componentes. La sección de API Reference describe cada endpoint en detalle. ## Qué puedes esperar a medida que avances Cada sección de esta documentación: - Explica el propósito del componente de integración - Presenta las opciones disponibles - Describe en qué casos tiene sentido cada opción - Detalla cómo se adapta menta tech a tu arquitectura existente - Mantiene la mayor parte de la complejidad del lado de menta para que tu integración se mantenga liviana Al finalizar, vas a tener una visión clara de cómo diseñar, implementar y operar un mercado secundario oficial totalmente integrado, con el mínimo esfuerzo de ingeniería y la máxima flexibilidad. Si es la primera vez que trabajas con menta tech, el mejor punto de partida es la sección de Conceptos clave y modelo de datos que sigue a continuación. Ahí se presentan las entidades y relaciones que se utilizan en toda la integración y que forman el vocabulario común del resto de las guías. ## Conceptos clave y modelo de datos ### Entidades El modelo de datos de menta tech refleja cómo las plataformas de ticketing ya piensan sus eventos y tickets. - **Evento (Event)** - Un concepto de alto nivel como "Coldplay - Music of the Spheres". Un evento puede tener uno o varios shows. - **Función o show (Show)** - Una fecha o función específica de un evento. Cada show pertenece a un evento e incluye fecha, venue y configuración. - **Categoría de acceso (ticketOption)** - Representa la forma en que los fans acceden a una función, por ejemplo "Campo general", "VIP", "Platea baja". Es lo que el comprador de reventa ve y elige en el flujo de compra. - **Tipo de precio (priceType)** - Representa cómo fue fijado el precio originalmente, por ejemplo "Early bird", "Preventa", "Precio estándar". Es clave para las reglas de configuración, aunque en la reventa el comprador normalmente se enfoca en la categoría de acceso. - **Ticket** - Representa un ticket individual que pertenece a un usuario. Un ticket pertenece a un evento (event), a una función específica (show), a una categoría de acceso (ticketOption) y opcionalmente a una variación de precio (priceType). La información del ticket incluye ownership, ubicación en la sala y otros atributos. - **Usuario (User)** - Representa a la persona que posee tickets o compra en reventa. Tu plataforma define esta identidad usando tu propio userId y, opcionalmente, email o teléfono, según tu modelo de usuarios.