Bitcoin payment URI (bitcoin:)

ID bitcoin_uri

DatatypeNot PIIidentifierDraft

This record is a draft: it has not been reviewed yet and may be incomplete or wrong. Do not rely on it for compliance decisions. Help improve it (see CONTRIBUTING.md).

URI of the bitcoin: scheme that wallets open from links and QR codes to start a payment (BIP 321, which replaces BIP 21). It holds an address and query parameters such as amount (in BTC), label, message, lightning (a BOLT 11 invoice) or further addresses. The scheme and the parameter names are case-insensitive, and QR codes often use upper case. The address part may be empty when the parameters carry the payment instructions.

Parent datatype: Uniform Resource Identifier (URI) uri
Categories: Cryptocurrency, Internet
Countries: Global (not tied to a country)
Languages: Common to most languages
Quality: 80/100 · missing: mapping (Wikidata, Schema.org, ...), detector coverage
Metacrafter rules: no detection rule yet
Supported by tools: no tool record lists this type yet

Regular expression

^[Bb][Ii][Tt][Cc][Oo][Ii][Nn]:(?:[0-9A-Za-z]+(?:\?\S+)?|\?\S+)$

Python re syntax.

Examples

Value	Description
bitcoin:175tWpb8K1S7NmH4Zx6rewF9WQrcZv245W?amount=20.3&label=Luke-Jr	Example of BIP 21 and BIP 321 (the address in it is illustrative and fails Base58Check)
BITCOIN:BC1QUFGY354J3KMVUCH987XE4S40836X3H0LG8F5NQ?BC=BC1P5SWKUGEZN97763TL0YTY6556856UUG0Q6JFLLJVEP9M4P7339X5QZYRH4Q	Upper-case example of BIP 321 for QR codes (illustrative addresses)
bitcoincash:qpm2qsznhks23z7629mms6s4cwef74vcwvy22gdx6a invalid	Bitcoin Cash address (bitcoin_cash_address)

Translations

Language	Name	Description
Russian	Платёжный URI Bitcoin (bitcoin:)

Sources

Use this record

Page URL: http://registry.apicrafter.io/datatype/bitcoin_uri
JSON: API v1 · legacy shape (used by metacrafter) · Markdown (for LLMs)
Improve it: edit data/datatypes/any/cryptocurrency/bitcoin_uri.yaml on GitHub