钱包列表
POST
/{{version}}/openApi/wallet/walletList
使用场景
获取钱包列表。
请求参数
| 字段 | 类型 | 是否必传 | 描述 |
|---|---|---|---|
| customer_id | long | 是 | 客户id |
| app_id | long | 是 | 应用id |
| key | string | 是 | 授权key |
| wallet_sn | string | 否 | 钱包 sn |
| wallet_name | string | 否 | 钱包 name |
| currency | string | 否 | 钱包币种 |
| page_no | int | 是 | 页码 |
| page_size | int | 是 | 每页记录数 |
{
"customer_id": 10001001,
"app_id": 100001,
"key": "ae9ae3f5ad284ef4836de18aa3d41c47",
"page_no": 1,
"page_size": 10
}
响应内容
| 字段 | 类型 | 是否必传 | 描述 |
|---|---|---|---|
| total | int | 是 | 总数 |
| page_no | int | 是 | 当前页码 |
| page_size | int | 是 | 当前每页记录数 |
| wallet_list | array[object] | 是 | 钱包数组 |
| wallet_list.wallet_id | long | 是 | 钱包 id |
| wallet_list.wallet_sn | string | 是 | 钱包 sn |
| wallet_list.wallet_name | string | 是 | 钱包名称 |
| wallet_list.customer_id | long | 是 | 客户 id |
| wallet_list.currency | string | 是 | 币种 |
| wallet_list.available_balance | float | 是 | 可用余额，单位：元 |
| wallet_list.freeze_balance | float | 是 | 冻结余额，单位：元 |
| wallet_list.status | int | 是 | 状态 1:正常 2:冻结 |
| wallet_list.create_at | datetime | 是 | 创建时间 |
{
"code": 0,
"message": "success",
"data": {
"total": 2,
"page_no": 1,
"page_size": 10,
"wallet_list": [
{
"wallet_id": 100008,
"wallet_sn": "d55d8975d44c4b89ab67dad7f6661b01",
"wallet_name": "HKD",
"customer_id": 10001001,
"currency": "HKD",
"available_balance": 10020,
"freeze_balance": 0,
"status": 1,
"create_at": "2024-01-31 09:49:02"
},
{
"wallet_id": 100007,
"wallet_sn": "f5ac9324657f47568a58428e2cdad955",
"wallet_name": "USD",
"customer_id": 10001001,
"currency": "USD",
"available_balance": 9865.29,
"freeze_balance": 0,
"status": 1,
"create_at": "2024-01-31 09:49:02"
}
]
}
}
请求参数
Body 参数application/json
请求示例代码
返回响应
修改于 2026-03-19 06:16:48