What can a Bitcoin QR code contain?
It may contain a plain address or a bitcoin: payment URI with an amount and other instructions. Current BIP 321 describes modern payment URIs, including optional alternative payment instructions. The older BIP 21 specification is explicitly superseded. Wallet implementation and support still vary.
A QR can also contain an unrelated website or another network’s request. A familiar logo printed beside it does not authenticate the decoded contents. Before opening a link or payment request, consider whether you expected it and whether the application is the one you intended to use.
An annotated, nonpayable payment request
Scroll across the table to see all columns.
| Illustrative component | Meaning | What still needs checking |
|---|---|---|
| bitcoin:<ADDRESS> | The placeholder would be a supported on-chain destination | Not a working address in this example |
| amount=0.00050000 | An amount expressed in BTC | Equals 50,000 satoshis; not a dollar amount |
| label=Example | A human-readable label | A label is not verified merchant identity |
| Alternative payment instruction | May request another supported payment mechanism | Check what route the wallet actually selects |
Why is the QR code not working?
Check whether your wallet’s scanner accepts that type of request. A camera can read the image while a payment app rejects its contents. An expired Lightning invoice, unsupported URI option, wrong network or damaged image can require a different response.
Use the receiver’s genuine app or invoice to request a fresh, supported format. If the form wants only an address, use the receiver’s own address-only copy control and preserve any separately required amount. Do not send funds using a reconstructed request if doing so would discard the merchant’s instructions.
Compare before you authorize
Example: your expected invoice says 50,000 satoshis, but the wallet preview shows 500,000. Stop. Recheck the request and units through the known recipient rather than assuming the scanner made a harmless display change. The destination also needs checking, not just the amount.
Compare the complete destination using the wallet’s trusted display where available. Avoid relying on a few matching beginning and ending characters. Clipboard replacement and a substituted printed QR can lead to a different recipient even when the request looks professional.
What if someone sends you to a Bitcoin ATM?
The CFTC warns about scammers directing people to crypto ATMs using supplied addresses or QR codes. A supplied QR can route the purchase to the scammer’s wallet. Stop and independently contact the institution through a known channel.
If money was already sent, save the receipt and contact the actual operator promptly. Reporting and refund rights depend on the facts and applicable rules; do not pay another person a recovery fee. The ATM receipt and refund guide explains which evidence to keep. For normal receiving, start with finding your wallet address.
Sources & further reading
These sources explain the payment systems and rules discussed in this guide. For your purchase, check the provider’s current offer and terms.
- BIP 321: Current Bitcoin payment URI specification
- BIP 21: Superseded payment URI specification
- CFTC: Unusual payment instructions and ATM scam warning
Published by Fiat2Bitcoin. Worked examples use fictional figures and records; they are not current prices or customer transactions. How we prepare our guides.




