商户对接接口
# 商户对接接口文档
# 一、文档概述
# 1、对接须知
(1)联系商务申请测试环境数据;
(2)接口调用顺序:按照四、接口列表从上向下调用,所有接口均须对接;
(3)使用前请注意区分生产环境和测试环境;
(4)生产环境接口及参数将在整体接口验收通过且风控审核通过后提供;
(5)若您有特殊需求请联系商务申请。
(6)如无特殊说明:单接口请求并发限制为5次/秒,请求间隔须超过200ms
# 二、业务流程
1、查询园区,可查询到企业绑定的所有园区ID、园区名称及园区可发放额度。
2、查询发票类目,可查询到发票类目ID及发票内容。
3、查询任务模板,上传发票类目ID获取任务模板信息数据。
4、创建任务,获取任务ID,任务ID可用于任务派发、任务验收、确认汇款金额、支付及重试打款操作。
5、新增用户,进行用户认证,认证通过方可进行任务派发。
6、查询用户认证状态,查询用户最新的认证状态。
7、上传分包名单,获得分包名单批次号,批次号可用于任务派发、任务验收操作。
8、任务派发,上传任务ID、园区ID、分包名单批次号进行任务派发,任务派发成功后方可进行任务验收。
9、任务验收,上传任务ID进行任务验收
10、确认结算金额,上传任务ID确认汇款金额
11、众包费用支付,上传orderID和taskID进行单笔支付;上传taskID进行批量支付。
12、获取支付结果,完成支付后可上传任务ID获取支付状态。
13、重试打款,支付结果显示支付失败后,可重试打款,再次发起支付请求。
# 三、通用信息
# 1、验签demo(点击下载)
https://yun.jinglingyunxiang.com/var/upload/demo.java (opens new window)
# 2、环境地址
名称 | 地址 |
---|---|
测试环境 | https://devyun.jinglingyunxiang.com/ (opens new window) |
生产环境 | https://yun.jinglingyunxiang.com/ (opens new window) |
# 四、接口列表
# 1、查询园区
# (1)接口描述
根据上传企业唯一标识码及验签串查询该商户账号所绑定的园区列表,及园区月度发放限额。
# (2)请求URL
/task_platform/lhyg/selectPark?identification= &sign=
# (3)请求方式
GET
# (4)请求参数
Params参数说明(URL拼接):
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
identification | 是 | string | 企业唯一标识 |
sign | 是 | string | 验签串 |
# (5)返回参数说明
参数名 | 类型 | 说明 |
---|---|---|
success | Boolean | 请求是否成功 |
message | String | 请求是否成功 |
code | Integer | 请求码 |
data | List | 返回内容 |
data参数说明:
参数名 | 类型 | 说明 |
---|---|---|
idparkId | int | 园区ID |
parkName | String | 园区名称 |
quota | BigDecimal | 园区月度发放限额 |
# (6)返回示例
{
"success": true,
"message": "succeed",
"code": 200,
"data": [
{
"parkId": 24,
"parkName": "湖南来来信息科技有限公司",
"quota": 0
},
{
"parkId": 27,
"parkName": "九江鼎高信息技术有限公司",
"quota": 0
},
{
"parkId": 25,
"parkName": "九江蝉灵科技有限公司",
"quota": 0
}
]
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
# 2、查询发票类目
# (1)接口描述
查询园区的可开发票类目(对应创建任务的需求类型),返回信息用于创建任务
# (2)请求URL
/task_platform/lhyg/selectCategory?identification= &sign=
# (3)请求方式
GET
# (4)请求参数
Params参数说明(URL拼接):
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
identification | 是 | String | 企业唯一标识 |
sign | 是 | String | 验签串 |
# (5)返回参数
参数名 | 类型 | 说明 |
---|---|---|
success | Boolean | 请求是否成功 |
message | String | 请求是否成功 |
code | Integer | 请求码 |
data | List | 返回内容 |
data参数说明:
参数名 | 类型 | 说明 |
---|---|---|
invoiceId | string | 发票类目ID |
content | string | 发票类目内容 |
# (6)返回示例
{
"success": true,
"message": "succeed",
"code": 200,
"data": [
{
"content": "*现代服务*市场推广费",
"invoiceId": 1092
},
{
"content": "*现代服务*服务费",
"invoiceId": 1134
},
{
"content": "*生活服务*保洁服务",
"invoiceId": 805
},
{
"content": "*文化服务*文化策划服务费",
"invoiceId": 855
},
{
]
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
# 3、查询任务模板
# (1)接口描述
查询发票类目下的任务模板,返回信息可用于创建任务(若您要使用的类目下没有模板信息,请通过商户平台-模板管理,创建符合实际业务的任务模板,同一类目,模板仅需创建一次,后续可直接使用)。
# (2)请求URL
/task_platform/lhyg/selectCategoryInfo?invoiceId= &sign=
# (3)请求方式
GET
# (4)请求参数
Params参数说明(URL拼接):
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
invoiceId | 是 | string | 发票类目ID |
sign | 是 | string | 验签串 |
# (5)返回参数
参数名 | 类型 | 说明 |
---|---|---|
success | Boolean | 请求是否成功 |
message | String | 请求是否成功 |
code | Integer | 请求码 |
data | List | 返回内容 |
data参数说明:
参数名 | 类型 | 说明 |
---|---|---|
id | Integer | 任务模版ID |
taskType | String | 需求标题 |
description | String | 需求描述 |
typeid | Integer | 发票类目ID |
thirdInfoId | Integer | 园区ID |
# (6)返回示例
{
"success": true,
"message": "succeed",
"code": 200,
"data": [
{
"id": 1127,
"taskType": "公司活动策划",
"description": "公司组织活动庆典仪式、活动现场布置等",
"typeid": 855,
"thirdInfoId": 37
}
]
}
2
3
4
5
6
7
8
9
10
11
12
13
14
# 4、创建任务
# (1)接口描述
按照实际业务场景,创建符合业务要求及平台规范的任务,其中涉及业务实际发生地,请联系技术支持获取对应地区ID
# (2)请求URL
/task_platform/lhyg/createTask?identification= &sign=
# (3)请求方式
POST JSON
# (4)请求参数
Params参数说明(URL拼接):
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
identification | 是 | String | 企业唯一标识 |
sign | 是 | String | 验签串 |
Body参数说明:
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
name | 是 | String | 任务标题(填写查询的模板ID对应的taskType) |
description | 是 | String | 描述(填写查询的模板ID对应的description) |
budget | 是 | BigDecimal | 预算金额 |
enrollEndTime | 是 | Date | 报名截止时间(yyyy-MM-dd HH:mm:ss) |
enrollStartTime | 是 | Date | 报名开始时间 |
endTime | 是 | Date | 任务结束时间 |
startTime | 是 | Date | 任务开始时间 |
checkTime | 否 | Integer | 验收时间 |
checkTimeUnit | 是 | Integer | 验收时间单位:1:每日,2:每时,3:每分 |
demand | 是 | String | 任务要求 |
workingPlace | 是 | String | 任务地点 |
enrollNum | 是 | Integer | 需求人数 |
remark | 否 | String | 备注 |
taxType | 是 | Integer | 发票类目ID(调用2、查询发票类目返回的invoiceId) |
principalId | 是 | String | 地区id(联系技术获取固定值) |
titleid | 是 | Integer | 任务模板ID(调用3、查询任务模板返回的ID) |
settlementsId | 是 | Integer | 1-平安银行; 2-支付宝; 4、招商银行;5、南京银行 6、银联 |
thirdInfoId | 是 | Integer | 园区id |
# (5)请求示例
{
"name":"任务标题",
"description":"任务描述",
"budget":70000,
"enrollEndTime":"2022-5-13 12:00:00",
"enrollStartTime":"2022-5-11 12:00:00",
"endTime":"2022-5-13 12:00:00",
"startTime":"2022-5-11 12:00:00",
"checkTime":1,
"checkTimeUnit":1,
"demand":"任务要求",
"workingPlace":"全国,全省市",
"enrollNum":10000,
"remark":"备注",
"taxType": 29,
"principalId":"1,3409",
"titleid":41,
"settlementsId":4,
"thirdInfoId":26
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
# (6)返回参数
参数名 | 类型 | 说明 |
---|---|---|
success | Boolean | 请求是否成功 |
message | String | 请求是否成功 |
code | Integer | 请求码 |
data | Object | 返回内容 |
data参数说明:
参数名 | 类型 | 说明 |
---|---|---|
taskId | Integer | 任务ID |
# (7)返回示例
{
"success": true,
"message": "succeed",
"code": 200,
"data": {
"taskId": 19314
}
}
2
3
4
5
6
7
8
# 5、新增用户
# (1)接口描述
通过此接口为自由职业者进行认证。如果用户已存在,可自行选择跳过此条信息或重新为自由职业者进行认证;本接口需要您自行处理服务协议签约,将个人签署完成的服务协议PDF文件URL传输至我方;请确保身份证正反面、协议文件的URL可在公网访问、下载。
点击下载共享经济合作伙伴协议 (opens new window)协议模版文件。
# (2)请求URL
/task_platform/lhyg/importUsers?identification=&sign=&flag=
# (3)请求方式
POST JSON
# (4)请求参数
Params参数说明(URL拼接):
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
identification | 是 | string | 企业唯一标识 |
sign | 是 | string | 验签串 |
flag | 是 | Integer | 个人信息重复处理规则:1-覆盖 2-跳过 |
Body参数说明(list,支持批量新增):
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
name | 是 | String | 姓名 |
idcard | 是 | String | 身份证 |
phone | 是 | String | 手机号 |
bankcard | 是 | String | 银行卡 |
bank | 是 | String | 银行名称,按照附件表 (opens new window)匹配银行名称(bank_name字段) |
idcardType | 否 | String | 证件照片是复印件还是扫描件:1:扫描件 2:复印件 |
idcardUrl1 | 否 | String | 身份证正面照片的下载链接 |
idcardUrl2 | 否 | String | 身份证反面照片的下载链接 |
serviceUrl | 否 | String | 服务协议文件的下载链接;(请联系商务获取) |
dataLevel | 是 | String | 资料级别:详见下方说明 |
资料级别说明:
1:四要素信息+证件照片+协议(需要进行人工审核)
2:四要素信息+证件照片(验证通过直接放入正式用户库并且更新用户状态为已认证)
3:四要素信息(验证通过直接放入正式用户库并且更新用户状态为已认证)
4、四要素信息+协议(需要人工审核)
当资料级别为1、2时,证件照片类型、身份证正面照片、身份证反面照片等字段必填
当资料级别为1、4时,服务协议字段必填
# (5)请求示例
[
{
"serviceUrl": "https://devyun.jinglingyunxiang.com/var/upload/logo.png",
"idcardUrl1": "https://devyun.jinglingyunxiang.com/var/upload/sj/1.jpg",
"bank": "",
"idcardUrl2": "https://devyun.jinglingyunxiang.com/var/upload/sj/2.jpg",
"phone": "144100000040",
"idcard": "62052133254501562",
"name": "张三",
"idcardType": 1,
"bankcard": "6214680050202222",
"dataLevel": 1
}
]
2
3
4
5
6
7
8
9
10
11
12
13
14
# (6)返回参数
参数名 | 类型 | 说明 |
---|---|---|
success | Boolean | 请求是否成功 |
message | String | 请求是否成功 |
code | Integer | 请求码 |
data | Object | 用户信息处理结果 |
# (7)返回示例
{
"success": true,
"message": "succeed",
"code": 200,
"data": "用户总数:1人,成功录入:1人,失败录入:0人"
}
2
3
4
5
6
# 6、查询用户认证状态
# (1)接口描述
提交用户资料后,可通过身份证号查询用户认证状态。
# (2)请求URL
/task_platform/lhyg/getUserStatus?sign= &identification=
# (3)请求方式
POST JSON
# (4)请求参数
Params参数说明(URL拼接):
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
identification | 是 | String | 企业唯一标识 |
sign | 是 | String | 验签串 |
Body参数说明:
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
idCardList | 是 | List | 个人身份证号列表 |
# (5)请求示例
{
"idCardList": [
"42032219600118042X",
"420322196001180422"
]
}
2
3
4
5
6
# (6)返回参数
参数名 | 类型 | 说明 |
---|---|---|
success | Boolean | 请求是否成功 |
message | String | 请求是否成功 |
code | Integer | 请求码 |
data | List | 用户认证信息详情 |
data参数说明:
参数名 | 类型 | 说明 |
---|---|---|
phone | String | 用户手机号码 |
idcard | String | 用户身份证号 |
name | String | 用户姓名 |
stuts | String | 个人认证状态: 1、待审核、3、审核通过、4、审核驳回 10、待扫码签约 |
remark | String | 驳回原因 |
message | String | 状态文字说明 |
# (7)返回示例
{
"success": True,
"message": "succeed",
"code": 200,
"data": [
{
"phone": "17624018035",
"idcard": "42032219600118042X",
"name": "祖起",
"stuts": 3,
"remark": "",
"message": "审核通过"
}
]
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# 7、上传分包名单
# (1)接口描述
上传个人下发明细名单,包含个人姓名、身份证号、工作内容、下发金额等信息,上传过程中整批数据需严格按照格式规范及确保信息正确才能上传成功,上传前请确认个人已认证通过,避免影响下发流程。
# (2)请求URL
/task_platform/lhyg/taskUserUpload?identification=&sign=
# (3)请求方式
POST JSON
# (4)请求参数
Params参数说明(URL拼接):
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
identification | 是 | String | 企业唯一标识 |
sign | 是 | String | 验签串 |
Body参数说明:
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
file | 是 | mulipartFile | 分包名单文件:点击下载《模板文档 (opens new window) "模板文档")》 |
parkId | 是 | Integer | 园区ID |
# (5)返回参数
参数名 | 类型 | 说明 |
---|---|---|
success | Boolean | 请求是否成功 |
message | String | 请求是否成功 |
code | Integer | 请求码 |
data | Integer | 分包名单批次号(请保存) |
# (6)返回示例
{
"success": true,
"message": "succeed",
"code": 200,
"data": 8061
}
2
3
4
5
6
# 8、任务派发
# (1)接口描述
通过上传批次号,任务号(taskId),将该任务派发给该批次上传的用户。
# (2)请求URL
/task_platform/lhyg/taskDistribution?identification=&sign=
POST JSON
# (4)请求参数
Params参数说明(URL拼接):
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
identification | 是 | String | 企业唯一标识 |
sign | 是 | String | 验签串 |
Body参数说明:
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
taskId | 是 | Integer | 任务Id |
parkId | 是 | integer | 园区ID |
batch | 是 | Integer | 批次号 |
# (5)请求示例
{
"taskId":17139,
"parkId":55,
"batch":8060
}
2
3
4
5
# (6)返回参数
参数名 | 类型 | 说明 |
---|---|---|
success | Boolean | 请求是否成功 |
message | String | 请求是否成功 |
code | Integer | 请求码 |
data | Object | 返回内容 |
# (7)返回示例
{
"success": true,
"message": "succeed",
"code": 200,
"data": "任务派发成功"
}
2
3
4
5
6
# 9、任务验收
# (1)接口描述
针对派发给个人的任务进行验收,目前仅支持一键验收,若任务中存在多条个人任务,请通过结算金额确认接口,确认下发人数,下发金额、个人对应金额等信息是否正确
# (2)请求URL
/task_platform/lhyg/taskAcceptance?identification=&sign=&taskId=
# (3)请求方式
GET
# (4)请求参数
Params参数说明(URL拼接):
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
identification | 是 | String | 企业唯一标识 |
sign | 是 | String | 验签串 |
taskId | 是 | Integer | 任务ID |
# (5)返回参数
参数名 | 类型 | 说明 |
---|---|---|
success | Boolean | 请求是否成功 |
message | String | 请求是否成功 |
code | Integer | 请求码 |
data | Integer | 返回内容 |
# (6)返回示例
{
"success": true,
"message": "succeed",
"code": 200,
"data": null
}
2
3
4
5
6
# 10、结算金额确认
# (1)接口描述
对已验收个人任务的结算金额进行确认,确认无误后,请通过线下转账的方式向平台子账户充值(提前充值可忽略此步骤)。
# (2)请求URL
/task_platform/lhyg/confirmedAmount?identification=&sign=&taskId=
# (3)请求方式
GET
# (4)请求参数
Params参数说明(URL拼接):
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
identification | 是 | String | 企业唯一标识 |
sign | 是 | String | 验签串 |
taskId | 是 | Integer | 任务ID |
# (5)返回参数
参数名 | 类型 | 说明 |
---|---|---|
success | Boolean | 请求是否成功 |
message | String | 请求是否成功 |
code | Integer | 请求码 |
data | List | 个人下发明细数据 |
data参数说明:
参数名 | 类型 | 说明 |
---|---|---|
name | String | 个人姓名 |
idCard | String | 个人身份证号 |
meal | String | 个人工作内容 |
wages | BigDecimal | 个人佣金(元) |
servicerate | BigDecimal | 点位(%) |
fees | BigDecimal | 服务费(元) |
orderId | Integer | 个人任务ID(用于单笔支付和重试打款) |
# (6)返回示例
{
"success": true,
"message": "succeed",
"code": 200,
"data": [
{
"name": "吴极客",
"idCard": "211000200002027278",
"meal": "WORK",
"wages": 100,
"servicerate": 10,
"fees": 10,
"orderId": 126289
}
]
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# 11、众包费用支付
# (1)接口描述
针对个人已完成的任务进行支付众包佣金,可单独支付某个自由职业者的佣金或一键支付当前任务中所有待支付的所有佣金
# (2)请求URL
/task_platform/lhyg/taskPay?identification=&sign=
# (3)请求方式
POST JSON
# (4)请求参数
Params参数说明(URL拼接):
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
identification | 是 | String | 企业唯一标识 |
sign | 是 | String | 验签串 |
Body参数说明:
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
orderId | 否 | Integer | 个人任务ID:通过结算金额确认接口返回的orderId+任务ID可以单笔支付 |
taskId | 是 | Integer | 只入taskId则一键支付 |
# (5)请求示例
{
"orderId":126289, //通过确认汇款接口返回的orderId+任务ID可以单笔支付
"taskId":17222 //只入taskId则一键支付
}
2
3
4
# (6)返回参数
参数名 | 类型 | 说明 |
---|---|---|
success | Boolean | 请求是否成功 |
message | String | 请求是否成功 |
code | Integer | 请求码 |
data | Integer |
# (7)返回示例
{
"success": true,
"message": "succeed",
"code": 200,
"data": null
}
2
3
4
5
6
# 12、获取支付结果
# (1)接口描述
提交支付后,可通过此接口,获取支付订单的打款结果(目前仅支持批量获取)。
# (2)请求URL
/task_platform/lhyg/getPayResult?identification=&sign=&taskId=
# (3)请求方式
GET
# (4)请求参数
Params参数说明(URL拼接):
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
identification | 是 | String | 企业唯一标识 |
sign | 是 | String | 验签串 |
taskId | 是 | Integer | 任务ID |
# (5)返回参数
参数名 | 类型 | 说明 |
---|---|---|
success | Boolean | 请求是否成功 |
message | String | 请求是否成功 |
code | Integer | 请求码 |
data | List | 个人订单详情 |
data参数说明:
参数名 | 类型 | 说明 |
---|---|---|
id | String | 订单ID |
receivablesName | String | 收款人 |
receivingAccount | Integer | 收款银行账号 |
receivingBankName | String | 收款银行名称 |
idCard | String | 收款人身份证号 |
phone | String | 收款人联系电话 |
amounts | String | 打款金额 |
stuts | Integer | 支付状态:1:未支付;2:支付成功;3:支付失败;4:删除;5:未知(银行处理中,非最终结果); |
statusMessage | String | 状态描述 |
failMessage | String | 错误原因 |
# (6)返回示例
{
"success": true,
"message": "succeed",
"code": 200,
"data": [
{
"id": 126289,
"receivablesName": "吴极客",
"amounts": 100,
"receivingAccount": "6214831150131511",
"receivingBankName": "中国银行",
"idCard": "211000200002027278",
"phone": "17625019034",
"status": 5,//1:未支付;2:支付成功;3:支付失败;4:删除;5:未知(银行处理中,非最终结果)
"failMessage": "",
"statusMessage": "未知"
}
]
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
# 13、重试打款
# (1)接口描述
若通过查询接口确认个人支付失败后,请根据失败原因检查对应的信息(个人信息错误、银行卡信息等),调整信息完成后,可调用此接口进行重试操作(重试时系统会自动获取个人的最新信息,提交至银行)。
# (2)请求URL
/task_platform/lhyg/taskPayRetry?identification=&sign=
# (3)请求方式
POST JSON
# (4)请求参数
Params参数说明(URL拼接):
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
identification | 是 | String | 企业唯一标识 |
sign | 是 | String | 验签串 |
Body参数说明:
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
orderId | 是 | Integer | 个人任务ID:通过查询支付结果接口返回的Id |
taskId | 是 | Integer | 任务ID |
# (5)请求示例
{
"orderId":126289,
"taskId":17222
}
2
3
4
# (6)返回参数
参数名 | 类型 | 说明 |
---|---|---|
success | Boolean | 请求是否成功 |
message | String | 请求是否成功 |
Code | Integer | 请求码 |
data | Integer | 处理结果消息 |
# (7)返回示例
{
"success": true,
"message": "succeed",
"code": 200,
"data": "重新打款成功"
}
2
3
4
5
6
# 14、新增用户(返回签约地址)
# (1)接口描述
通过此接口为自由职业者进行认证。如果用户已存在,可自行选择跳过此条信息或重新为自由职业者进行认证;本接口会返回个人签署协议地址
# (2)请求URL
/task_platform/lhyg/importUsersForServicePdf?identification=&sign=
# (3)请求方式
POST JSON
# (4)请求参数
Params参数说明(URL拼接):
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
identification | 是 | string | 企业唯一标识 |
sign | 是 | string | 验签串 |
flag | 是 | Integer | 个人信息重复处理规则:1-覆盖 2-跳过 |
Body参数说明(list,支持批量新增):
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
name | 是 | String | 姓名 |
idcard | 是 | String | 身份证号 |
phone | 是 | String | 手机号 |
bankcard | 是 | String | 银行卡号 |
bank | 是 | String | 银行名称,按照附件表 (opens new window)匹配银行名称(bank_name字段) |
idcardType | 否 | String | 证件照片是复印件还是扫描件:1:扫描件 2:复印件 |
idcardUrl1 | 否 | String | 身份证正面照片的下载链接 |
idcardUrl2 | 否 | String | 身份证反面照片的下载链接 |
dataLevel | 是 | String | 资料级别: |
notityUrl | 是 | String | 用户认证状态通知地址 |
资料级别说明:
1:四要素信息+证件照片+协议(需要进行人工审核)
2:四要素信息+证件照片(验证通过直接放入正式用户库并且更新用户状态为已认证)
3:四要素信息(验证通过直接放入正式用户库并且更新用户状态为已认证)
4、四要素信息+协议(需要人工审核):
当资料级别为1、2时,证件照片类型、身份证正面照片、身份证反面照片等字段必填
当资料级别为1、4时,服务协议字段必填
# (5) 请求示例
[
{
"idcardUrl1": "https://devyun.jinglingyunxiang.com/var/upload/sj/1.jpg",
"bank": "",
"idcardUrl2": "https://devyun.jinglingyunxiang.com/var/upload/sj/2.jpg",
"phone": "144100000040",
"idcard": "62052133254501562",
"name": "张三",
"idcardType": 1,
"bankcard": "6214680050202222",
"dataLevel": 4,
"notityUrl":"https://devyun.jinglingyunxiang.com/var/upload/sj"
}
]
2
3
4
5
6
7
8
9
10
11
12
13
14
# (5)返回参数说明
参数名 | 类型 | 说明 |
---|---|---|
success | Boolean | 请求是否成功 |
message | String | 请求是否成功 |
code | Integer | 请求码 |
data | List | 用户签约地址列表 |
data参数说明:
参数名 | 类型 | 说明 |
---|---|---|
id | Integer | 用户ID |
name | String | 姓名 |
idcard | String | 身份证号 |
signature | String | 签约地址 |
# (6)返回示例
{
"success": true,
"message": "succeed",
"code": 200,
"data": [
{
"id": 38854,
"name": "张三",
"idcard": "411525200135648695",
"signature": "https://devyun.jinglingyunxiang.com/service_agreement_signing?userInfo=38854"
}
]
}
2
3
4
5
6
7
8
9
10
11
12
13
# 15、用户认证状态通知
# (1)接口描述
用户签约完成后,向【14、新增用户】传输的notityUrl地址推送用户签约结果
# (2)请求方式
POST JSON
# (3)请求参数
Params参数说明(URL拼接):
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
identification | 是 | String | 企业唯一标识 |
sign | 是 | String | 验签串 |
Body参数说明:
参数名 | 必选 | 类型 |
---|---|---|
phone | String | 用户手机号码 |
idcard | String | 用户身份证号 |
name | String | 用户姓名 |
stuts | String | 个人认证状态: 1-待审核;3-审核通过;4-审核驳回;10-待扫码签约 |
remark | String | 驳回原因 |
message | String | 状态文字说明 |
# (4)请求示例
{
"phone": "17600617885",
"idcard": "411525200135648695",
"name": "张三",
"stuts": "3",
"message":"",
"remark":""
}
2
3
4
5
6
7
8
# 16、查询用户认证信息
# (1)接口描述
提交用户信息进行认证后,可批量查询用户认证状态。
# (2)请求URL
/task_platform/lhyg/getUserListStatus?sign= &identification=
# (3)请求方式
POST JSON
# (4)请求参数
Params参数说明(URL拼接):
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
identification | 是 | String | 企业唯一标识 |
sign | 是 | String | 验签串 |
Body参数说明:
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
page | 是 | Integer | 页数 |
size | 是 | Integer | 条数 |
# (5)请求示例
{
"page": 1,
"size": 10
}
2
3
4
# (6)返回参数
参数名 | 类型 | 说明 |
---|---|---|
success | Boolean | 请求是否成功 |
message | String | 请求是否成功 |
code | Integer | 请求码 |
data | List | 用户认证信息详情 |
data参数说明:
参数名 | 类型 | 说明 |
---|---|---|
phone | String | 用户手机号码 |
idcard | String | 用户身份证号 |
name | String | 用户姓名 |
stuts | String | 个人认证状态: 1-待审核;3-审核通过;4-审核驳回;10-待扫码签约 |
remark | String | 驳回原因 |
message | String | 状态文字说明 |
# (7)返回示例
{
"success": true,
"message": "succeed",
"code": 200,
"data": [
{
"phone": "15112234000",
"idcard": "412732199807080961",
"name": "王美丽",
"stuts": 3,
"remark": "",
"message": "审核通过"
},
{
"phone": "17367671265",
"idcard": "342423199709092245",
"name": "张三",
"stuts": 4,
"remark": "",
"message": "审核失败"
},
{
"phone": "15265650456",
"idcard": "130332199506057817",
"name": "李四",
"stuts": 10,
"remark": "",
"message": "待扫码签约"
}
]
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32