## ¿Qué es L402?

L402 (anteriormente LSAT) usa la Lightning Network de Bitcoin para pagos instantáneos de API. El servidor emite un macaroon (un token portador) emparejado con una factura Lightning — una vez que el agente paga la factura, el macaroon se vuelve válido.

## Cómo funciona

1. El agente envía una solicitud a un endpoint de pago
2. El servidor devuelve **HTTP 402** con `WWW-Authenticate: L402 macaroon="...", invoice="..."`
3. El agente paga la factura Lightning
4. El agente reintenta con el macaroon pagado como prueba (`Authorization: L402 macaroon:preimage`)
5. El servidor verifica el macaroon y responde

## Conceptos clave

- **Macaroon**: Un token portador criptográfico que se vuelve válido una vez que su factura emparejada es pagada
- **Factura Lightning**: Una solicitud de pago BOLT11 de un solo uso en la Lightning Network de Bitcoin
- **Preimage**: La prueba de pago revelada cuando una factura Lightning se liquida
- **Liquidación instantánea**: Los pagos Lightning se confirman en milisegundos
- **Nativo de Bitcoin**: Los pagos son en satoshis (1 sat = 0.00000001 BTC)

## Cómo agregar L402 a tu servicio

1. Ejecuta un nodo Lightning (LND, CLN) o usa un Lightning Service Provider
2. Por cada solicitud de pago, genera un par de macaroon + factura Lightning
3. Devuelve 402 con `WWW-Authenticate: L402 macaroon="<base64>", invoice="<bolt11>"`
4. En el reintento, verifica el macaroon y comprueba el preimage de la factura

## Madurez de la especificación

**Establecido.** Originalmente desarrollado por Lightning Labs como LSAT, renombrado a L402. Usado en producción por múltiples APIs basadas en Lightning.

## Más información

- [Especificación de L402](https://docs.lightning.engineering/the-lightning-network/l402) — Documentación de Lightning Labs
- [Aperture](https://github.com/lightninglabs/aperture) — Proxy inverso L402 de Lightning Labs

## Relacionado

- [OpenAPI](/kb/es/openapi)