应用场景

用加密货币销售数字产品：下载、许可证和电子书

数字商品卖家通过 Crypto Merchant 交付的方式是：为每个订单创建一张账单，将买家引导至托管账单页面，并且只在收到带签名的 invoice.paid Webhook 时才发放下载或许可证密钥。交付是自动的，而且由于已确认的加密货币付款是最终的，不存在拒付。对于不想写代码的小型商品目录，每个产品一个支付链接，再由您自己发送交付邮件，也能达到同样效果。手续费为每笔已付款账单 1%。

更新于 2026年11月6日

本页所有内容描述的都是 Crypto Merchant 目前的运作方式，依据是 API 参考、收银台文档和价格页面。此处没有任何关于其他网关的说法。

一览

主题	如何运作
买家如何付款	在托管账单页面上：买家自选币种、按锁定汇率支付准确金额，附带二维码和倒计时。然后通过 `redirect_url` 回到您的网站。
您需要构建什么	一次 `POST /invoices` 调用，在 `metadata` 中标明产品，以及一个在 `invoice.paid` 时生成密钥或下载链接的 Webhook 端点。
何时交付	仅在 `invoice.paid` 时。`invoice.confirming` 表示付款已被检测到，但尚未最终确认。
拒付	没有。已确认的加密货币付款无法被银行撤销。如果产品无法使用，您可以从后台向买家发送私密退款链接。
无需代码	在后台为每个产品创建一个支付链接。每笔付款您都会收到邮件，然后由您自己发送文件。
注册所需证件	无。侵犯他人知识产权的内容为服务条款所禁止。

具体是如何运作的？

从“立即购买”到买家拿到文件：

1
创建账单
买家点击“用加密货币购买”时，调用 POST /invoices，传入价格、您自己的 order_id、买家邮箱、指向您下载页面的 redirect_url，以及标明产品和许可证类型的 metadata。
2
将买家引导至账单页面
重定向到 checkout_url。买家选择币种，汇率锁定，并显示为此账单生成的收款地址。账单在您设定的时间内保持有效，默认为 30 分钟。
3
在 invoice.paid 时交付
验证签名，保存事件，返回 2xx，然后生成许可证密钥或带签名的下载链接并通过邮件发送。使用事件 id，即使 Webhook 到达两次也只交付一次。
4
把买家带回来
付款后，买家可以沿 redirect_url 回到您的页面。在那里展示来自您服务器的订单状态；证明付款的是 Webhook，而不是重定向。
5
无需代码：每个产品一个链接
在支付链接中为每个产品创建一个固定价格的支付链接。每笔付款都会出现在后台并通过邮件通知您，然后由您手动发送文件。适合少量产品；当这变得繁琐时，再用 API 实现自动化。

只需这一次 API 调用

为一次下载创建账单

curl https://cryptomerchant.online/api/v1/invoices \
  -H "Authorization: Bearer $CM_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "19.00",
    "currency": "USD",
    "order_id": "dl-55120",
    "description": "Icon pack, lifetime licence",
    "customer_email": "[email protected]",
    "redirect_url": "https://shop.example/download?order=55120",
    "metadata": { "product": "icon-pack", "licence": "lifetime" }
  }'

# On "invoice.paid": generate the licence key and email the download link.
# Don't deliver on "invoice.confirming": the payment isn't final yet.

每笔已付款账单收取 1%，在付款计入您的余额时扣除。没有开通费，没有月费，激活也无需付款；过期和已取消的账单不产生任何费用。转移币（归集、兑换和提现）需支付 Gas 费，如果您已添加 Gas 余额则从中扣除，否则从正在转移的币中扣除。客户也需为每张账单支付 Gas 费：该费用加在客户发送的金额上，在收银台显示，最高不超过 US$5。兑换汇率包含 1% 的服务差价。所有费用都汇总在价格页面的一张表格中。