Qué define BIP21
BIP21 es una propuesta de mejora de Bitcoin (Bitcoin Improvement Proposal), escrita en 2012 por Nils Schneider y Matt Corallo, que define un esquema de URI para pagos en bitcoin. La URI empieza por bitcoin:, seguido de la dirección receptora y de parámetros de consulta opcionales. Cuando una cartera escanea un código QR que contiene una URI así, abre una pantalla de envío con la dirección y el importe ya rellenados.
El importe se escribe en bitcoin como un número decimal, no en unidades más pequeñas. Por ejemplo, bitcoin:bc1q...?amount=0.001&label=Maple%20Street%20Bakery&message=Order%2042 pide 0.001 BTC. Los valores de texto de label y message se codifican con porcentajes.
- amount: importe solicitado en BTC, como decimal
- label: un nombre para el destinatario
- message: una nota que describe el pago
- Los parámetros con el prefijo req- deben ser entendidos por la cartera, o esta debe rechazar la URI
Usar BIP21 en códigos QR
Un código QR puede contener una dirección sin más o una URI BIP21 completa. La URI es más útil para los pagos porque lleva el importe y el esquema, de modo que el móvil sabe que debe abrir una cartera. Algunas carteras añaden además parámetros extra, como una factura de lightning, que son convenciones y no forman parte del texto original de BIP21, y no todas las carteras los leen.
Comprueba siempre la dirección que muestra la cartera antes de enviar. Las transacciones de Bitcoin no se pueden revertir, y un código colocado sobre uno auténtico puede enviar fondos a otra persona.