URI bitcoin BIP21

Detto anche: URI bitcoin:, URI di pagamento Bitcoin, BIP 21, BIP21 bitcoin URI

Definizione

Un URI bitcoin BIP21 è un link che inizia con bitcoin: e contiene un indirizzo bitcoin più importo, etichetta e messaggio facoltativi, usato nei codici QR perché i portafogli possano precompilare un pagamento.

Che cosa definisce il BIP21

Il BIP21 è un Bitcoin Improvement Proposal, scritto nel 2012 da Nils Schneider e Matt Corallo, che definisce uno schema URI per i pagamenti in bitcoin. L'URI inizia con bitcoin:, seguito dall'indirizzo di ricezione e da parametri di query facoltativi. Quando un portafoglio scansiona un codice QR che contiene un URI di questo tipo, apre una schermata di invio con indirizzo e importo già compilati.

L'importo si scrive in bitcoin come numero decimale, non in unità più piccole. Per esempio, bitcoin:bc1q...?amount=0.001&label=Maple%20Street%20Bakery&message=Order%2042 richiede 0,001 BTC. I valori di testo in label e message sono codificati in percentuale.

  • amount: importo richiesto in BTC, come decimale
  • label: un nome per il destinatario
  • message: una nota che descrive il pagamento
  • I parametri con prefisso req- devono essere compresi dal portafoglio, altrimenti questo dovrebbe rifiutare l'URI

Usare il BIP21 nei codici QR

Un codice QR può contenere un semplice indirizzo oppure un URI BIP21 completo. L'URI è più utile per i pagamenti perché contiene importo e schema, così il telefono sa di dover aprire un portafoglio. Alcuni portafogli aggiungono anche parametri extra, come una fattura lightning, che sono convenzioni e non fanno parte del testo originale del BIP21, e non tutti i portafogli li leggono.

Controlla sempre l'indirizzo mostrato nel portafoglio prima di inviare. Le transazioni Bitcoin non si possono annullare, e un codice sovrapposto a uno vero può mandare i fondi a qualcun altro.

Domande frequenti

In che unità è l'importo in un codice QR bitcoin?

In un URI BIP21 il parametro amount è in bitcoin (BTC) come decimale, per esempio amount=0.001.

Un indirizzo bitcoin da solo basta per un codice QR?

Un semplice indirizzo funziona nella maggior parte dei portafogli, ma un URI bitcoin: può contenere anche l'importo e una nota e segnala che il codice è una richiesta di pagamento.

Fonti e standard

Tutti i termini