> For the complete documentation index, see [llms.txt](https://docs.lid.pro/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.lid.pro/es/developers/overview.md).

# Visión general

Cómo funciona Lid por dentro: el programa en Solana, las tres primitivas, la superficie de desarrollo (MCP, API REST, SDK, botón Pay with Lid, webhooks) y el stack que ya funciona.

Esta sección explica cómo funciona Lid por dentro. No necesitas nada de esto para crear tu página web ni para vender en Lid; existe para quien quiere construir sobre los mismos rieles. Si vas a conectar un agente de IA, empieza en [Agentes en Lid](https://docs.lid.pro/es/agents.md).

Estas páginas son de alto nivel. La referencia de cada ruta es la guía para desarrolladores en [lid.pro/docs](https://lid.pro/docs): la API REST, el SDK, el botón Pay with Lid, los webhooks, los errores y Lida por API.

## Qué es Lid desde la perspectiva de un desarrollador

Lid es la suite para negocios, con un programa de pagos en Solana debajo. En el nivel más básico, ese programa expone tres cosas.

1. **Registro de producto.** Un producto con un precio y una regla de comisión para sharers (affiliates, en la API).
2. **Vinculación de atribución.** Un pago enrutado a través de una referencia de sharer, aplicada on-chain.
3. **Repartos atómicos.** Un programa que acepta el pago y lo enruta a quien vende, al sharer y a Lid en la misma transacción.

Hoy se llega a estas primitivas por cuatro caminos: la app web de Lid, la conexión de agentes por MCP, la API REST con su SDK, y el botón Pay with Lid. Mira [API, SDK y botón de compra](https://docs.lid.pro/es/developers/agentic-commerce-api.md).

## Para quién es esta sección

* **Desarrolladores** que quieren entender la arquitectura de Lid antes de integrar.
* **Constructores de agentes** que piensan en cómo van a transaccionar los actores de software autónomos.
* **Socios de integración** que quieren embeber funciones de Lid en su propio producto.
* **Investigadores de seguridad** que quieren reportar problemas de forma responsable.

Si quieres una página web o vendes en Lid, nada de esto es lectura obligatoria. Todo lo que necesitas está en [Empieza aquí](https://docs.lid.pro/es/start-here/what-is-lid.md).

## Arquitectura de un vistazo

* **Cadena:** Solana mainnet
* **Activo de liquidación:** USDC (token SPL nativo)
* **Aplicación de la atribución:** programa de Solana
* **Metadatos de producto:** on-chain más una capa de almacenamiento de metadatos
* **UX de pago:** alojada por Lid, abstraída (sin exponer wallets al usuario final)
* **Wallet y autenticación:** wallet embebida de Privy, en producción
* **Entrada con tarjeta:** ya funciona, dentro de la app
* **Superficie de desarrollo:** la conexión MCP en `mcp.lid.pro`, una API REST en `api.lid.pro/api/v1`, el SDK (`@lidpro/sdk`), el botón Pay with Lid (`@lidpro/pay`), llaves de API con permisos y webhooks firmados en Configuración > Desarrollo

## Por qué Solana

Se necesitaban tres propiedades. Solo Solana entregó las tres a la escala que Lid necesita.

1. **Profundidad de stablecoins.** USDC en Solana tiene la liquidez para liquidar comercio real.
2. **Confirmación en menos de un segundo.** Un pago se confirma en menos de un segundo, así que pagar se siente como software, no como esperar confirmaciones de bloque.
3. **Costo bajo.** Las comisiones de red son de menos de un centavo, así que no se comen los repartos.

## Principios de diseño

**Repartos atómicos o nada.** Cada transacción liquida a todas las partes o a ninguna. Sin estados a medias.

**Atribución al pagar, no al hacer clic.** Un clic es una señal. Un pago es un compromiso. La atribución se fija en el momento del compromiso.

**UX abstraída.** La blockchain es invisible. Quien integre Lid debe poder conservar esa abstracción para sus usuarios finales.

**Distribución sin permisos.** El programa no filtra quién puede participar vendiendo. Las reglas van a nivel de producto, no de usuario.

**La comisión del 3% es una primitiva del protocolo.** Es parte de la lógica del reparto, no una capa de facturación encima.

## Stack que ya funciona

* **Privy** · wallet embebida y autenticación. Ya funciona.
* **Alchemy** · RPC de Solana. Ya funciona.
* **Pinata** · almacenamiento de metadatos en IPFS. Ya funciona.
* **Solana Pay** · UX de pago. Ya funciona.
* **USDC SPL Token** · activo de liquidación. Ya funciona.

## Qué funciona hoy

* Despliegue en Solana mainnet
* El programa que aplica repartos y comisiones
* Creación de productos y pago a través de la app web
* Liquidación en USDC
* Wallet embebida y autenticación de Privy
* Sitios creados con Lida, abiertos a todas las cuentas
* Cursos, membresías, retos, campañas y enlaces con seguimiento
* Carga de saldo con tarjeta
* La conexión de agentes por MCP: los agentes crean sitios, productos, enlaces para compartir, retos y campañas, leen ventas y trabajan el admin de un sitio. Webhooks firmados.
* La API REST en `api.lid.pro/api/v1`, el SDK `@lidpro/sdk` en npm, y el botón Pay with Lid

## Cómo participar

* **Construir sobre Lid:** empieza por la guía para desarrolladores en [lid.pro/docs](https://lid.pro/docs). Las preguntas van a <hello@lid.pro>.
* **Investigación de seguridad:** reporte responsable a <hello@lid.pro>. Se maneja en privado y con prioridad.
* **Frameworks de agentes:** si construyes un agente autónomo que necesita rieles económicos, escríbenos con lo que estás haciendo.

Siguiente: [El programa en Solana](https://docs.lid.pro/es/developers/solana-program.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.lid.pro/es/developers/overview.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
