Bitcoin QR code: how it works and how to use it safely

By · · Updated · 5 min read
Bitcoin QR code for receiving crypto with a wallet address
In short: A Bitcoin QR code contains a wallet address, often as a BIP21 link (bitcoin:address?amount=…) that also prefills the amount and a label. The payer scans it with a wallet app and confirms. It only holds your public receiving address, never your keys. Verify the address after scanning and never encode a seed phrase or private key.

Typing a 42-character crypto address by hand is slow and risky: one wrong character and the funds are gone. That is why wallets display a Bitcoin QR code when you tap "Receive". This guide explains what is inside that code, how to create your own for an invoice, a shop counter or a donation page, and the safety checks that matter most.

This article is general technical information, not investment or financial advice. Crypto assets are volatile and transactions are usually irreversible; follow the rules that apply in your country and the instructions of your wallet provider.

What does a Bitcoin QR code contain?

There are two common forms:

  • A plain address, for example a string starting with bc1, 1 or 3. Scanning it fills the recipient field in the wallet; the payer types the amount.
  • A BIP21 payment URI, defined in the Bitcoin Improvement Proposal 21. It looks like bitcoin:ADDRESS?amount=0.0015&label=Shop%20Name&message=Invoice%20123. Wallets that support it prefill the address, the amount (in BTC) and a description.

Other networks have their own formats. Ethereum uses an ethereum: URI described in EIP-681, and Lightning Network invoices are long strings starting with lnbc that usually expire after a set time. The free crypto QR code generator builds these formats for you so the address and amount arrive in the payer's wallet correctly.

Bitcoin address types at a glance

Starts withTypeNotes
1Legacy (P2PKH)Oldest format, higher fees, widely supported
3Script (P2SH)Often used for multisig and wrapped SegWit
bc1qNative SegWit (Bech32)Lower fees, case-insensitive, common default
bc1pTaproot (Bech32m)Newest format; check the payer's wallet supports it
lnbc…Lightning invoiceOff-chain, fast, usually time-limited

Bech32 addresses (bc1…) have a nice property for QR codes: they can be written in uppercase, which allows the more compact alphanumeric encoding mode and a simpler code.

Bitcoin QR code created with the QRCode.boats crypto QR generator
A crypto QR code holds your public receiving address and, optionally, an amount.

How to create a Bitcoin QR code

  1. Open your wallet and tap Receive. Copy the address shown. Check which network it is for (Bitcoin on-chain, Lightning, another chain).
  2. Open the generator. Go to the Bitcoin QR code generator and choose the coin.
  3. Paste the address and, if you want, enter an amount and a label such as your shop name or invoice number.
  4. Check the preview. Scan the code with your own wallet app (without sending) and compare the first and last six characters of the address with your wallet.
  5. Download and print it on your invoice, counter sign or website. Add the coin name and your business name next to it.

Safety rules you should never break

  • Never encode a private key or a seed phrase (recovery words) in any QR code generator. A receiving QR code only needs your public address. Anyone who sees a private key can take your funds.
  • Verify the address after pasting. Some malware replaces crypto addresses in the clipboard with the attacker's address. Compare the beginning and the end of the address every time.
  • Protect printed codes. On a donation poster or a counter, a fraudster can stick their own code on top. Inspect public codes regularly.
  • Use the right network. Sending a token on the wrong chain can make funds unrecoverable. Write the network name next to the code.
  • Test with a small amount before publishing a code on high-value invoices.

Our guide are QR codes safe? covers QR scams in general, including swapped payment codes.

Static code with or without an amount?

A code without an amount is reusable: print it once for donations or tips. A code with an amount is best for a specific invoice; create a new one per invoice. Remember that many wallets recommend using a new receiving address for each payment for privacy reasons, because a reused address lets anyone link your incoming transactions on the public blockchain. Your wallet can generate fresh addresses whenever you need them.

Where Bitcoin QR codes are used

  • Invoices for freelancers and agencies that accept crypto: one code per invoice with the exact amount and invoice number in the label.
  • Donation pages and posters for open-source projects, creators and associations: a reusable code without an amount.
  • Shop counters and events that accept crypto alongside cards: a printed code, ideally generated per sale by a point-of-sale app for exact amounts.
  • Moving funds between your own wallets: scanning the receiving code of your other wallet avoids copy-paste errors.

Common mistakes with crypto QR codes

  1. Using an exchange deposit address for public donations. Some exchange addresses change or are tied to specific rules; check your provider's conditions before publishing one.
  2. Mixing networks. A code for a token on one chain shown next to the logo of another causes lost payments. Label clearly.
  3. Printing a huge, dense code. Long URIs with messages create dense codes. Keep the label short and print large enough.
  4. Not checking that the code still matches the wallet after a wallet migration or restore. Re-scan your printed codes whenever you change wallets.
  5. Posting a screenshot of a QR code that contains more than the address, such as a wallet backup. Only receiving codes should ever be shared.

How the payer uses the code

  1. Open the wallet app and tap Send or the scan icon.
  2. Scan the QR code; the address (and amount, if included) is filled in.
  3. Check the recipient, the amount and the network fee.
  4. Confirm with the wallet's authentication.

Phone camera apps may recognize the bitcoin: link and offer to open a wallet, but scanning directly inside the wallet is the most reliable method.

  • Keep the code dark on white with a clear margin; addresses are long, so print at least 3 × 3 cm.
  • Avoid adding a logo to crypto codes: a misread must never be possible, so keep them as clean as possible.
  • Print the full address in small text below the code so payers can double-check.
  • For non-crypto customers, offer a classic option as well, such as a payment QR code for PayPal.me or SEPA.

Key takeaways

  • A Bitcoin QR code holds a public address, optionally as a BIP21 link with amount and label.
  • Never put a private key or seed phrase in a QR code generator.
  • Verify the first and last characters after pasting and after scanning.
  • Label the coin and network, protect printed codes, and test with a small amount.

The BIP21 format is documented in the official Bitcoin Improvement Proposals repository. For how other payment codes work, read how QR code payments work.

Create a clean crypto QR code with address, amount and label: free.

Crypto and Bitcoin QR code generatorCheck a crypto QR code before paying

Frequently asked questions

Is it safe to share my Bitcoin QR code?

Sharing a receiving QR code is as safe as sharing your public address: people can send you funds and, because the blockchain is public, see transactions to that address. It does not give access to your funds. For privacy, many wallets suggest using a fresh receiving address for each payment.

Can I put an amount in a Bitcoin QR code?

Yes. A BIP21 payment link can include an amount in BTC, plus a label and a message. Most modern wallets read it and prefill the amount, which the payer can still review before confirming. For invoices, create a new code with the exact amount and the invoice number in the label.

Does a crypto QR code work for Ethereum and other coins?

Yes, but each network has its own address format and URI scheme. Ethereum uses an ethereum: link, and tokens may need extra parameters. Always state the coin and the network next to the code, because sending a token on the wrong chain may make it unrecoverable.

Why does my Lightning QR code stop working?

Lightning invoices usually include an expiry time set by the wallet that created them, after which they can no longer be paid. That is a rule of the invoice, not of the QR code. For a reusable Lightning code, use a static option supported by your wallet, such as a Lightning address or LNURL, if available.

QRCode.boats Editorial Team — QR code & barcode tool makers. Written by the team that builds and maintains the free QR code and barcode generators on QRCode.boats.

Related guides