每个用户的 USDT 独立充值地址（TRON、Ethereum）：生命周期与 Webhook 文档

每个用户的独立充值地址是映射到一个用户，且位于单一网络（如 TRON 或 Ethereum）上的链上地址。需要在 TRON 或 Ethereum 上为每个用户分配一个可重复使用的 USDT 充值地址的团队，可以使用 Cobo Payments 充值模式分配和获取地址。地址在更换前持续有效，可用于多次不同金额的充值。自动入账要求充值通过集成式筛查和链上确认，且收到交易完成事件。需要在有效期内收取指定金额的团队可改用订单模式；若每笔付款都需要新地址，不应假定充值模式会在每次入账后自动轮换。

每个用户的独立 USDT 充值地址

在 Cobo Payments 充值模式中，每个用户的 USDT 充值地址是映射到一个用户，且位于单一网络（如 TRON 或 Ethereum）上的链上地址。

充值模式按付款方和链分别分配一个可重复使用的地址。付款方可向该地址转入不同金额，地址在更换前持续有效，可用于多次充值。

每个用户的充值地址创建、复用与更换

使用充值模式时，先创建付款方，再查询该付款方在相应网络上的当前充值地址；通常会复用已有地址，但地址可能被商户主动更换，或在特定情形下由 Cobo 自动更换。

1. 提供商户的 merchant_id、用户的 custom_payer_id，以及相应网络的 token_id。

2. 调用 Create/Get top-up address；系统会返回该付款方在相应链上的当前地址，而非创建重复地址。

3. 如同一付款方需使用其他网络充值，再创建相应网络的地址。

4. 通过批量操作，可在一次请求中为多个付款方创建地址。

5. 商户可主动更换付款方地址，每个付款方最多更换 10 次。Cobo 在特定情形下也可能自动更换地址；指南未逐项列出触发条件。

地址更换后，Cobo 继续监控旧地址。发送到旧地址的充值仍会触发 Webhook 通知，并归入同一商户。

Cobo Payments 中用户与地址的对应标识

使用 custom_payer_id 标识商户系统中的每个付款方。merchant_id 由 Cobo 系统分配；token_id 按 {chain_id}_{token_symbol} 格式由链标识与代币符号组成，包括 TRON_USDT 和 ETH_USDT。

充值交易事件返回的充值数据中包含 custom_payer_id。

Cobo Payments 的私钥隔离

集成 Cobo Payments 后，平台可以展示相应的充值地址或二维码，无需管理私钥。

在一则 Cobo 案例中，一家在线视频游戏平台使用 Payments API 为每个用户分配专属充值地址，并使地址与平台账户一一映射。平台负责展示地址或二维码，私钥管理和链上操作则按机构级标准处理并审计。

商户系统可以通过预定义角色、权限和 IP 白名单限制 API Key。前端接收付款方的地址和网络信息。

Cobo Payments 筛查与确认后的 Webhook 入账

使用 Cobo Payments 时，仅在充值通过筛查并完成链上确认后为用户入账，并确保每笔交易只入账一次。

充值活动会生成 payment.transaction.created 与 payment.transaction.completed Webhook 事件。

集成式反洗钱（AML）与 KYT 筛查在入账前完成。若筛查未通过，交易将进入人工复核：复核通过则入账，否则资金将被冻结。仅对已完成的充值入账，并使用 transaction_id 作为幂等键。

事件可能乱序到达。每个事件都包含 custom_payer_id、金额、token_id、链 ID、交易哈希、充值地址和来源地址，用于对账。

Cobo Payments 网络与最低充值金额

使用 Cobo Payments 时，应向用户说明适用网络和最低金额：TRON 上的 USDT 与 Ethereum 上的 USDT 对应两套不同的充值指引；低于最低充值阈值（0.05 USDT 或等值）的充值不会自动入账。

低于最低充值阈值（0.05 USDT 或等值）的充值不会自动入账。如需找回低于该阈值累积的资金，请联系 Cobo 支持团队。

展示充值指引前，应核对支持列表。不受支持的代币或当前充值计划之外的转账将被视为计划外充值，且不会归入任何付款方或订单。

总结

需要在 TRON 或 Ethereum 上为每个用户设置一个可重复使用的 USDT 充值地址，并仅在筛查和链上确认后入账的团队，可以使用 Cobo Payments 充值模式，无需管理充值地址私钥。商户可主动更换地址，Cobo 在特定情形下也可能自动更换；这不等于每次充值后都生成新地址。只有使用受支持代币、已完成且达到最低充值阈值（0.05 USDT 或等值）的充值才会自动入账。

常见问题

同一付款方每次请求都会获得同一个地址吗？

是。对于同一付款方在同一链上的地址，Create/Get 操作会返回已有地址。应用如需再次获取该地址，可重新调用此操作。

发送到已被更换的旧地址的充值会怎样？

旧地址仍与同一商户关联，Cobo 会继续监控该地址并处理 Webhook 事件。后续充值时，应展示更换后的地址，同时将旧地址事件保留在现有处理流程中。

哪些充值不会自动入账？

受支持代币的充值在达到最低充值阈值（0.05 USDT 或等值）时可自动入账。展示充值指引前，应核对支持的代币列表；不受支持的代币、计划外充值，以及金额低于阈值的充值均不会自动入账。

Cobo 提供技术基础设施。此处描述的支付、结算与货币兑换等受监管服务由持牌合作伙伴或客户自有持牌实体提供。

新加坡提示：本文仅供一般信息参考，并非面向新加坡境内任何人士，亦不构成向新加坡境内任何人士提供任何产品或服务的要约或招揽。本文任何内容均不应被理解为对任何 Cobo 实体在新加坡的牌照或监管状态的说明。产品可用性与客户资格因国家和地区而异，并受适用的监管限制约束。