编号: BSP-0001
标题: 收款码标准
层级: 应用层
类型: 标准协议
状态: 草稿
编辑: 陈鲁勇 <louie@bepal.pro>
创建时间: 2018-09-28
该方案用于进行币种支付的URI方案。
根据URI RFC3986标准，规定的URI的一般格式。使用UTF-8字符集来表示。
此URI方案的目的是使用户只需单击网页上的链接或扫描QR码即可轻松进行付款。
- 根据币种，生成文本格式的收款参数字符串
- 将文本字符串进行URLEncoder，编码格式选择UTF-8
- URLEncoder后的文本生成收款二维码
采用类URL 格式，各主流币种格式如下：
币种名:地址?键=值&键=值&...&键=值
地址：
bitcoin:175tWpb8K1S7NmH4Zx6rewF9WQrcZv245W
请求转入20.30比特币:
bitcoin:175tWpb8K1S7NmH4Zx6rewF9WQrcZv245W?amount=20.3
请求转入20.30比特币到标签为louie地址上：
bitcoin:175tWpb8K1S7NmH4Zx6rewF9WQrcZv245W?label=louie&amount=20.3
必须遵循正确的URI编码
| 编号 | 键名 | 说明 |
|---|---|---|
| 1 | amount | 收款金额 |
| 2 | value | 收款数值（该数值不应包含小数点） |
| 3 | decimal | 小数点位数 |
| 4 | contractAddress | 合约标记地址 |
为公链注册币种名称
| 币种编号 | 币种符号 | 币种全称 |
|---|---|---|
| 0 | BTC | bitcoin |
| 2 | LTC | litecoin |
| 5 | DSH | dash |
| 60 | ETH | ethereum |
| 61 | ETC | ethereumclassic |
| 145 | BCH | bitcoincash |
| 153 | BTM | bytom |
| 194 | EOS | eos |
| 2301 | QTUM | qtum |
| 2303 | GXC | gxchain |
| 2304 | SSC | selfsell |
| 99999 | WICC | Waykichain |