# 修改金融账户信息
# 调用方式: PUT
# 接口地址:
https://api.freelog.com/v3/transactions/accounts/{accountId}
1
# url传入参数说明:
| 参数 | 必选 | 类型及范围 | 说明 |
|---|---|---|---|
| accountId | 必选 | string | 账户ID |
# body传入参数说明:
| 参数 | 必选 | 类型及范围 | 说明 |
|---|---|---|---|
| certNo | 必选 | string | 证件号码;例如身份证号 |
| name | 必选 | string | 证件上的名称;例如身份证上的姓名 |
| certValidityType | 必选 | int | 证件有效期是否是长期; 0:非长期有效 1:长期有效 |
| certBeginDate | 必须 | string | 证件有效期开始日期 |
| certEndDate | 可选 | string | 证件有效期结束日期(长期有效时此处不传) |
| certImagePaths | 必须 | string[] | 证件照保密存放的path部分; 身份证号码识别接口会返回 |
# body示例
{
"certNo": "420625XXXXXXXXXXXX",
"name": "余XX",
"certValidityType": 0,
"certBeginDate": "2022-XX-XX",
"certEndDate": "2042-XX-XX",
"certImagePaths": ["证件照1path","证件照2path"]
}
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
# 返回说明:
| 返回值字段 | 字段类型 | 字段说明 |
|---|---|---|
| id | string | 金融账户ID |
| accountType | string | 账户类型(1:个人账户 2:节点账户) |
| ownerId | int | 账户所有者ID; 根据账户类型动态赋值userId或nodeId |
| ownerName | string | 账户所有者名称 |
| ownerUserId | int | 账户所属者对应的用户ID |
| ownerUserName | stirng | 账户所属者对应的用户名称 |
| currencyType | int | 货币类型 1:人民币 2:美元 |
| totalBalance | number | 余额 |
| availableBalance | number | 可用余额 |
| freezeBalance | number | 冻结金额 |
| status | int | 状态 1:正常 2:冻结 |
| certType | stirng | 证件类型 00:身份证 |
| certName | string | 证件上的名称 |
| certNo | string | 证件号码 |
| certValidityType | int | 是否长期有效 0:否 1:是 |
| certBeginDate | date | 证件有效期开始日期 |
| certEndDate | date | 证件有效期截止日期 |
# 示例
{
"ret": 0,
"errCode": 0,
"data": {
"accountType": 1,
"ownerId": 50017,
"ownerName": "yuliang",
"ownerUserId": 50017,
"ownerUserName": "yuliang",
"channelType": 1,
"currencyType": 1,
"totalBalance": 1.07,
"availableBalance": 1.07,
"freezeBalance": 0,
"totalIncomeAmount": 0.08,
"totalExpenditureAmount": 0,
"latestTransactionDate": "2025-12-19T08:03:47.263Z",
"certType": "00",
"certNo": "**************4719",
"certName": "**亮",
"certValidityType": 0,
"certBeginDate": "2022-10-08",
"certEndDate": "2042-10-08",
"certImagePath": "temp",
"status": 1,
"createDate": "2025-12-10T09:05:06.174Z",
"updateDate": "2025-12-19T08:03:47.738Z",
"id": "790778769057517568"
},
"msg": "success"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31