Skip to main content

Código QR | Bitcoin Glossary | Mapping Bitcoin

Código QR

General

Also known as: quick response code

Código de barras bidimensional para codificar direcciones Bitcoin, facturas Lightning o URIs de pago. Permite escanear con cámara del teléfono fácilmente.

Visión general

Los códigos QR se han convertido en una parte esencial de la experiencia de usuario de Bitcoin. Las direcciones Bitcoin, las facturas Lightning y los URIs de pago son largas cadenas de caracteres que son impracticamente largas para escribir manualmente. Los códigos QR resuelven esto codificando la información de pago en un código de barras bidimensional escaneable, lo que permite transferencias rápidas y sin errores entre dispositivos. Casi todas las billeteras Bitcoin soportan tanto la generación como el escaneo de códigos QR.

Códigos QR en pagos Bitcoin

Flujo de pago con Código QR:

┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│  Destinatario│     │  Código QR   │     │  Remitente   │
│  genera      │────>│  mostrado    │────>│  escanea QR  │
│  factura     │     │  en pantalla │     │  con teléfono│
└──────────────┘     └──────────────┘     └──────┬───────┘
                                                  │
                                           ┌──────▼───────┐
                                           │  Billetera   │
                                           │  analiza y   │
                                           │  confirma    │
                                           │  el pago     │
                                           └──────────────┘

Contenidos QR comunes:
• bitcoin:bc1q...?amount=0.001    (URI BIP21)
• lnbc10u1p...                    (Factura Lightning)
• lnurl1dp68...                   (Endpoint LNURL)

URIs de pago BIP21

El estándar BIP21 define un esquema URI que los códigos QR típicamente codifican para pagos en cadena. Un URI BIP21 puede incluir la dirección, un monto solicitado, una etiqueta y un mensaje. Las implementaciones modernas también pueden incluir una factura Lightning como parámetro de respaldo, permitiendo a la billetera del remitente elegir el método de pago más apropiado.

Capacidad del código QR

Los códigos QR vienen en diferentes tamaños (versiones) con capacidades de datos variables. Una dirección Bitcoin estándar cabe fácilmente en un código QR pequeño, pero las facturas Lightning pueden ser bastante largas (cientos de caracteres), requiriendo códigos QR más grandes. LNURL aborda esto codificando una URL corta que se resuelve en la factura completa, manteniendo los códigos QR compactos y fácilmente escaneables.

Consideraciones de seguridad

Aunque los códigos QR en sí mismos son simplemente un formato de codificación de datos y no conllevan ningún riesgo de seguridad inherente, los usuarios deben tener cuidado con:

  • Ataques de reemplazo de código QR — El software malicioso podría reemplazar un código QR mostrado con la dirección del atacante. Siempre verifica los primeros y últimos caracteres de una dirección antes de enviar.
  • Códigos QR de phishing — Los códigos QR publicados en lugares públicos podrían enlazar a sitios web maliciosos o codificar direcciones controladas por el atacante.

En puntos de venta

Los códigos QR son fundamentales para los pagos Bitcoin en puntos de venta. El sistema POS del comerciante genera una factura, la muestra como un código QR y el cliente la escanea con su billetera móvil. En Lightning, todo el proceso desde el escaneo hasta el pago confirmado típicamente toma solo unos segundos.