> 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/agentic-commerce-api.md).

# API, SDK y botón de compra

La API REST, el SDK y el botón Pay with Lid: qué hace cada uno, de dónde sale la llave, cómo probar y dónde está la referencia completa.

En palabras simples: esta página es para quien quiere que su propio software trabaje con Lid. Si creas tu página con Lida o vendes desde la app, nada de aquí cambia cómo usas Lid.

## ¿Con qué puedo construir?

Cuatro piezas, y todas ya funcionan.

| Pieza              | Qué es                                                                                                                                                                                                        | Dónde                                                                               |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| API REST           | Las rutas que tiene un agente, por HTTPS: productos, ventas, retos, enlaces, campañas y sitios                                                                                                                | `https://api.lid.pro/api/v1`                                                        |
| SDK                | Un cliente tipado para la API REST, con reintentos, llaves de idempotencia, una sola clase de error y helpers de webhooks. Corre en Node 20+ y en runtimes edge, en tu servidor, porque lleva tu llave de API | `@lidpro/sdk` en npm                                                                |
| Botón Pay with Lid | Un botón en tu sitio que manda al visitante a una página de pago de Lid. No manejas llaves ni transacciones                                                                                                   | una etiqueta script desde `lid.pro/checkout.js`, o `@lidpro/pay` para React         |
| Conexión MCP       | Las mismas herramientas para un agente de IA                                                                                                                                                                  | `https://mcp.lid.pro/mcp`, mira [Agentes en Lid](https://docs.lid.pro/es/agents.md) |

La referencia de cada ruta, con su llamada del SDK, su curl y una respuesta de ejemplo, es la guía para desarrolladores en [lid.pro/docs](https://lid.pro/docs).

## ¿De dónde sale la llave?

De **Configuración → Desarrollo → Crear llave de API**, con los permisos que elijas. La envías como bearer token, y la misma llave sirve por MCP y por REST. Una llamada sin el permiso correcto responde `403 insufficient_scope`, y una llave vencida responde `401 key_expired`. Mira [Uso y límites](https://docs.lid.pro/es/agents/limits.md).

## ¿Cómo funciona el botón Pay with Lid?

El botón abre una página de pago alojada por Lid, en `lid.pro/checkout/` seguido de la dirección del producto. Quien compra entra a Lid y paga en dólares digitales (USDC), y quien vende cobra en esa misma transacción.

* Puedes pasar `return_url`, `cancel_url` y `theme`.
* Pasa un código para compartir en `ref` y la comisión del sharer se le asigna en la misma transacción.
* Lid devuelve a quien compra a tu sitio con `lid_status`, `lid_product`, `lid_receipt` y `lid_signature`.
* Confirma la venta desde tu servidor con el webhook `purchase.completed` o con `GET /agent/sales`. Un producto con ventana de reembolso queda protegido y no envía webhook: aparece en `GET /agent/sales` con kind `hold`.

## ¿Puedo probar sin dinero real?

Sí. El SDK acepta `environment: 'devnet'`, que apunta a `https://api-devnet.lid.pro` y usa USDC de prueba, sin valor.

## ¿Mi propio sistema puede hablar con Lida?

Sí, por la API REST. `POST /lida/turns` conversa con Lida y necesita el permiso **Conversar con Lida**. `POST /lida/tasks` le pide una tarea y necesita el permiso **Tareas de Lida**. Envías tus instrucciones y tu contexto en cada solicitud, y Lida trata tu contexto como dato. La guía para desarrolladores cubre el formato de la solicitud y cómo se cuenta el uso.

## ¿Un agente de IA puede crear un producto digital en Lid hoy?

Sí, por MCP o por REST. Un agente con una llave crea un producto, aloja el archivo, fija una comisión para sharers y lee sus ventas; cuando alguien compra, el dinero se liquida en una sola transacción, 3% fijo, en la wallet real del dueño de la llave. También puede crear un sitio, compartir productos de otros, correr retos y campañas, revisar resultados y recibir webhooks firmados. Empieza en [Agentes en Lid](https://docs.lid.pro/es/agents.md) y en la [Referencia de herramientas](https://docs.lid.pro/es/agents/tools.md).

## ¿Qué no es?

* Una API pública de pagos para transferencias arbitrarias de USDC. Lid liquida ventas. Los pagos de propósito general quedan fuera.
* Una forma de convertir dólares digitales en dinero en un banco. La carga de saldo con tarjeta es una pieza aparte, dentro de la app.

Las preguntas van a <hello@lid.pro>, con una descripción corta de lo que estás construyendo.

Siguiente: [Integraciones](https://docs.lid.pro/es/developers/integrations.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/agentic-commerce-api.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.
