Empezar

Documentación de Lane

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

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

{
  "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: De cero a un pago aprobado en sandbox, sin escribir una línea de código de tu lado.
Llaves y entornos: Cuál llave usar dónde, y por qué la secreta nunca sale del servidor.
Montos: Todo va en centavos. Es el error de integración más común y el más caro.
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	Ventas por WhatsApp, cotizaciones, cobros sueltos.	Una URL corta que abre la pantalla de pago.
Checkout	Una tienda o una app que ya tiene carrito.	La misma pantalla, con vuelta automática a tu sitio.
Tarjeta guardada	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.

¿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 y todo junto en un solo archivo en /docs/llms-full.txt.

Esta página en markdown: /docs/index.md · Toda la documentación: /docs/llms-full.txt