BIP21 bitcoin-URI

Kaldes også: bitcoin:-URI, Bitcoin-betalings-URI, BIP 21

Definition

En BIP21 bitcoin-URI er et link, der begynder med bitcoin: og rummer en bitcoin-adresse samt valgfrit beløb, mærkat og besked, brugt i QR-koder, så wallets kan udfylde en betaling på forhånd.

Hvad BIP21 definerer

BIP21 er et Bitcoin Improvement Proposal, skrevet i 2012 af Nils Schneider og Matt Corallo, der definerer et URI-skema til bitcoin-betalinger. URI'en begynder med bitcoin:, efterfulgt af modtageradressen og valgfrie forespørgselsparametre. Når en wallet scanner en QR-kode med sådan en URI, åbner den en sendeskærm med adressen og beløbet allerede udfyldt.

Beløbet skrives i bitcoin som et decimaltal, ikke i mindre enheder. For eksempel beder bitcoin:bc1q...?amount=0.001&label=Maple%20Street%20Bakery&message=Order%2042 om 0,001 BTC. Tekstværdier i label og message er procentkodede.

  • amount: det anmodede beløb i BTC, som decimaltal
  • label: et navn på modtageren
  • message: en note, der beskriver betalingen
  • Parametre med præfikset req- skal forstås af wallet'en, ellers bør den afvise URI'en

BIP21 i QR-koder

En QR-kode kan rumme enten en ren adresse eller en fuld BIP21-URI. URI'en er mere nyttig til betalinger, fordi den bærer beløbet og skemaet, så telefonen ved, at den skal åbne en wallet. Nogle wallets tilføjer også ekstra parametre, såsom en lightning-faktura, som er konventioner og ikke en del af den oprindelige BIP21-tekst, og ikke alle wallets læser dem.

Tjek altid den adresse, der vises i wallet'en, før du sender. Bitcoin-transaktioner kan ikke fortrydes, og en kode klistret over en ægte kan sende penge til en anden.

Ofte stillede spørgsmål

Hvilken enhed er beløbet i en bitcoin-QR-kode?

I en BIP21-URI er amount-parameteren i bitcoin (BTC) som et decimaltal, for eksempel amount=0.001.

Er en bitcoin-adresse alene nok til en QR-kode?

En ren adresse virker i de fleste wallets, men en bitcoin:-URI kan også bære beløbet og en note og signalerer, at koden er en betalingsanmodning.

Kilder og standarder

Alle begreber