跳到正文

静态加密钱包支付:如何为每位客户分配永久链上充值地址

2026年11月6日 2 分钟读完 Paymos Tech Paymos Tech
静态加密钱包支付与永久充值通道架构图

要点速览

静态加密钱包为每位客户分配一个永久链上充值地址,该地址在多次支付中始终保持不变。动态账单设有支付时限,时限结束即失效;永久支付通道则不同,用户可以反复转入不低于对应代币和网络最低充值门槛(minimum_deposit)的资金,无需每次新建收银台。每笔入账都会经过反洗钱(AML)筛查,确认后记入商户余额,并通过 Webhook 通知。

在传统电商场景中,加密支付通常采用动态账单:买家下单后看到一个带倒计时的二维码,并在倒计时结束前转入精确金额。这种模式适合单次结算,但对于需要频繁充值或订阅续费的SaaS、云服务及线上游戏平台而言,会给用户带来极大的操作负担。

静态加密钱包(支付通道)正是解决该痛点的行业标准。它为每个注册用户分配一个永久专属的链上收款地址,用户可将其保存至手机钱包或交易所地址簿中,随时随地直接转账。

什么是静态加密钱包?

静态加密钱包是绑定在客户身份下的永久链上充值入口。与定时过期的临时账单不同,静态地址永久有效,并能接收达到最低门槛的入账。

核心业务优势:

  1. 永不过期: 用户保存地址后可长期使用,无需每次充值重新发起订单(直到商户明确通过接口阻断)。
  2. 金额灵活: 支持不低于对应代币和网络的最低充值门槛(minimum_deposit)的资金转入。
  3. 自动入账: 转账一出现在链上即接受 AML 筛查;达到网络要求的确认数并通过筛查后,充值 Webhook 会推送到您的后端。

如需了解完整的接口规范,请参阅 Host-to-Host REST API 文档。

架构对比:临时账单与永久通道

技术层面的本质区别在于地址与业务实体的绑定关系:动态账单将地址绑定到具体的一笔订单,而静态通道则将地址直接绑定到商户的用户账户。

对于回头客,静态钱包让重复充值不再经过收银台:用户复制一次地址,之后直接从自己的钱包或交易所账户转账。关于不同结算模式的费用承担,请阅读我们的专文分析:谁来承担加密支付处理费。

多链架构:统一管理 TRC-20、ERC-20 与 TON

企业级加密网关能够为单一客户生成多条链上的静态地址。客户持有的 USDT 等稳定币分布在不同网络上,例如波场(Tron TRC-20)、以太坊(ERC-20)和 TON,因此接收充值的平台往往需要在多个网络上提供地址,同时不打乱每个用户的账务。

创建通道后,Paymos 会为其支持的网络准备充值地址,其中也包括 Arbitrum、BSC、Polygon(请注意,Base 网络在 Paymos 中仅支持 USDC)。地址准备需要片刻,只有在通道报告地址就绪后才应展示(见下方 API 部分)。

无论客户从哪个网络转账,确认后的充值都会以该资产记入商户余额。您的后端无需在每条链上持有 Gas,也无需自建链上基础设施来接收充值。

开发者 REST API 对接

接入静态支付通道主要分为两个步骤:通道创建与充值回调监听。

1. 为用户创建专属通道

使用 Payment API 密钥,按 HMAC-SHA256 认证规范签名。以下占位符分别表示密钥 ID、当前 Unix 时间戳,以及对 timestamp\nMETHOD\npath\nquery\nbodyHash 计算的 Base64 签名。bodyHash 是原始请求正文的 SHA-256 小写十六进制摘要。 各字段之间使用 LF 换行符。

POST /v1/payment-channels HTTP/1.1
Host: api.paymos.io
Authorization: HMAC-SHA256 {api_key_id}:{base64_signature}
X-Request-Timestamp: {unix_seconds}
Content-Type: application/json

{
  "project_id": "prj_xFukZuAJZR06pLVBh3uwzv",
  "external_id": "usr_991824"
}

首次请求返回 HTTP 201 Created;在同一环境中使用相同的 project_id 和 external_id 重试,会以 HTTP 200 OK 返回原通道。生产环境的新通道处于 provisioning 状态,此时尚无地址:

{
  "id": "pc_2QhKZv6mRt9WdA3nYpLbXf",
  "project_id": "prj_xFukZuAJZR06pLVBh3uwzv",
  "external_id": "usr_991824",
  "status": "provisioning",
  "is_accepting_payments": false,
  "is_fully_provisioned": false,
  "is_test": false,
  "applied_fee_percent": 1,
  "customer_fee_percent": 0,
  "networks": [
    {
      "network": "TRC20",
      "status": "provisioning",
      "tokens": [
        {
          "symbol": "USDT",
          "minimum_deposit": "1.00"
        }
      ]
    }
  ],
  "created_at": 1767225600,
  "updated_at": 1767225600
}

地址准备期间,通过 GET /v1/payment-channels/{id} 读取通道。仅当 is_accepting_payments 为 true、该网络状态为 active 且其 tokens 数组非空时,才展示该网络的地址。在地址旁显示每个代币的最新 minimum_deposit,转账前先核对;示例中的最低金额仅作演示。该值缺失或为 null 时,请等待报价。低于门槛的转账不会记入通道,也不会自动退回。详情见查询通道。

2. 接收充值成功通知

充值通过筛查并达到网络要求的确认数后,payment_channel.deposit.confirmed Webhook 会通知这笔已完成的充值:

{
  "event_id": "evt_J7EEYeL9pZJukfj2c5OQ44",
  "event_type": "payment_channel.deposit.confirmed",
  "version": 1,
  "occurred_at": 1767225930,
  "data": {
    "id": "pcd_8ScRvL4jNq2XkB7mTfZdWu",
    "payment_channel_id": "pc_2QhKZv6mRt9WdA3nYpLbXf",
    "project_id": "prj_xFukZuAJZR06pLVBh3uwzv",
    "payment_channel_external_id": "usr_991824",
    "status": "confirmed",
    "is_final": true,
    "is_test": false,
    "currency": "USDT",
    "network": "TRC20",
    "chain_id": 728126428,
    "contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
    "gross": "100",
    "fee": "1",
    "net": "99",
    "applied_fee_percent": 1,
    "customer_fee_percent": 0,
    "tx_hash": "9f4c1b7e30ad52c8ef6a1d84b0c39f27a5e6d138f4b90c72ae51d63b8407fc25",
    "transfer_id": "9f4c1b7e30ad52c8ef6a1d84b0c39f27a5e6d138f4b90c72ae51d63b8407fc25:41a614f803b6fd780986a42c78ec9c7f77e6ded13c:41c9f6a2b7d0138e54ca3b91f6072ed48a5c1e93b7:0",
    "source_address": "TQiBwkXtUUNygicvHJVVDCDKyVFr2YNTey",
    "destination_address": "TN3W4H6rK2ce4vX9YnFQHwKENnHjoxb3m9",
    "block_height": 68421905,
    "first_included_block_timestamp": 1767225900,
    "explorer_url": "https://tronscan.org/#/transaction/9f4c1b7e30ad52c8ef6a1d84b0c39f27a5e6d138f4b90c72ae51d63b8407fc25",
    "created_at": 1767225870,
    "updated_at": 1767225930,
    "confirmed_at": 1767225930
  }
}

按照 webhook 验签说明,使用原始请求正文验证签名。将 data.net 记入用户余额时,在同一数据库事务中按 data.id(pcd_…)去重;用 event_id 识别重复投递。详见 Webhook 幂等性处理。

入账转账的反洗钱(AML)筛查

静态地址对外公开,任何第三方地址都可以向其转账,因此对入账转账进行自动筛查很重要。转账一出现在链上,Paymos 即对发送方地址进行 KYT 筛查,依据以下来源:TRM Labs、Binance AML、AMLBot、PureFi 以及筛查服务商的数据库。结果正常的充值照常确认并入账。筛查未通过或未返回结论时,充值会被标记为 Held for review:不记入商户余额,不发送确认 Webhook,商户会在控制台收到通知。

筛查不能替代商户自身的反洗钱和制裁合规义务,被暂扣的充值也不保证会被放行。

网络费与归集:静态钱包充值的归集费用由谁承担

发送充值的网络费由客户的钱包支付。Paymos 承担接收和归集充值的网络成本,不向商户另收转账费或归集费。网络费由各条链自行决定,并随拥堵程度变化,因此没有固定金额。

如果自建归集,每个地址都要为自己的归集转账付费,一笔很小的充值归集起来可能比它本身还贵。在 Paymos,每条路由都执行实时的 minimum_deposit,低于该值的转账不会记入通道。查看详情请访问我们的 费用说明。

静态支付通道与动态加密账单对比(2026年11月)
维度静态钱包(支付通道)动态账单
地址有效期永久有效(可多次复用)带倒计时的支付时限
预期金额不低于最低门槛 (minimum_deposit)固定订单金额;付款人确认币种和网络时锁定汇率
核心应用场景SaaS充值、iGaming、加密交易所电商购物车、单次小额采购
Webhook事件payment_channel.deposit.confirmedinvoice.paid / invoice.expired
地址生成时机每个客户注册时分配一次每张账单分配一次,在付款人确认币种和网络时
收款网络成本由 Paymos 承担由 Paymos 承担

常见问题

静态加密钱包与动态账单有何不同?

动态账单针对单笔订单创建,金额固定并设有支付时限,时限结束即失效。静态加密钱包(支付通道)则为注册用户绑定一个可复用的充值地址,没有支付时限,接收不低于对应代币和网络的最低充值门槛(minimum_deposit)的资金。

客户可以通过不同网络向同一静态钱包发送USDT吗?

可以,前提是支付网关支持多链路由。静态支付通道会为同一客户ID(external_id)在Tron(TRC-20)、Ethereum(ERC-20)、BSC和TON等链上生成专属地址。

系统如何确认是哪位客户充值了资金?

每个静态地址在创建时都会与商户系统中的客户外部ID(external_id)唯一绑定。当交易在链上确认后,网关发送的Webhook中会携带该客户标识符。

如果充值金额低于最低门槛会怎样?

minimum_deposit 按代币和网络分别实时提供。转账前先查询该值:低于门槛的转账不会记入通道,也不会自动退回。如果该值缺失或为 null,请等待可用的最低金额。

Paymos 静态钱包是否属于托管型?

是。Paymos 持有充值地址的签名密钥,确认后的充值会记入商户在 Paymos 内部账本中的余额。

什么时候不该用静态加密钱包

  • 销售需要锁定库存的实体电商商品 — 请改用带倒计时的动态加密账单。
  • 需要针对无注册游客订单进行严格的一对一订单结算。
  • 您的后端服务器无法部署接收异步充值事件的Webhook接口。
  • 业务模型要求极高的UTXO隐私且严禁地址复用。

参考来源

  1. 1. Paymos API:创建支付通道

最近复核:2026年11月7日

#静态钱包#支付通道#usdt#充值地址#rest-api
分享