# Medios instantáneos

> 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.

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**

```bash
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_

```json
{
  "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. |

> **Cuidado: 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

> **Importante: 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](https://lane.money/docs/guias/cuotas).
