# menta tech — Developer Documentation

> menta tech is an infrastructure layer that powers official secondary markets (resale) for primary ticketing platforms. The partner's platform remains the source of truth for users, tickets, ownership and fulfillment; menta provides the marketplace, rules, payments and user flows. This file lists every integration guide and the REST API reference so AI agents can fetch the raw markdown directly without executing JavaScript.

Language: es. Swap via `?locale=en` or `?locale=es`.

## Integration at a glance

- **Integration paths:** (1) static menta-hosted URLs (MVP), (2) Smart Access Layer / SAL (recommended — the partner's UI calls the SAL and renders states, CTAs and components natively), (3) WebView embedding for mobile apps. Paths combine and most partners progress from 1 to 2.
- **Partner-side pillars:** event sync (feed endpoint menta polls), ticket sync (`getUserData` endpoint menta calls on demand), bilateral authentication (Login Trust + Login Force, OTP fallback), SAL SELL / SAL BUY, fulfillment (consume the critical `ticket.updated` webhook and transfer ownership in the partner system), webhooks, and optional Market Data (leads/inventory).
- **Recommended reading order:** Introduction → Event Synchronization → User Authentication → Access to Sell (incl. Tickets Sync) → Access to Buy (incl. UI Components) → Resale Ticket Fulfillment → Webhooks → Market Data → WebView Integration.
- **Agent skill:** [https://docs.mentatech.io/menta-integration-skill.md](https://docs.mentatech.io/menta-integration-skill.md) — a self-contained skill file describing every integration path, what to build for each, key concepts (IDs, listings, fees, P2P) and how to navigate this documentation. Fetch it first when assisting an integration.
- **Not covered publicly** (ask the menta account contact, do not guess): API key issuance, environments, webhook registration and credentials, dashboard rule configuration, go-live validation.

## How to consume this documentation

- Every guide below links to a **`.md`** file served as `text/markdown`. Fetch the URL directly — no browser or JS runtime needed.
- For the complete corpus in a single file, fetch [https://docs.mentatech.io/llms-full.txt?locale=es](https://docs.mentatech.io/llms-full.txt?locale=es).
- The machine-readable index is at [https://docs.mentatech.io/api/guides/index](https://docs.mentatech.io/api/guides/index).

## API Reference

- [REST API reference (Markdown)](https://docs.mentatech.io/api-reference.md) — every endpoint with parameters, top-level request-body fields and response codes, grouped by resource.
- [OpenAPI 3.1 spec (JSON)](https://docs.mentatech.io/api/openapi) — the complete machine-readable spec with full schemas and examples.
- Base URL: `https://api.mentatech.io` — authenticate with your private API key in the `Authorization` header.

## Guides


### Fundamentos de la Integración

- [Introducción](https://docs.mentatech.io/es/guides/introduccion.md)
- **Sincronización de eventos**
  - [Métodos de Sincronización](https://docs.mentatech.io/es/guides/eventData.md)
  - [Estructura de la información](https://docs.mentatech.io/es/guides/infoStructure.md)
- [Autenticación de usuarios](https://docs.mentatech.io/es/guides/auth.md)
- **Acceso a la venta**
  - [Introducción](https://docs.mentatech.io/es/guides/accessToSell-into.md)
  - [Sincronizar tickets](https://docs.mentatech.io/es/guides/ticketSync.md)
- **Acceso a la Compra**
  - [Introducción](https://docs.mentatech.io/es/guides/accessToBuy.md)
  - [Componentes en UI](https://docs.mentatech.io/es/guides/uiComponents.md)
- [Entrega del boleto adquirido en reventa](https://docs.mentatech.io/es/guides/ticketFulfillment.md)
- **Datos del Mercado**
  - [Inventario](https://docs.mentatech.io/es/guides/inventory.md)
  - [Tickets](https://docs.mentatech.io/es/guides/ticketLeads.md)
- **Integración en WebViews**
  - [Introducción](https://docs.mentatech.io/es/guides/webviewIntegration.md)
- **Webhooks**
  - [Introducción](https://docs.mentatech.io/es/guides/webhooksIntro.md)