QR code

Bitcoin QR code icon

Contents

Most bitcoin wallets can read QR codes with additional parameters in BNF grammar above for the normative syntax. You can add amount, name, description and other parameters to your wallet. Some parameters may be changed, some cannot be understood or can be ignored by the wallet. Only the address and the amount will be stored in the bitcoin blockchain. Other parameters can or may be stored in your bitcoin wallet, it depends on the software.

Examples

Just the address:

bitcoin:1DonateWffyhwAjskoEwXt83pHZxhLTr8H

Address with amount (recomended to use):

bitcoin:1DonateWffyhwAjskoEwXt83pHZxhLTr8H?amount=0.00123

Request 20.30 BTC to "Luke-Jr":

bitcoin:1DonateWffyhwAjskoEwXt83pHZxhLTr8H?amount=20.3&label=Luke-Jr

Request 50 BTC with message:

bitcoin:1DonateWffyhwAjskoEwXt83pHZxhLTr8H?amount=50&label=Luke-Jr&message=Donation%20for%20project%20xyz

Some future version that has variables which are (currently) not understood and required and thus invalid:

bitcoin:1DonateWffyhwAjskoEwXt83pHZxhLTr8H?req-somethingyoudontunderstand=50&req-somethingelseyoudontget=999

Some future version that has variables which are (currently) not understood but not required and thus valid:

bitcoin:1DonateWffyhwAjskoEwXt83pHZxhLTr8H?somethingyoudontunderstand=50&somethingelseyoudontget=999

Request:

{size}
<width>x<height>
Image size
Example: 200x200
Required
{message}
urlencoded text,
=<256 chars
Message for QR code
Urlencoded message with any text.
Required

Playground and Code examples:


Format and Variables:
Parameter Experiment with a value
Message
Size, <width>x<height>
Reset Values Execute
Response from server:
{"message": "1", "qrcode": "empty"}