Appearance
分账方查询
分账方查询接口
| 请求路径 | /share/holder/query |
|---|---|
| 请求方法 | POST |
请求参数
公共参数
| 参数 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| key | 标识 | string | 是 | 开发者唯一标识 |
| time | 时间戳 | string | 是 | 当前 unix 时间戳，精确到秒 |
| sign | 数据签名 | string | 是 | 数据签名，详见 签名算法 |
| data | 业务参数 | JSON string | 是 | 业务参数，详见下例表格 |
业务参数
| 参数 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| code | 分账方编码 | string | 否 | 分账方编码 |
请求示例
json
{
"key": "d787d45a68b486b2e93",
"time": 1668492908,
"sign": "ab2db27c6f80a8291871b5af373998...",
"data": "{\"code\":\"H6464949\"}"
}返回数据
公共数据
| 数据 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| code | 状态码 | int | 是 | 结果状态码 |
| text | 操作结果 | string | 否 | 操作结果，为空时不返回此字段 |
| time | 时间戳 | int | 是 | 服务器当前 unix 时间戳，精确到秒 |
| data | 业务数据 | JSON string | 是 | 业务数据，详见下例表格 |
| sign | 数据签名 | string | 是 | 数据签名 |
业务数据
| 数据 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| alias | 别名 | string | 否 | 别名 |
| back | 证件背面图 | string | 否 | 证件背面图 |
| card_account | 银行卡号/帐号 | string | 否 | 银行卡号/帐号 |
| card_back | 银行卡背面图 | string | 否 | 银行卡背面图 |
| card_bank | 银行卡银行 | string | 否 | 银行卡银行 |
| card_belong | 银行卡归属 | string | 否 | 银行卡归属 |
| card_branch | 银行卡支行 | string | 否 | 银行卡支行 |
| card_front | 银行卡正面图 | string | 否 | 银行卡正面图 |
| card_locales | 银行所在地区名称 | [string] | 是 | 银行所在地区名称 |
| card_locates | 银行所在地区代码 | [string] | 是 | 银行所在地区代码 |
| card_name | 银行卡开户名 | string | 否 | 银行卡开户名 |
| code | 分账方编码 | string | 否 | 分账方编码 |
| contact_email | 联系人邮箱 | 否 | 联系人邮箱 | |
| contact_mobile | 联系人手机号 | mobile | 否 | 联系人手机号 |
| contact_name | 联系人姓名 | string | 否 | 联系人姓名 |
| 邮箱（个人） | string | 否 | 邮箱（个人） | |
| identity | 证件号码 | string | 否 | 证件号码 |
| idtype | 证件类型 | string | 否 | 证件类型 |
| idvalidity_begin | 证件开始时间 | date | 否 | 证件开始时间 |
| idvalidity_end | 证件过期时间 | date | 否 | 证件过期时间 |
| idvalidity_type | 证件过期类型 | enum | 否 | 证件过期类型，详见下表 |
| legal_back | 法人证件背面图 | string | 否 | 法人证件背面图 |
| legal_front | 法人证件正面图 | string | 否 | 法人证件正面图 |
| legal_identity | 法人证件号 | string | 否 | 法人证件号 |
| legal_idtype | 法人证件类型 | string | 否 | 法人证件类型 |
| legal_idvalidity_begin | 法人证件开始时间 | date | 否 | 法人证件开始时间 |
| legal_idvalidity_end | 法人证件截止时间 | date | 否 | 法人证件截止时间 |
| legal_idvalidity_type | 法人证件过期类型 | enum | 否 | 法人证件过期类型，详见下表 |
| legal_name | 法人姓名 | string | 否 | 法人姓名 |
| license | 营业执照图 | string | 否 | 营业执照图 |
| locales | 地区名称 | [string] | 是 | 地区名称 |
| locates | 地区代码 | [string] | 是 | 地区代码 |
| mobile | 手机号（个人） | string | 否 | 手机号（个人） |
| name | 名称 | string | 是 | 名称 |
| place | 具体地址 | string | 是 | 具体地址 |
| remark | 备注 | string | 是 | 备注 |
| state | 状态 | string | 是 | 状态，详见下表 |
| providers | 收单机构列表 | [json] | 是 | 收单机构列表，详见下表 |
| type | 类型 | string | 是 | 类型，详见下表 |
| reason | 分账方开通失败原因 | string | 否 | 当状态是reject时返回失败原因 |
返回状态
| 状态 | 说明 |
|---|---|
| 0 | 查询成功 |
| 1003001 | 查询失败 |
| 1002012 | 无效分账方 |
证件过期类型
| 标识 | 说明 |
|---|---|
| 0 | 非长期有效 |
| 1 | 长期有效 |
状态
| 标识 | 说明 |
|---|---|
| accept | 已过审 |
| pending | 待处理 |
| reject | 已拒绝 |
| review | 审核中 |
收单机构列表
| 参数 | 名称 | 类型 |
| code | 编码 | string |
| fullname | 全名 | string |
| id | 编号 | int |
| index | 排序 | int |
| name | 名称 | string |
| symbol | 标识 | string |
| channel | 收单机构渠道 | json |
收单机构渠道
| 参数 | 名称 | 类型 |
| id | id | int |
| name | 名称 | string |
| symbol | 标识 | string |
类型
| 标识 | 说明 |
|---|---|
| company | 企业 |
| person | 个人 |