BIP21 比特币 URI

又称: bitcoin: URI, 比特币支付 URI, BIP 21, 比特币支付链接

定义

BIP21 比特币 URI 是以 bitcoin: 开头的链接,包含比特币地址以及可选的金额、标签和消息,用在二维码中,让钱包能预填一笔支付。

BIP21 定义了什么

BIP21 是一项比特币改进提案,由尼尔斯·施耐德(Nils Schneider)和马特·科拉罗(Matt Corallo)于 2012 年撰写,定义了比特币支付的 URI 方案。该 URI 以 bitcoin: 开头,后面是收款地址和可选的查询参数。钱包扫描含有这种 URI 的二维码后,会打开发送页面,地址和金额都已填好。

金额以比特币为单位,写成十进制数,而不是用更小的单位。例如,bitcoin:bc1q...?amount=0.001&label=Maple%20Street%20Bakery&message=Order%2042 请求 0.001 BTC。label 和 message 中的文本值要做百分号编码。

  • amount:请求的金额,以 BTC 计,十进制
  • label:收款方的名称
  • message:描述这笔支付的备注
  • 以 req- 为前缀的参数必须被钱包理解,否则钱包应拒绝该 URI

在二维码中使用 BIP21

二维码里既可以放一个单纯的地址,也可以放完整的 BIP21 URI。URI 对支付更有用,因为它带有金额和协议头,手机就知道该打开钱包。有些钱包还会加入额外参数,比如闪电网络发票,这些属于约定,而不是 BIP21 原文的一部分,并非每个钱包都能读取。

发送之前,务必核对钱包里显示的地址。比特币交易无法撤销,盖在真码上的假码可能把资金发给别人。

常见问题

比特币二维码里的金额用什么单位?

在 BIP21 URI 中,amount 参数以比特币(BTC)为单位,用十进制表示,例如 amount=0.001。

二维码里只放比特币地址就够了吗?

单纯的地址在大多数钱包里可用,但 bitcoin: URI 还可以携带金额和备注,并表明这个码是一个收款请求。

来源与标准

全部术语