创建独享钱包

为指定 bindKey 创建一条专属收款地址，后续该地址上的入账会长期归属于这个 bindKey。

如果传入 notifyUrl，这条专属地址后续自动生成的充值订单会优先回调到这个地址，适合每个站点或应用分别接收会员充值通知。

POST/openapi/payin/exclusive-bindings

请求头

字段名称	字段类型	是否必填	说明
x-api-key	string	是	商户 API Key，使用商户后台 API 接入页面中的 mch_ 开头字符串。
x-merchant-uid	string	是	商户 UID。
x-timestamp	string	是	13 位毫秒时间戳，默认允许和服务器时间相差 5 分钟。
x-nonce	string	是	每次请求唯一的随机字符串，最长 128 位，重复使用会被拒绝。
x-signature	string	是	使用 HMAC-SHA256 生成的十六进制签名，签名原文由 Merchant UID、时间戳、nonce、请求方法、路径、规范化 query 和规范化 body 组成。

接口参数

字段名称	字段类型	是否必填	说明
chainCode	string	是	链编码，支持 TRON / BSC / SOL。
tokenSymbol	string	是	代币符号。
bindKey	string	是	商户侧唯一绑定键。
label	string	否	绑定备注。
notifyUrl	string	否	该专属地址的独立回调地址。后续地址入账自动生成订单时，优先回调到这里。

请求示例

{
  "chainCode": "TRON",
  "tokenSymbol": "USDT",
  "bindKey": "USER_90001",
  "label": "VIP User 90001",
  "notifyUrl": "https://merchant.example.com/api/uugate/member-topup-notify"
}

接口返回

字段名称	字段类型	是否必填	说明
bindingId	number	是	绑定记录 ID。
chainCode	string	是	链编码。
tokenSymbol	string	是	代币符号。
bindKey	string	是	绑定键。
addressId	number	是	地址 ID。
address	string	是	专属收款地址。
addressType	string	是	固定为 exclusive。
notifyUrl	string \| null	是	当前绑定使用的专属回调地址。
status	string	是	绑定状态。

返回示例

{
  "bindingId": 70031,
  "chainCode": "TRON",
  "tokenSymbol": "USDT",
  "bindKey": "USER_90001",
  "addressId": 31088,
  "address": "TQ3sCY8k9h7G9UsApY3JPt5VDpNKr2kJ1E",
  "addressType": "exclusive",
  "notifyUrl": "https://merchant.example.com/api/uugate/member-topup-notify",
  "status": "active"
}

代码示例

cURL 请求示例

curl -X POST 'https://api.uugate.com/openapi/payin/exclusive-bindings' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: mch_xxxxxxxxxxxxxxxxxxxx' \
  -H 'x-merchant-uid: 880001' \
  -H 'x-timestamp: 1776193200000' \
  -H 'x-nonce: 2f5c7b147c3748f0a8b3d9bb38aa91a4' \
  -H 'x-signature: <SIGNATURE_HEX>' \
  -d '{
    "chainCode": "TRON",
    "tokenSymbol": "USDT",
    "bindKey": "USER_90001",
    "label": "VIP User 90001",
    "notifyUrl": "https://merchant.example.com/api/uugate/member-topup-notify"
  }'

说明

如同一 bindKey 重复创建，平台会幂等返回原有绑定和地址，适合直接按“get or create”方式接入。
会员充值场景建议在绑定时就传入 notifyUrl，这样后续专属地址任意金额入账都会直接回调到对应站点或应用。