Appearance
添加分账方(四要素)
添加分账方接口传入参数，四要素信息版本。
个人：姓名，银行卡，手机号，身份证号。
企业：名称，营业执照号，银行卡，支行。
| 请求路径 | /share/holder/four |
|---|---|
| 请求方法 | POST |
请求参数
公共参数
| 参数 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| key | 标识 | string | 是 | 开发者唯一标识 |
| time | 时间戳 | string | 是 | 当前 unix 时间戳，精确到秒 |
| sign | 数据签名 | string | 是 | 数据签名，详见 签名算法 |
| data | 业务参数 | JSON | 是 | 业务参数，详见下例表格 |
业务参数(个人分账方)
| 参数 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| type | 类型 | enum | 是 | 类型，个人分person，企业company |
| name | 姓名 | string | 是 | 姓名 |
| identity | 身份证号 | string | 是 | 身份证号 |
| card_account | 银行卡号/账号 | string | 是 | 银行卡号/账号 |
| card_bank | 银行卡银行 | string | 是 | 银行卡银行 |
| card_mobile | 银行卡预留手机号 | string | 是 | 银行卡预留手机号 |
| remark | 备注 | string | 否 | 备注 |
业务参数(企业分账方)
| 参数 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| type | 类型 | enum | 是 | 类型 |
| name | 名称 | string | 是 | 企业名称 |
| idtype | 证件类型 | string | 是 | 企业类型 |
| identity | 证件号码 | string | 是 | 证件编码（如统一信用代码） |
| contact_mobile | 联系人手机号 | mobile | 是 | 联系人手机号 |
| card_belong | 银行卡归属 | string | 是 | 银行卡归属 |
| card_account | 银行卡号/账号 | string | 是 | 银行卡号/账号 |
| card_bank | 银行卡银行 | string | 是 | 银行卡银行 |
| card_branch | 银行卡支行 | string | 是 | 银行卡支行 |
| remark | 备注 | string | 否 | 备注 |
请求示例
json
{
"data": "{\"card_account\":\"12349792749119234\",\"card_bank\":\"01040000\",\"card_mobile\":\"18516603807\",\"identity\":\"342401199010135275\",\"name\":\"H5683635\",\"type\":\"person\"}",
"key": "d4247ed86e99865b93a",
"sign": "517db03df9156a6fa1f34b34f73d715ffd8fc7ef946aaaae908156bf6e662d7c",
"time": 1789710996
}开户银行 excel 文件
开户支行 excel 文件
类型 type
| 标识 | 说明 |
|---|---|
| company | 企业 |
| person | 个人 |
个人证件类型 idtype
| 标识 | 说明 |
|---|---|
| identity | 身份证 |
企业类型 idtype
| 标识 | 说明 |
|---|---|
| private | 私营企业 |
| government | 政府机构 |
| state | 国营企业 |
| foreign | 外资企业 |
| individual | 个体工商户 |
| institution | 其他组织 |
| other | 其他 |
银行卡归属 card_belong
| 标识 | 说明 |
|---|---|
| public | 对公户 |
| public_settle | 单位结算卡 |
返回数据
公共数据
| 数据 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| code | 状态码 | int | 是 | 结果状态码 |
| text | 操作结果 | string | 否 | 操作结果，为空时不返回此字段 |
| time | 时间戳 | int | 是 | 服务器当前 unix 时间戳，精确到秒 |
| data | 业务数据 | JSON string | 是 | 业务数据，详见下例表格 |
| sign | 数据签名 | string | 是 | 数据签名 |
业务数据
| 参数 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| code | 编码 | string | 是 | 分账方唯一编码 |
| type | 类型 | enum | 是 | 类型 |
| name | 名称 | string | 是 | 名称 |
| idtype | 证件类型 | string | 否 | 证件类型 |
| identity | 证件号码 | string | 否 | 证件号码 |
| contact_mobile | 联系人手机号 | mobile | 否 | 联系人手机号 |
| card_belong | 银行卡归属 | string | 否 | 银行卡归属 |
| card_account | 银行卡号/账号 | string | 否 | 银行卡号/账号 |
| card_mobile | 银行卡预留手机号 | string | 否 | 银行卡预留手机号 |
| card_name | 银行卡开户名 | string | 否 | 银行卡开户名 |
| card_bank | 银行卡银行 | string | 否 | 银行卡银行 |
| card_branch | 银行卡支行 | string | 否 | 银行卡支行 |
| remark | 备注 | string | 否 | 备注 |
| state | 状态 | string | 否 | 状态 |
返回状态
| 状态 | 说明 |
|---|---|
| 0 | 添加成功 |
| 1003001 | 添加失败 |
状态
| 标识 | 说明 |
|---|---|
| pending | 待处理 |
| accept | 已过审 |
| reject | 已拒绝 |
| review | 审核中 |
| card | 打款验证 |