获取钱包地址
用于为指定商户用户获取专属充值地址，适用于加密货币收款场景。
同一用户 + 同一链只会生成一个地址（幂等）。
请求说明
- 方法：
POST - 路径：
/api/v1/payin/cryptoAddress - Content-Type：
application/json - 鉴权：参考 接入准备 中参数以及签名算法说明，按照要求携带必须的鉴权信息
请求字段（Request Body）
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
merchantUserId | string | 是 | 商户侧用户唯一标识 |
chain | string | 是 | 链类型，枚举：ETH、BSC、TRON |
请求示例
json
{
"merchantUserId": "velora_1234",
"chain": "BSC"
}响应参数
响应体为统一结构：result 表示请求结果，data 表示地址信息。
result 对象
| 字段 | 类型 | 说明 |
|---|---|---|
code | string | 返回码（成功/失败标识） |
msg | string | 返回信息说明 |
data 对象
| 字段 | 类型 | 必返 | 说明 |
|---|---|---|---|
status | string | 是 | 当前处理状态，成功时返回 Success |
merchantUserId | string | 是 | 商户侧用户唯一标识 |
chain | string | 是 | 链类型，枚举：ETH、BSC、TRON |
address | string | 是 | 为该用户在指定链上分配的钱包地址 |
响应示例
json
{
"result": {
"code": "S0000",
"msg": "Address created successfully"
},
"data": {
"status": "Success",
"merchantUserId": "velora_1234",
"chain": "BSC",
"address": "0x8Be0f2577b0018844fF19b675f387CC36605F1B7"
}
}说明
- 适用于加密货币收款场景
- 同一
merchantUserId在同一chain下重复请求时，返回同一个地址 - 商户获取地址后，可引导用户向该地址发起转账