Guías

Medios instantáneos

Cuatro rieles que mueven la plata en el momento, sin tarjeta. Se piden con un solo campo.

Agrega payment_method al crear el cobro y la pantalla de pago cambia: en vez de pedir una tarjeta, pide únicamente lo que ese riel necesita.

Cobrar por PSE

curl -X POST https://api.lane.money/v1/checkout/sessions \
  -H "Authorization: Bearer sk_test_…" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 25000000,
    "currency": "COP",
    "payment_method": "pse",
    "description": "Pedido #4821",
    "success_url": "https://mitienda.com/gracias?pago={PAYMENT_ID}"
  }'

Respuesta 201

{
  "id": "3f0c8a1e-…",
  "object": "checkout.session",
  "amount": 25000000,
  "currency": "COP",
  "status": "pending",
  "checkout_url": "https://lane.money/pay/3f0c8a1e-…",
  "payment": { "id": "9b41d0c7-…", "status": "pending" }
}

Cómo paga el comprador con cada uno

Valor	Qué hace el comprador	Cómo te enteras
`pse`	Se autentica en el portal de su banco.	Por el webhook.
`nequi`	Aprueba una notificación en la app de Nequi.	Por el webhook. Puede tardar hasta 45 minutos.
`daviplata`	Escribe un código que le llega por SMS.	Por el webhook. El código vale 15 minutos.
`breb`	Escanea un QR o usa su llave desde cualquier app bancaria.	Por el webhook. El QR vale 15 minutos.

Cómo vuelve el comprador a tu sitio

Cuando el pago se aprueba, la página muestra la confirmación unos segundos y lleva al comprador sola a tu success_url, con los parámetros que le hayas puesto y con {PAYMENT_ID} y {CHECKOUT_SESSION_ID} ya reemplazados. Si el pago se rechaza, se cancela o vence, la página no redirige: muestra qué pasó y un botón para volver a tu cancel_url. Sin esas direcciones, se queda en su pantalla de resultado.

Vale para los cuatro medios. En PSE el banco devuelve al comprador a la página de Lane, no a tu sitio: es ella la que espera el resultado y lo manda a success_url, así que quien canceló en el banco no llega a tu página de «pagado». Aun así, que el comprador llegue ahí no es la prueba del pago: la prueba es el webhook.

Un cobro, un medio. Cada cobro usa un solo riel: checkout_url apunta a una pantalla que pide únicamente los datos de ese medio. Para ofrecerle varias opciones al comprador, crea una sesión por medio y deja que él elija en tu sitio antes de mandarlo a pagar.

Topes de red

Los pone cada red, no Lane. Se validan antes de crear el cobro, así que un monto fuera de rango devuelve 422 con un mensaje que dice cuál es el límite — el comprador no llega a descubrirlo cuando ya se decidió a pagar.

Medio	Mínimo	Máximo
`pse`	—	Sin tope de red
`nequi`	—	$ 12.000.000 COP
`daviplata`	—	$ 3.000.000 COP
`breb`	$ 1.000 COP	—

Nequi además aplica un tope mensual por persona que no podemos consultar: un cobro dentro del tope por transacción puede fallar igual si el comprador ya agotó su cupo del mes.

Solo los medios que tu comercio tiene

Cada medio se habilita por comercio y por modo. Al activarse un comercio, y otra vez al quedar aprobado para cobros reales, Lane pide los cuatro para él. Si creas un cobro con un medio que tu comercio no tiene habilitado, la API responde 422 con code: payment_method_unavailable, y details dice cuáles sí tiene: te enteras al crear el cobro, no cuando el comprador intenta pagar.

No se devuelven

Irrevocables. Estos rieles mueven la plata en el momento y no admiten refund ni cancel por la API. Para devolverle el dinero a un comprador tienes que hacer una transferencia aparte. Si vendes algo con devolución frecuente, la tarjeta te va a dar menos trabajo.

Y tampoco hay cuotas

Las cuotas son un producto de la tarjeta de crédito. Ningún medio instantáneo las admite: si necesitas ofrecerlas, el cobro tiene que ir por tarjeta. Ver Cuotas.

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