独享地址与共享地址怎么选:USDT / USDC 订单和会员充值

2026-06-16 · 更新 2026-10-01 · UUGate · 约 3 分钟阅读

普通订单与长期会员充值需要不同的关联关系。选择钱包模式时同时确认业务对象、金额识别方式和资金控制权,不只比较地址是否固定。

选择网络与业务模式

固定金额购买使用共享收款订单,保存商户单与平台单映射,并遵守有效期和金额占用规则;存在有效同金额订单时可能返回 40105。长期会员充值使用独享绑定,让 bindKey 与指定链、币种和地址长期对应。

接口参数与接入步骤

共享模式从 POST /openapi/payin/orders 开始;独享模式从 POST /openapi/payin/exclusive-bindings 开始。支持组合是 TRC20-USDT、BEP20-USDT、BEP20-USDC、SPL-USDC,选择两种模式不会扩大网络支持。

以下为请求体演示,未发送请求,不含真实商户、密钥或交易。完整调用还需在服务端按文档填写 UID、API Key、时间戳、nonce 与签名。金额使用字符串;不要用前端浮点计算作为资金入账依据。

{
  "chainCode": "TRON",
  "tokenSymbol": "USDT",
  "merchantOrderNo": "DEMO_PRODUCT_001",
  "amount": "10.00",
  "notifyUrl": "https://merchant.example.com/payments/notify"
}

状态、回调与异常处理

地址绑定与付款权限也要分开:平台生成的托管钱包可按权限发起付款;导入观察地址用于监控,不能由平台签名转出。独享地址是业务绑定方式,不等于所有导入地址都能托管付款。

固定金额收款创建超时且没有拿到 orderNo 时,先在后台核实原业务单,不能假定 merchantOrderNo 提供自动幂等重试保证。已有 orderNo 时按平台单号查单;回调幂等和下单重试是两个不同问题。

验签使用创建原订单时的 API Key 和原始 rawBody,校验 HMAC-SHA256(timestamp + "." + nonce + "." + rawBody) 与 x-callback-signature。验签后再核对身份、订单、币种、网络与金额,以数据库事务和唯一约束保证只处理一次。业务已可靠持久化后返回 HTTP 2xx;浏览器跳转或截图不能代替到账结果。

演示案例:从接口到业务完成

演示:一次购买 10.00 USDT 的商品,创建固定金额订单并展示收银台;长期会员账户则保存 MEMBER_DEMO_001 的绑定,允许后续充值自动生成记录。两条路径最终都进入已验签、只处理一次的业务入账函数,但不要共用地址归属判断逻辑。

上线前逐项验证

继续接入与技术资料

这些资料解释底层标准和实现方法,不代表官方机构为 UUGate 背书。具体接入参数以 UUGate 当前文档为准。

下一步

稳定币内容中心

准备接入稳定币收付?

先用测试环境跑通收款、代付、回调和对账,再切换生产链路。