应用场景

在线商店无需插件接收加密货币付款

在线商店通过 Crypto Merchant 接收加密货币的方式是：通过 REST API 为每个订单创建一张账单，并将客户引导至该账单的托管收银台页面。客户选择一种币，按该账单锁定的汇率支付准确金额，您的服务器在收到带签名的 invoice.paid Webhook 时发货。手续费为每笔已付款账单 1%。没有 WooCommerce、Shopify 或 Magento 插件：接入工作就是一次 API 调用和一个 Webhook 端点。

更新于 2026年11月6日

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

一览

主题	如何运作
客户如何付款	在托管账单页面上：客户从您接受的币种和网络中选择，看到准确金额和为该账单生成的收款地址，附带二维码和倒计时。
您需要构建什么	客户选择加密货币时的一次 `POST /invoices` 调用，以及一个接收 Webhook 的 HTTPS 端点。任何能发出 HTTPS 请求的语言或框架都可以。
何时发货	在收到 `invoice.paid` 事件时，即付款获得所需确认之后。切勿在 `invoice.confirming` 时发货。
金额错误	短缺不超过您容差的付款视为已付款。短缺更多时账单变为`underpaid`（少付）：客户可以补付，或取回已发送的款项。多付仍视为已付款，多出的部分会为客户保留。
计价货币	默认为美元，或 EUR、GBP、TRY、BRL 等其他支持的货币；客户选择币种时，币的数量根据实时价格计算。
插件	没有。下面的流程适用于任何能调用 API 的购物车或自定义结账页面。

具体是如何运作的？

从客户选择“用加密货币支付”那一刻，到订单从您的仓库发出：

1
结账时创建账单
客户选择加密货币时，您的服务器调用 POST /invoices，传入订单总额、您的 order_id、客户邮箱、指向您感谢页面的 redirect_url，以及任何您希望原样返回的 metadata。响应是带有 checkout_url 的账单。
2
将客户引导至账单页面
重定向到 checkout_url。页面列出您接受的币种；客户选择一种后，该币种的金额会根据实时价格计算并锁定，同时显示为此账单生成的收款地址和二维码。账单在您设定的时间内保持有效，默认为 30 分钟。
3
接收带签名的 Webhook
付款在链上被检测到时，您的端点收到 invoice.confirming；获得足够确认后收到 invoice.paid。验证 CM-Signature 头，保存事件，在 10 秒内返回 2xx，然后根据您保存的副本放行订单。事件可能到达两次：用事件 id 确保只发货一次。
4
处理三种特殊情况
invoice.expired：没有付款按时到达，请提供一张新账单。invoice.underpaid：客户可以把剩余部分发送到同一地址，或在账单页面申请退款。多付的账单仍为已付款；多出的部分为客户保留，客户可以在账单页面提取。
5
提现
已确认的付款扣除 1% 后计入您的余额，并归集到您商家的资金池钱包。随时提现到您自己的地址，每种币原样提现，或全部兑换为一种持有币种。

只需这一次 API 调用

结账时创建账单

curl https://cryptomerchant.online/api/v1/invoices \
  -H "Authorization: Bearer $CM_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "64.00",
    "currency": "USD",
    "order_id": "ORD-20931",
    "description": "Order ORD-20931",
    "customer_email": "[email protected]",
    "redirect_url": "https://yourstore.example/orders/20931/thanks",
    "metadata": { "cart": "20931" }
  }'

# 201 → { "id": "inv_…", "status": "open", "checkout_url": "https://cryptomerchant.online/pay/i/inv_…", … }
# Send the customer to checkout_url. Ship on the "invoice.paid" webhook.

费用是多少？

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

Crypto Merchant 在此场景下不做什么

没有商店插件。没有 WooCommerce、Shopify、Magento、PrestaShop 或 OpenCart 模块。您需要自行添加 API 调用，或分享您的收银台页面和支付链接。
没有自动退款，API 中也没有退款调用。已确认的加密货币付款是最终的，因此退款是一笔新的转账。对于退货，管理员在后台从已付款的付款记录创建私密退款链接；客户输入自己的地址，网络手续费从退款中扣除，1% 的手续费不予退还。
托管式，仅限加密货币。在您提现之前，Crypto Merchant 持有密钥，提现只能到您自己的钱包地址，不能到银行账户。