2.0-实名认证

认证人信息的创建、查询

2.1 批量认证

简要描述

批量创建认证人信息(认证人信息在调用批量创建任务接口时会同步创建,该步骤可跳过 )

请求 URL

• /task/openapi/v1/person/batch_create

请求方式

• POST

返回类型

• JSON

请求参数说明

-数组[{}],参照传参样例

参数名	必选	类型	说明
realName	是	string	真实姓名
identityNo	是	string	身份证
bankAccountNo	否	string	银行卡号(银行卡号与支付宝账号不能都为空)
alipayAccountNo	否	string	支付宝账号(银行卡号与支付宝账号不能都为空)
phone	否	string	手机号（当配置四要素验证时，必填）

返回参数说明

参数名	类型	说明
id	Long	认证人ID
realName	string	真实姓名
identityNo	string	身份证
bankAccountNo	string	银行卡
alipayAccountNo	string	支付宝账号
phone	string	手机号
failReason	string	失败原因

请求参数示例

[
  {
    "realName": "力度", //真实姓名
    "identityNo": "32118119930415101X", //身份证
    "bankAccountNo": "6214851215669528", //银行卡
    "alipayAccountNo": "18888888888" //支付宝
  }
]

正确返回示例

{
  "msg": "请求成功",
  "code": "200",
  "success": true,
  "data": [
    {
      "id": 79112,//认证人ID
      "realName": "力度", //真实姓名
      "identityNo": "327160198910080097",
      "bankAccountNo": "6214851215669528",
      "alipayAccountNo": "18888888888",
      "phone": null,
      "failReason": null
    }
  ]
}

错误返回示例

{
  "msg": "参数缺失",
  "code": "010001",
  "success": false,
  "data": null
}

备注

2.2 认证信息列表

简要描述

• 查询认证人人列表(默认分页,每页 20 条记录)

请求 URL

• /task/openapi/v1/person/list

请求方式

• GET

返回类型

• JSON

请求参数说明

参数名	必选	类型	说明
pageNo	否	Long	页码，默认 1
realName	否	string	真实姓名
identityNo	否	string	身份证
authStatus	否	string	实名认证状态，数据字典-0008-接单人认证状态

返回参数说明

参数名	类型	说明
pageNo	Long	页码
pageSize	Long	分页条数
pageCount	Long	总页数
totalCount	Long	总数
id	Long	认证人ID
realName	string	真实姓名
identityNo	string	身份证
bankAccountNo	string	银行卡
alipayAccountNo	string	支付宝账号
phone	string	手机号
authStatus	string	实名认证状态，参考数据字典-0008-接单人认证状态
createTimeStr	string	创建时间

正确返回示例

{
  "msg": "请求成功",
  "code": "200",
  "success": true,
  "data": {
    "pageNo": 1,
    "pageSize": 20,
    "pageCount": 2,
    "totalCount": 25,
    "entityList": [
      {
        "id": 79112,
        "realName": "力度",
        "identityNo": "327160198910080097",
        "bankAccountNo": "6214851215669528",
        "alipayAccountNo": null,
        "phone": null,
        "authStatus": "2",
        "createTimeStr": "2020-07-20 10:55:21"
      },
      {
        "id": 79111,
        "realName": "节关拉",
        "identityNo": "330683198212275468",
        "bankAccountNo": "4027910055364757",
        "alipayAccountNo": null,
        "phone": "13952468339",
        "authStatus": "2",
        "createTimeStr": "2020-07-17 11:31:55"
      }
    ]
  }
}

备注

• 个人的月度发放额度默认为 98000 元,个人单月超过限额后无法进入结算单
• 更多返回错误代码请看首页的错误代码描述