开通金融账户

调用方式: 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	开户人真实手机号;
certImagePaths	必须	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",
    "certImagePaths": ["证件照1path","证件照2path"]
}

返回说明：

返回值字段	字段类型	字段说明
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"
}