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://gxxazsplhgyezwxghrnn.supabase.co/functions/v1/blink-api/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.	Vuelve a tu sitio, y además llega el webhook.
`nequi`	Aprueba una notificación en la app de Nequi.	Solo webhook. Puede tardar hasta 45 minutos.
`daviplata`	Escribe un código que le llega por SMS.	Solo webhook. El código vale 15 minutos.
`breb`	Escanea un QR o usa su llave desde cualquier app bancaria.	Solo webhook. El QR vale 15 minutos.

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.

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