L402 — Pagos Lightning
¿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
- El agente envía una solicitud a un endpoint de pago
- El servidor devuelve HTTP 402 con
WWW-Authenticate: L402 macaroon="...", invoice="..." - El agente paga la factura Lightning
- El agente reintenta con el macaroon pagado como prueba (
Authorization: L402 macaroon:preimage) - 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
- Ejecuta un nodo Lightning (LND, CLN) o usa un Lightning Service Provider
- Por cada solicitud de pago, genera un par de macaroon + factura Lightning
- Devuelve 402 con
WWW-Authenticate: L402 macaroon="<base64>", invoice="<bolt11>" - 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 — Documentación de Lightning Labs
- Aperture — Proxy inverso L402 de Lightning Labs