# Documentación · Documentación de Pagos Express

> Empieza con la API de Pagos Express: crea una clave de prueba, publica tu primer enlace de cobro con REST y confirma el pago. Guías, referencia OpenAPI y MCP.

HTML: https://pagos.express/docs
Texto para modelos: https://pagos.express/docs.llms.txt
Índice de la documentación: https://pagos.express/docs

La API vive en https://api.pagos.express. Rutas públicas bajo `/v1`. Convenciones estilo Stripe: `Authorization: Bearer <clave>`, `Idempotency-Key` en las creaciones, paginación por cursor con `starting_after`, errores `application/problem+json`.

## Convenciones
- Importes enteros en unidades menores: 150000 = MX$1,500.00. Nunca decimales.
- Cada objeto trae `livemode`. Las claves `sk_test_` nunca ven ni crean datos en vivo.
- Las listas responden `{ "object": "list", "data": [...], "has_more": true }`.

## Primer cobro en cinco minutos
1. Crea una cuenta y, en el dashboard, abre "API y MCP". Crea una clave de prueba (se muestra una sola vez).
2. Conecta Stripe o eCart Pay en "Conexiones" en modo pruebas. Sin una conexión activa, crear responde `409 no_active_connection`. Sin cuenta de eCart Pay, créala con el enlace de partner de Pagos Express: https://api.partners.tendencys.com/api/r/100/ecartpay
3. `POST /v1/payment_links` con `Idempotency-Key`, `title`, `items[]` (`name`, `quantity`, `unitPriceCentavos`) y `currency`. Responde 201 con `url`: la página pública donde paga el cliente. Crear no cobra.
4. Confirma con `GET /v1/payment_links/{id}` (`status: paid`) o con el webhook `payment.succeeded`. Solo un pago `succeeded` confirma fondos; nunca confíes en la redirección del navegador.

Pruebas: tarjetas de prueba de Stripe o del sandbox de eCart Pay, gratis. En vivo: perfil verificado, suscripción activa y clave `sk_live_`.

## MCP
Las mismas operaciones existen como herramientas MCP en https://api.pagos.express/mcp/test (pruebas) y https://api.pagos.express/mcp (en vivo). Cada herramienta reentra al mismo handler `/v1`.