# Documentación de Lane

> API REST para cobrar en Colombia: links de pago, checkout, medios instantáneos
> (PSE, Nequi, Daviplata, Bre-B), cobro recurrente con tarjeta guardada y webhooks
> firmados. Los montos van en centavos como enteros, la autenticación es una llave
> secreta `sk_` por Bearer, y el entorno —sandbox o producción— lo decide la llave.

Base de la API: `https://gxxazsplhgyezwxghrnn.supabase.co/functions/v1/blink-api`

Cada enlace de esta lista apunta al markdown de la página. La versión navegable
está en https://lane.money/docs, y todo junto en un solo archivo en
https://lane.money/docs/llms-full.txt.

## Empezar

- [Documentación de Lane](https://lane.money/docs/index.md): API REST para cobrar en Colombia: links de pago, checkout, medios instantáneos, cobro recurrente y webhooks firmados. Con sandbox y llaves de prueba.
- [Tu primer cobro](https://lane.money/docs/empezar.md): Crea una llave de prueba, genera un link de pago y págalo en sandbox. El camino más corto para ver la API funcionando de punta a punta.
- [Llaves y entornos](https://lane.money/docs/autenticacion.md): Cómo autenticar contra la API de Lane con llaves secretas, qué diferencia hay entre sandbox y producción, y qué hacer si una llave se filtra.
- [Montos y monedas](https://lane.money/docs/montos.md): Los montos de la API de Lane van en centavos, como enteros. Tabla de conversión, moneda por defecto y los topes por medio de pago.

## Conceptos

- [El recorrido de un cobro](https://lane.money/docs/estados.md): Los siete estados por los que pasa un pago en Lane: pending, authorized, processing, succeeded, failed, cancelled y refunded. Cuál es final y cuál no.
- [Errores](https://lane.money/docs/errores.md): Los códigos HTTP que devuelve la API de Lane, qué significa cada uno y cuáles conviene reintentar.

## Guías

- [Cobrar con un link de pago](https://lane.money/docs/guias/link-de-pago.md): Crea una URL de pago con la API de Lane, con vencimiento, cupo de usos y QR. La forma más corta de cobrar sin tener tienda online.
- [Checkout en tu tienda](https://lane.money/docs/guias/checkout.md): Integra el cobro en el carrito de tu tienda: crea una sesión de checkout, manda al comprador a pagar y recíbelo de vuelta en tu sitio.
- [Medios instantáneos](https://lane.money/docs/guias/medios-instantaneos.md): Cobra con PSE, Nequi, Daviplata o Bre-B desde la API de Lane. Cómo paga el comprador con cada uno, los topes de red y por qué no admiten reembolso.
- [Cobrar a cuotas](https://lane.money/docs/guias/cuotas.md): Cómo ofrecer pago a cuotas con tarjeta de crédito en Lane: abrir la opción en el checkout, fijar la cantidad en un cobro directo y verificar el BIN antes.
- [Cobro con tarjeta guardada](https://lane.money/docs/guias/cobro-recurrente.md): Guarda una tarjeta con una sesión de inscripción y cóbrala después sin el cliente presente: el flujo CIT/MIT para mensualidades y recompras en Lane.

## Referencia

- [Convenciones de la API](https://lane.money/docs/api/paginacion.md): Cómo se ven los listados, cómo se pagina con cursor y qué campos comparten todos los objetos de la API de Lane.
- [Cobros](https://lane.money/docs/api/cobros.md): Referencia del recurso payments de Lane: crear un cobro con tarjeta guardada, consultarlo, listarlo, capturar, anular, ajustar y reembolsar.
- [Sesiones y links](https://lane.money/docs/api/sesiones.md): Referencia de las sesiones de checkout, los links de pago y las sesiones de inscripción de tarjeta en la API de Lane.
- [Instrumentos](https://lane.money/docs/api/instrumentos.md): Las tarjetas guardadas de tus clientes en Lane: cómo listarlas, qué trae cada una y cómo saber si admite cuotas.
- [Clientes](https://lane.money/docs/api/clientes.md): Los compradores que han pagado a tu comercio: cómo listarlos, buscarlos por correo y ver todo lo que tienen asociado.
- [Disputas](https://lane.money/docs/api/disputas.md): Los contracargos abiertos contra tu comercio: cómo listarlos, filtrar los que necesitan respuesta y hasta cuándo tienes para responder.
- [Suscripciones](https://lane.money/docs/api/suscripciones.md): Consulta las suscripciones activas de tu comercio en Lane, su ciclo actual y cuándo sale el próximo cobro.
- [Comercios](https://lane.money/docs/api/comercios.md): Los comercios de tu cuenta en Lane: cómo listarlos, consultar uno y actualizar sus datos.

## Plataforma

- [Webhooks](https://lane.money/docs/webhooks.md): Recibe los cambios de estado de tus cobros en tu servidor: catálogo de eventos de Lane, cómo verificar la firma HMAC y cómo funcionan los reintentos.
- [Sandbox](https://lane.money/docs/sandbox.md): El entorno de pruebas de Lane: tarjetas de prueba, qué se puede probar sin plata real y qué diferencias tiene con producción.
- [Servidor MCP](https://lane.money/docs/mcp.md): El servidor MCP de Lane deja que un asistente como Claude o Cursor consulte y cree cobros por ti. En construcción, con la lista de espera abierta.