开通金融账户

调用方式: POST

接口地址:

https://api.freelog.com/v3/transactions/accounts

body传入参数说明:

参数	必选	类型及范围	说明
accountType	必选	int	账户类型(1:个人账户 2:节点账户)
ownerId	必选	int	账户所有者ID; 根据账户类型动态赋值userId或nodeId
certType	必选	string	证件类型(00:身份证)
certNo	必选	string	证件号码;例如身份证号
name	必选	string	证件上的名称;例如身份证上的姓名
certValidityType	必选	int	证件有效期是否是长期; 0:非长期有效 1:长期有效
certBeginDate	必须	string	证件有效期开始日期
certEndDate	可选	string	证件有效期结束日期(长期有效时此处不传)
mobile	必须	string	开户人真实手机号;
certImagePath	必须	string	证件照保密存放的path部分; 身份证号码识别接口会返回

body示例

{
    "accountType": 1,
    "ownerId": 50017,
    "certType": "00",
    "certNo": "420625XXXXXXXXXXXX",
    "name": "余XX",
    "certValidityType": 0,
    "certBeginDate": "2022-XX-XX",
    "certEndDate": "2042-XX-XX",
    "mobile": "189XXXXXXXX",
    "certImagePath": "temp"
}

返回说明：

返回值字段	字段类型	字段说明
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:冻结

示例

{
  "ret": 0,
  "errCode": 0,
  "data": {
    "id": "790778769057517568",
    "accountType": 1,
    "ownerId": 50017,
    "ownerName": "yuliang",
    "ownerUserId": 50017,
    "ownerUserName": "yuliang",
    "currencyType": 1,
    "totalBalance": 0,
    "availableBalance": 0,
    "freezeBalance": 0,
    "status": 1,
    "createDate": "2025-12-10T09:05:06.174Z",
    "updateDate": "2025-12-10T09:05:06.731Z"
  },
  "msg": "success"
}