← Glossary

Wallet basics

What Is a Payment URI? How bitcoin: Links and QR Codes Work

A payment URI is a link of the form bitcoin:<address>?amount=<value> defined in BIP-21 that bundles an address with an optional amount, label and message, so a wallet can pre-fill a payment from a tap or QR scan.

Key takeaways

What it looks like

BIP-21 defines a URI scheme for Bitcoin payments. The simplest form is the scheme name, a colon and an address. Extra parameters follow a question mark, for example an amount in bitcoin units, a label naming the recipient and a message describing the payment. Opening such a link in a compatible wallet, or scanning a QR code that encodes it, fills in the payment form for you.

Why it exists

Typing a long address and amount is error-prone. A payment URI lets a merchant, an invoice or a friend hand you everything in one tap. QR codes shown at checkouts and on invoices almost always encode this format, and payment buttons on websites use it to open your wallet app.

Other coins

The same convention is used by many Bitcoin-derived coins, each with its own scheme name, such as litecoin: for Litecoin. A wallet registers for the schemes it supports and ignores the rest. The details can differ by coin and wallet, so a URI from one coin should only be opened in a wallet for that coin.

Staying safe

A link or QR code can contain any address and amount an attacker chooses, so the convenience is also an opportunity for fraud. After scanning, read the address and amount on the confirmation screen and compare them with what you expect. Be cautious with QR codes in public places that could be stickers placed over real ones. If anything looks different from what you were told, cancel and ask again through a channel you trust.

Example

An invoice shows a QR code encoding bitcoin:bc1qexample...?amount=0.015&label=Invoice%2042. Scanning it opens your wallet with the address, amount and label already filled in, ready for you to review and confirm.

Put it into practice

Check every field before you send

Scrypt Wallet lets you pay to addresses you paste or scan. Read the address and amount on the confirmation screen and save trusted recipients as contacts.

Create a free wallet Get Scrypt for Android

Sources and verification

Last reviewed 2026-10-02 by the Scrypt Wallet team. The factual claims on this page, and where each comes from:

  1. BIP-21 defines the bitcoin: URI scheme with optional amount, label and message parameters. [1]
  2. BIP-21 amounts are expressed in bitcoin units as decimal values. [1]

Sources

  1. BIP-21: URI scheme · bitcoin/bips on GitHub · primary source

Primary sources are protocol papers, specifications, source code or a project's own documentation; secondary sources are wikis and explainers. We checked each claim against the source text on the review date. Found an error? Tell us and we will correct it.

Frequently asked questions

Is the amount in satoshis?

In BIP-21 the amount is given in bitcoin units as a decimal, not in satoshis.

Can a QR code be malicious?

It can point to an attacker's address. Always verify the address and amount shown by your wallet before sending.

Do all coins use the same format?

Many Bitcoin-derived coins follow the same pattern with their own scheme name, but wallet support varies.

Related terms

Go deeper

Written by the Scrypt Wallet team · Updated 2026-10-02. General education, not financial, tax or legal advice.