# Documentación de Lane

> API REST para cobrar en Colombia: links de pago, checkout, medios instantáneos, cobro recurrente y webhooks firmados. Con sandbox y llaves de prueba.

Una API para mover plata en Colombia. Creas un cobro, mandas al comprador a pagarlo y te avisamos cuando queda aprobado.

Lane expone un solo servicio HTTP con recursos en `/v1`. Hablas con él desde tu servidor con una llave secreta, y él se encarga del resto: la pantalla de pago, la comunicación con la red de tarjetas y el aviso de vuelta.

**Un cobro completo**

```bash
curl -X POST https://gxxazsplhgyezwxghrnn.supabase.co/functions/v1/blink-api/v1/payment_links \
  -H "Authorization: Bearer sk_test_…" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 11900000,
    "currency": "COP",
    "description": "Pedido #4821"
  }'
```

_Respuesta 201_

```json
{
  "id": "3f0c…",
  "object": "checkout.session",
  "environment": "test",
  "amount": 11900000,
  "currency": "COP",
  "status": "pending",
  "checkout_url": "https://lane.money/l/a7Kd2",
  "payment": { "id": "9b41…", "status": "pending" }
}
```

## Por dónde empezar

- [Tu primer cobro](https://lane.money/docs/empezar): De cero a un pago aprobado en sandbox, sin escribir una línea de código de tu lado.
- [Llaves y entornos](https://lane.money/docs/autenticacion): Cuál llave usar dónde, y por qué la secreta nunca sale del servidor.
- [Montos](https://lane.money/docs/montos): Todo va en centavos. Es el error de integración más común y el más caro.
- [Webhooks](https://lane.money/docs/webhooks): Cómo te avisamos que un cobro cambió de estado, y cómo verificas que fuimos nosotros.

## Las tres formas de cobrar por API

| Camino | Cuándo sirve | Qué le llega al comprador |
| --- | --- | --- |
| [Link de pago](https://lane.money/docs/guias/link-de-pago) | Ventas por WhatsApp, cotizaciones, cobros sueltos. | Una URL corta que abre la pantalla de pago. |
| [Checkout](https://lane.money/docs/guias/checkout) | Una tienda o una app que ya tiene carrito. | La misma pantalla, con vuelta automática a tu sitio. |
| [Tarjeta guardada](https://lane.money/docs/guias/cobro-recurrente) | Mensualidades, membresías, recompras con un clic. | Nada: el cobro sale de tu servidor contra una tarjeta ya autorizada. |

## Lo que no hay

Preferimos decirlo acá y no que lo descubras integrando. Hoy la API **no** tiene claves de idempotencia, ni reglas antifraude configurables (solo 3DS), ni consulta de liquidaciones: puedes ver cuándo un cobro quedó compensado por la red, pero no cuándo cae la plata en tu cuenta.

> **Nota: ¿Estás integrando con un asistente?.** Cada página de esta documentación existe también en markdown limpio: agrégale `.md` a la URL. El índice completo está en [/docs/llms.txt](https://lane.money/docs/llms.txt) y todo junto en un solo archivo en [/docs/llms-full.txt](https://lane.money/docs/llms-full.txt).