# 创建新地址

商戶可以使用该接口為用戶生成收款地址

用戶向該生成的地址充值后，商戶會收到對應的充值通知回調

注意：使用該功能前，請確保已經設定通知到賬回調地址

回調通知地址設置

# 请求地址

环境

HTTPS请求地址

正式生产环境

/v1/custody/address/create

测试环境

/v1/custody/address/create

# 请求方式

  • POST

# 业务请求参数

参数 类型 是否必填 最大长度 描述 示例值
symbol String 是 - 币种 TRC_USDT
customer_code String 否 - 用戶編碼（可选、20位以内字符串），该参数代表不同用户，用于生成不同地址（0或无此参数，则获取商户账号的收款地址） 001201

# 业务响应参数

参数 类型 是否必填 最大长度 描述 示例值
code Integer 是 -- 状态码 0
msg String 是 -- 网关返回码描述 SUCCESS
data Object 是 - 地址信息

# 响应成功示例

{
    "code":0,
    "data":{
      "address":"TX3Ejg9ia6BZKLHrx8GswppVtctcTssYwH",
      "symbol":"TRC_USDT",
      "qrcode":"iVBORw0KGgoA...Jggg=="
    },
    "msg":"SUCCESS",
    "sign":"duROA40UC89...lbFtugSmr4ucaU8="
}

# 商戶收款回調結果通知

回調通知地址設置

{
    "transaction_id": "b1afa8eee4bf...93f15e0f256a13b1",
    "value": "1000000000.00000000", // 注意：實際USDT金額，需要將value / 1000000
    "from": "TFND...qTie",
    "to": "TRpZb...31mnnn",
    "type": "Transfer",
    "symbol": "USDT",
    "name": "Tether USD",
    "time": "2024-07-11 03:55:48",
    "contract_addr": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
    "decimals": 6,
    "fund_status": 0,
    "is_deposit": 1,
    "callback_status": 0,
    "is_rollup": 0,
    "token_info": 1,
    "block_timestamp": 1720641348000,
    "created_time": "2024-07-10 19:59:51",
    "customer_code": "61586",
    "sign": "kTWJ2RD88d4...0PH6PZaNs6Q4="
}

查询地址 keyboard_arrow_right