应用场景

为 SaaS 或订阅服务接收加密货币付款

SaaS 通过 Crypto Merchant 接收加密货币的方式是：为每个计费周期创建一张账单，并在收到带签名的 invoice.paid Webhook 时延长账户。加密货币钱包无法被自动扣款，因此续费就是一张由客户支付的账单，账单过期时发送提醒。对于预付额度，固定钱包为每位客户提供一个永久收款地址，在 deposit.confirmed 时为其余额充值。手续费为每笔已付款账单 1%，没有月费。

更新于 2026年11月6日

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

一览

主题	如何运作
客户如何付款	每个计费周期一个账单页面，从您的计费界面或续费邮件链接过去。预付余额则使用客户专属的永久收款地址，每个网络一个。
您需要构建什么	一个在周期结束时创建账单的任务，`metadata` 中标明账户和周期，以及一个延长账户的 Webhook 端点。或者为每个账户调用 `POST /sticky-wallets`。
定期扣款	不自动。加密货币钱包无法被扣款，因此每次续费都是一张由客户支付的新账单。`invoice.expired` 事件告诉您何时发送提醒。
定价与持有	以美元或其他支持的货币为套餐定价；稳定币各按 1 美元计算。将收到的一切兑换为 USDT 或 USDC，收入就不会随市场波动。
客户记录	传入 `customer_email`，付款就会在后台按客户分组；`order_id` 和 `metadata` 会随每个 Webhook 返回。
注册所需证件	无。开通账户不需要注册公司；服务条款仍然适用。

具体是如何运作的？

一个月付套餐，从一个周期结束到下一个周期开始：

1
周期结束时创建账单
定时任务调用 POST /invoices，传入套餐价格、诸如订阅 id 加周期的 order_id、客户邮箱、指向您计费页面的 redirect_url，以及标明账户和周期的 metadata。
2
告诉客户在哪里付款
把 checkout_url 放在计费页面和续费邮件中的“用加密货币支付”按钮后面。客户选择币种，汇率锁定，账单在您设定的时间内保持有效，默认为 30 分钟。
3
在 invoice.paid 时延长账户
验证签名，保存事件，返回 2xx，然后将 metadata 中标明的账户延长一个周期。使用事件 id，以免重复投递导致延长两次。
4
在 invoice.expired 时提醒
如果账单过期未付，创建一张新账单并通过邮件发送。过期的账单不保留任何内容：汇率只在账单有效期间锁定。
5
预付额度：为每位客户提供一个永久地址
使用固定钱包，用您自己的客户 id 调用 POST /sticky-wallets，每次都会返回相同的地址。在充值页面展示这些地址；在 deposit.confirmed 时，为 sticky_wallet.reference 中标明的客户充值。

只需这一次 API 调用

为一个计费周期开账单

curl https://cryptomerchant.online/api/v1/invoices \
  -H "Authorization: Bearer $CM_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "29.00",
    "currency": "USD",
    "order_id": "sub_8f3a-2026-11",
    "description": "Pro plan, November 2026",
    "customer_email": "[email protected]",
    "redirect_url": "https://app.example/billing?paid=1",
    "metadata": { "account": "8f3a", "period": "2026-11" }
  }'

# On "invoice.paid": extend account 8f3a by one month (metadata is echoed back).
# On "invoice.expired": send a reminder with a fresh invoice.

费用是多少？

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