# API REST /v1

> Crea, comparte y consulta enlaces de pago con REST /v1. Importes MXN en centavos, claves sk_test_ / sk_live_, guías y referencia OpenAPI en /docs.

HTML: https://pagos.express/api
Texto para modelos: https://pagos.express/api.llms.txt

La API pública es REST `/v1` en https://api.pagos.express. Guías: https://pagos.express/docs. Referencia interactiva: https://pagos.express/docs/api. Contrato: https://api.pagos.express/openapi.json.

## Autenticación
`Authorization: Bearer <sk_test_…|sk_live_…>`. La clave selecciona cuenta y modo.

## Crear un enlace
`POST /v1/payment_links` con `Idempotency-Key`. Importes en centavos (`unitPriceCentavos`). MX$1,500.00 = 150000. La respuesta `url` es la página pública. Crear no cobra.

## Otras operaciones
Enlaces (listar, obtener, desactivar), pagos (listar, obtener, sync), correo del link, `GET /v1/connections`. Conectar Stripe es una acción del dashboard, no de la API.

## Relación con MCP
Cada herramienta MCP reentra al mismo handler `/v1`.

## FAQ

**¿Dónde está la referencia OpenAPI?**
Las guías viven en https://pagos.express/docs y la referencia interactiva en https://pagos.express/docs/api. El contrato publicable es https://api.pagos.express/openapi.json: solo operaciones /v1, un esquema de autenticación y las formas que esas rutas usan.

**¿Cómo se expresan los importes en MXN?**
En unidades menores enteras: centavos. MX$1,500.00 se envía como 150000. La moneda por defecto es MXN. No inventes impuestos ni totales; manda los conceptos que vas a cobrar.

**¿La API y el MCP hacen lo mismo?**
Sí. Cada herramienta MCP reentra al handler /v1 correspondiente. Misma autenticación por cuenta, mismo modo test/live, misma idempotencia.

**¿Puedo conectar Stripe por API?**
No. Conectar o reconectar el proveedor es una acción del propietario en el dashboard. La API solo lee GET /v1/connections para saber si hay una conexión activa.