本指南介绍如何使用 Electrum 在您的网站上设置比特币支付。我们将使用 SSL 签名的支付请求,按照 BIP-70 标准。本文档适用于 Electrum 4.0 及更高版本。
在开始之前,请确保您已
- 有效的 SSL 证书(由 CA 签名,如免费的 让我们加密).
- 已安装 Electrum 的开发版本。
记得在安装过程中运行子模块更新命令。
在 Electrum 中设置 SSL 证书
要启用安全连接,您需要在 Electrum 中添加 SSL 证书。在终端中使用以下命令:
electrum -o setconfig ssl_keyfile /path/to/ssl/privkey.pem
electrum -o setconfig ssl_certfile /path/to/ssl/fullchain.pem
有关在 Electrum 中添加 SSL 的更详细说明,请查看 为 Electrum 配置 SSL.
创建和使用商家钱包
为您的业务交易设置一个安全钱包。即使您的商家服务器受到威胁,这一过程也有助于保护您的加密货币。
- 创建新钱包
在安全电脑上创建一个新钱包:
electrum create
最好使用单独的企业钱包,而不是个人钱包。
- 导出主公钥
还是在安全电脑上,导出主公钥 (xpub):
electrum getmpk -w .electrum/wallets/your-wallet
- 设置商家服务器
在服务器机器上,使用导出的主公钥还原钱包:
electrum restore xpub...............................................
更换 xpub...
使用您的实际主公钥
- 配置服务器设置。
electrum -o setconfig payserver_address yourdomain.com:80
更换 yourdomain.com
使用您的实际域名。
启动电子邮筒守护进程
设置好只读钱包后,你需要将 Electrum 作为后台服务运行。具体方法如下
- 启动守护进程
运行此命令,以守护进程的形式启动 Electrum:
electrum daemon -d
这将以守护进程模式启动 Electrum,使其在后台运行。
- 装入您的钱包
接下来,将钱包加载到运行中的守护进程中:
electrum load_wallet
该命令可使钱包激活并随时可用。
停止守护进程
如果需要在任何时候停止 Electrum 守护进程,请使用此命令:
electrum stop
这将安全关闭 Electrum 守护进程。
创建已签署的付款申请
electrum add_request 0.5 -m "test"
{
"URI": "bitcoin:bc1q3hr4xnta7s4jgeymjhs498ygqa53qkjxqhlx3z?amount=0.5&message=test&time=1589115653&exp=3600",
"address": "bc1q3hr4xnta7s4jgeymjhs498ygqa53qkjxqhlx3z",
"amount": 50000000,
"amount_BTC": "0.5",
"bip70_url": "https://yourdomain.com:80/bip70/bc1qyr5xx5jkue3k72sldm5xa0taqs3n2achupymz8.bip70",
"exp": 3600,
"id": "63822b69013",
"memo": "test",
"status": 0,
"status_str": "Expires in about 1 hour",
"time": 1589115653,
"type": 0,
"view_url": "https://yourdomain.com:80/r/pay?id=bc1q3hr4xnta7s4jgeymjhs498ygqa53qkjxqhlx3z"
}
以下是主要信息的细目:
URI
:比特币 URI,包括金额、信息、时间戳和有效期。address
:付款的比特币地址。amount
:申请的金额(单位:沙托希)。amount_BTC
:以 BTC 为单位的申请金额。bip70_url
:已签名 BIP70 请求的 URL。view_url
:显示请求的网页 URL。
命令输出包括两个重要的 URL:
bip70_url
:这是签名的 BIP70 请求的 URL。view_url
:这是显示请求详细信息的网页 URL。
要查看当前的请求列表,请使用 list_requests
指挥。
要从列表中删除所有请求,请使用 clear_requests
指挥。
在浏览器中打开付款申请页面
创建付款申请后,您可以通过网络浏览器查看。

下面介绍如何使用付款申请页面:
- 打开
view_url
从网络浏览器中的付款请求输出中获取。 - 页面将显示付款申请的详细信息,包括
- 可以用钱包打开的比特币 URI。
- 可扫描付款的二维码。
- 请求到期前的剩余时间。
- 付款:
- 使用比特币钱包打开所提供的比特币 URI。
- 用手机钱包扫描二维码。
- 该页面使用网络接口实时更新。收到付款后,页面会自动刷新,显示更新状态。

页面的实际外观可能会有所不同,但会包含完成付款所需的基本信息。
重要提示:在发送任何资金之前,请务必核实付款详情。
闪电支付
设置闪电
要使用 "闪电",您需要在钱包中设置 "闪电 "密钥。请按照以下步骤操作:
- 停止 Electrum 守护进程
electrum stop
- 初始化闪电钥匙:
electrum -o init_lightning
- 重新启动守护进程:
electrum daemon -d
您可以将闪电密钥添加到只供观看的钱包中。这个钱包不能在链上消费硬币,但可以执行闪电交易。
打开通道
设置 "闪电 "后,您需要打开一个通道:
electrum open_channel <node_id> <amount>
检查通道是否可以使用:
electrum list_channels
请注意,您的新渠道一开始不会有进货能力,因此您无法立即收到付款。如果您需要立即收款,可以考虑将您的渠道资金进行海底交换。
创建闪电付款申请
创建闪电付款申请:
electrum add_lightning_request 0.0001 -m "test"
该命令创建一个 0.0001 BTC 的请求,信息为 "test"。