用户与充值地址

创建或更新用户

POST /v1/customers

需要商户请求签名，以及已经配置的商户主钱包。

{
  "external_id": "customer_1001",
  "metadata": {"source": "website"}
}

响应结构示意，UUID 与地址字段应使用接口实际返回值：

{
  "data": {
    "customer_id": "<平台用户UUID>",
    "external_id": "customer_1001",
    "wallet_id": "<充值钱包UUID>",
    "asset": "BEP20-USDT",
    "address": "<用户专属充值地址>"
  }
}

幂等与关联规则

重复提交相同的 external_id，会复用已有用户及其有效充值地址，并更新 metadata。请为同一个业务用户持续使用同一编号，不要每次充值生成新编号。

被停用的用户无法通过此接口重新启用。缺少主钱包配置时，接口返回 HTTP 409。

查询充值地址

GET /v1/customers/{customer_id}/deposit-address?asset=BEP20-USDT

customer_id 使用平台返回的 UUID，不是 external_id。不传 asset 时默认查询 BEP20-USDT，返回结构与创建接口一致。

查询参数不参与签名；路径仍需使用实际 UUID。找不到当前商户的地址时返回 HTTP 404。

向用户展示地址

请同时展示资产名称、充值网络和地址，并提供复制功能。仅展示 0x 地址不足以区分网络。