Appearance
添加分账方
添加分账方接口传入参数，不同分账通道要求不一样，一般来讲，过备付金的通道只需要提供银行卡四要素信息，而银行通道则要提供更多信息（身份证正反面、手机短信验证码、对公户打款验证等），以下展示参数以银行通道为例
| 请求路径 | /share/holder |
|---|---|
| 请求方法 | POST |
请求参数
（注意！！！分账方接口参数以 WEB“商户控台”->”新增分账方”实际要求的字段为准）
公共参数
| 参数 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| key | 标识 | string | 是 | 开发者唯一标识 |
| time | 时间戳 | string | 是 | 当前 unix 时间戳，精确到秒 |
| sign | 数据签名 | string | 是 | 数据签名，详见 签名算法 |
| data | 业务参数 | JSON | 是 | 业务参数，详见下例表格 |
文件参数
请先使用 文件上传 接口将需要的文件上传，然后使用返回的 文件代码 做为以下参数提交。
| 参数 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| front | 证件正面图 | image | 否 | 证件正面图 |
| back | 证件背面图 | image | 否 | 证件背面图 |
| license | 营业执照图 | image | 否 | 营业执照图 |
| legal_front | 法人证件正面图 | image | 否 | 企业分账方 |
| legal_back | 法人证件背面图 | image | 否 | 企业分账方 |
| card_front | 银行卡正面图 | image | 否 | 银行卡正面图 |
| card_back | 银行卡背面图 | image | 否 | 银行卡背面图 |
| contact_back | 联系人证件反面图 | image | 否 | 联系人证件反面图 |
| contact_front | 联系人证件正面图 | image | 否 | 联系人证件正面图 |
业务参数(企业分账方)
| 参数 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| type | 类型 | enum | 是 | 类型 |
| name | 名称 | string | 是 | 企业名称 |
| alias | 别名 | string | 否 | 别名 |
| idtype | 证件类型 | string | 是 | 企业类型 |
| identity | 证件号码 | string | 是 | 证件编码（如统一信用代码） |
| locates | 地区代码 | [string] | 是 | 地区代码（注册地） |
| locales | 地区名称 | [string] | 是 | 地区名称 |
| legal_name | 法人姓名 | string | 是 | 法人姓名 |
| legal_mobile | 法人手机号码 | string | 是 | 法人手机号码 |
| legal_idtype | 法人证件类型 | string | 是 | 法人证件类型 |
| legal_identity | 法人证件号 | string | 是 | 法人证件号 |
| legal_idvalidity_type | 法人证件过期类型 | enum | 是 | 法人证件过期类型 |
| legal_idvalidity_begin | 法人证件开始时间 | date | 是 | 法人证件开始时间（yyyy-mm-dd） |
| legal_idvalidity_end | 法人证件截止时间 | date | 是 | 法人证件截止时间 |
| idvalidity_type | 证件过期类型 | enum | 是 | 证件过期类型 |
| idvalidity_begin | 证件开始时间 | date | 是 | 证件开始时间 |
| idvalidity_end | 证件过期时间 | date | 是 | 证件过期时间 |
| contact_name | 联系人姓名 | string | 是 | 联系人姓名 |
| contact_idtype | 联系人证件类型 | string | 是 | 联系人证件类型 |
| contact_identity | 联系人证件号 | string | 是 | 联系人证件号 |
| contact_mobile | 联系人手机号 | mobile | 是 | 联系人手机号 |
| contact_email | 联系人邮箱 | 是 | 联系人邮箱 | |
| contact_idvalidity_begin | 联系人证件开始时间 | date | 是 | 联系人证件开始时间 |
| contact_idvalidity_type | 联系人证件过期类型 | enum | 是 | 联系人证件过期类型 |
| contact_idvalidity_end | 联系人证件截止时间 | date | 是 | 联系人证件截止时间 |
| card_belong | 银行卡归属 | string | 是 | 银行卡归属 |
| card_account | 银行卡号/账号 | string | 是 | 银行卡号/账号 |
| card_code | 基本存款账户编号 | string | 是 | 基本存款账户编号 |
| card_name | 银行卡开户名 | string | 是 | 银行卡开户名 |
| card_bank | 银行卡银行 | string | 是 | 银行卡银行 |
| card_branch | 银行卡支行 | string | 是 | 银行卡支行 |
| card_locates | 银行所在地区代码 | [string] | 是 | 银行所在地区代码（省市区编码） |
| card_locales | 银行所在地区名称 | [string] | 是 | 银行所在地区名称（省市区名称） |
| place | 具体地址 | string | 是 | 具体地址 |
| remark | 备注 | string | 否 | 备注 |
| verify | 验证码 | string | 否 | 根据通道需求上送验证码，获取验证码参阅: 分账方获取短信验证码 |
业务参数(个人分账方)
| 参数 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| type | 类型 | enum | 是 | 类型 |
| name | 姓名 | string | 是 | 姓名 |
| idtype | 证件类型 | string | 是 | 证件类型 |
| identity | 身份证号 | string | 是 | 身份证号 |
| idvalidity_type | 证件过期类型 | enum | 是 | 证件过期类型 |
| idvalidity_begin | 证件开始时间 | date | 是 | 证件开始时间 |
| idvalidity_end | 证件过期时间 | date | 是 | 证件过期时间 |
| mobile | 手机号 | string | 是 | 手机号 |
| front | 证件正面图 | image | 是 | 证件正面图 |
| back | 证件背面图 | image | 是 | 证件背面图 |
| card_account | 银行卡号/账号 | string | 是 | 银行卡号/账号 |
| card_name | 银行卡开户名 | string | 是 | 银行卡开户名 |
| card_bank | 银行卡银行 | string | 是 | 银行卡银行 |
| card_branch | 银行卡支行 | string | 否 | 银行卡支行 |
| card_locates | 银行所在地区代码 | [string] | 是 | 银行所在地区代码 |
| card_locales | 银行所在地区名称 | [string] | 是 | 银行所在地区名称 |
| card_mobile | 银行卡预留手机号 | string | 是 | 银行卡预留手机号 |
| verify | 验证码 | string | 否 | 根据通道需求上送验证码，获取验证码参阅: 分账方获取短信验证码 |
请求示例
json
{
"key":"d787d45a68b48",
"data": "{\"alias\":\"名字9250\",\"card_account\":\"6217001210027889250\",\"card_bank\":\"01050000\",\"card_belong\":\"private\",\"card_branch\":\"ddd\",\"card_locales\":[\"上海-上海市-浦东新区\"],\"card_locates\":[\"310000\",\"310100\",\"310115\"],\"card_name\":\"名字\",\"code\":\"H9848953\",\"contact_email\":null,\"contact_mobile\":null,\"contact_name\":null,\"email\":null,\"identity\":\"431202198603102817\",\"idtype\":\"identity\",\"idvalidity_begin\":\"2022-10-13\",\"idvalidity_end\":\"2022-10-13\",\"idvalidity_type\":\"0\",\"legal_identity\":null,\"legal_idtype\":\"identity\",\"legal_idvalidity_begin\":null,\"legal_idvalidity_end\":null,\"legal_idvalidity_type\":\"0\",\"legal_name\":null,\"license\":null,\"locales\":[],\"locates\":[],\"mobile\":\"15802121202\",\"name\":\"名字\",\"place\":null,\"remark\":null,\"state\":\"accept\",\"type\":\"person\"}",
"sign": "e12bb47ee56b859e6ebbb9bedebf...",
"time": 1668674198,
...
}地区(省市区) json 文件
开户银行 excel 文件
开户支行 excel 文件
类型 type
| 标识 | 说明 |
|---|---|
| company | 企业 |
| person | 个人 |
个人证件类型
| 标识 | 说明 |
|---|---|
| identity | 身份证 |
| passport | 护照 |
| officer | 军官证 |
| soldier | 士兵证 |
企业类型
| 标识 | 说明 |
|---|---|
| government | 政府机构 |
| state | 国营企业 |
| private | 私营企业 |
| foreign | 外资企业 |
| individual | 个体工商户 |
| institution | 其他组织 |
| other | 其他 |
证件过期类型
| 标识 | 说明 |
|---|---|
| 0 | 非长期有效 |
| 1 | 长期有效 |
银行卡归属
| 标识 | 说明 |
|---|---|
| public | 对公 |
| private | 对私 |
| notlegal | 法人对私 |
返回数据
公共数据
| 数据 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| code | 状态码 | int | 是 | 结果状态码 |
| text | 操作结果 | string | 否 | 操作结果，为空时不返回此字段 |
| time | 时间戳 | int | 是 | 服务器当前 unix 时间戳，精确到秒 |
| data | 业务数据 | JSON string | 是 | 业务数据，详见下例表格 |
| sign | 数据签名 | string | 是 | 数据签名 |
业务数据
| 参数 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| code | 编码 | string | 是 | 分账方唯一编码 |
| type | 类型 | enum | 是 | 类型 |
| name | 名称 | string | 是 | 名称 |
| alias | 别名 | string | 否 | 别名 |
| mobile | 手机号（个人） | string | 否 | 手机号（个人） |
| 邮箱（个人） | string | 否 | 邮箱（个人） | |
| idtype | 证件类型 | string | 否 | 证件类型 |
| identity | 证件号码 | string | 否 | 证件号码 |
| locates | 地区代码 | [string] | 是 | 地区代码 |
| locales | 地区名称 | [string] | 是 | 地区名称 |
| legal_name | 法人姓名 | string | 否 | 法人姓名 |
| legal_mobile | 法人手机号码 | string | 否 | 法人手机号码 |
| legal_idtype | 法人证件类型 | string | 否 | 法人证件类型 |
| legal_identity | 法人证件号 | string | 否 | 法人证件号 |
| legal_idvalidity_type | 法人证件过期类型 | enum | 否 | 法人证件过期类型 |
| legal_idvalidity_begin | 法人证件开始时间 | date | 否 | 法人证件开始时间 |
| legal_idvalidity_end | 法人证件截止时间 | date | 否 | 法人证件截止时间 |
| idvalidity_type | 证件过期类型 | enum | 否 | 证件过期类型 |
| idvalidity_begin | 证件开始时间 | date | 否 | 证件开始时间 |
| idvalidity_end | 证件过期时间 | date | 否 | 证件过期时间 |
| contact_name | 联系人姓名 | string | 否 | 联系人姓名 |
| contact_idtype | 联系人证件类型 | string | 否 | 联系人证件类型 |
| contact_identity | 联系人证件号 | string | 否 | 联系人证件号 |
| contact_mobile | 联系人手机号 | mobile | 否 | 联系人手机号 |
| contact_email | 联系人邮箱 | 否 | 联系人邮箱 | |
| contact_idvalidity_begin | 联系人证件开始时间 | date | 否 | 联系人证件开始时间 |
| contact_idvalidity_type | 联系人证件过期类型 | enum | 否 | 联系人证件过期类型 |
| contact_idvalidity_end | 联系人证件截止时间 | date | 否 | 联系人证件截止时间 |
| card_belong | 银行卡归属 | string | 否 | 银行卡归属 |
| card_account | 银行卡号/账号 | string | 否 | 银行卡号/账号 |
| card_code | 基本存款账户编号 | string | 否 | 基本存款账户编号 |
| card_name | 银行卡开户名 | string | 否 | 银行卡开户名 |
| card_bank | 银行卡银行 | string | 否 | 银行卡银行 |
| card_branch | 银行卡支行 | string | 否 | 银行卡支行 |
| card_locates | 银行所在地区代码 | [string] | 是 | 银行所在地区代码 |
| card_locales | 银行所在地区名称 | [string] | 是 | 银行所在地区名称 |
| place | 具体地址 | string | 否 | 具体地址 |
| remark | 备注 | string | 否 | 备注 |
| state | 状态 | string | 否 | 状态 |
返回状态
| 状态 | 说明 |
|---|---|
| 0 | 添加成功 |
| 1003001 | 添加失败 |
状态
| 标识 | 说明 |
|---|---|
| pending | 待处理 |
| accept | 已过审 |
| reject | 已拒绝 |
| review | 审核中 |
| card | 打款验证 |