2.0-实名认证

认证人信息的创建、查询

2.1 批量认证

简要描述

批量创建认证人信息

请求 URL

• /regulator/openapi/v2/person/batch_create

请求方式

• POST

返回类型

• JSON

请求参数说明

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

参数名	必选	类型	说明
realName	是	string	真实姓名
identityNo	是	string	身份证
phone	是	string	手机号
bankAccountNo	否	string	银行卡号(银行卡号与支付宝账号不能都为空)
alipayAccountNo	否	string	支付宝账号(银行卡号与支付宝账号不能都为空)
positiveCardFileUrl	是	string	身份证正面照片url（根据配置确定是否必填、文件最大支持5M,格式：PNG,JPG）
inverseCardFileUrl	是	string	身份证反面照片url（根据配置确定是否必填、文件最大支持5M,格式：PNG,JPG）

返回参数说明

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

请求参数示例

[
    {
        "identityNo":"23108119820707062x",
        "realName":"于永虹",
        "bankAccountNo":"6216600800001875791",
        "positiveCardFileUrl":"https://task.alitatest.cn/anon/file/download/fec96d58a69e4a0cacac65b9c22e205c",
        "inverseCardFileUrl":"https://task.alitatest.cn/anon/file/download/fec96d58a69e4a0cacac65b9c22e205c"
    }
]

正确返回示例

{
    "requestId":"dfe563a187f6aade",
    "msg":"请求成功",
    "code":"200",
    "success":true,
    "data":[
        {
            "id":77825,
            "realName":"于永虹",
            "identityNo":"23108119820707062X",
            "bankAccountNo":"6216600800001875791",
            "positiveCardFileUrl":"https://task.alitatest.cn/anon/file/download/fec96d58a69e4a0cacac65b9c22e205c",
            "inverseCardFileUrl":"https://task.alitatest.cn/anon/file/download/fec96d58a69e4a0cacac65b9c22e205c",
            "phone":"18516001447",
            "failReason":null,
            "alipayAccountNo":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	手机号

<<<<<<< HEAD | positiveCardFileUrl | string | 身份证正面照片url（根据配置确定是否必填） | | inverseCardFileUrl | string | 身份证反面照片url（根据配置确定是否必填） |

| authStatus | string | 实名认证状态，参考数据字典-0008-接单人认证状态 |

| positiveCardFileUrl | string | 身份证正面照片url | | inverseCardFileUrl | string | 身份证反面照片url | | authStatus | string | 实名认证状态，参考数据字典-0008-接单人认证状态 |

56e5bacb579e8ddea45a404e6cff18fa25c1b84e | createTimeStr | string | 创建时间 |

正确返回示例

{
  "msg": "请求成功",
  "code": "200",
  "success": true,
  "data": {
    "pageNo": 1,
    "pageSize": 20,
    "pageCount": 1,
    "totalCount": 1,
    "entityList": [
        {
            "id": 77825,
            "realName": "于永虹",
            "identityNo": "23108119820707062X",
            "positiveCardFileUrl": "https://task.alitatest.cn/anon/file/download/fec96d58a69e4a0cacac65b9c22e205c",
            "inverseCardFileUrl": "https://task.alitatest.cn/anon/file/download/fec96d58a69e4a0cacac65b9c22e205c",
            "bankAccountNo": "6216600800001875791",
            "alipayAccountNo": null,
            "phone": "18516001447",
            "authStatus": "2",
            "createTimeStr": "2020-08-10 18:38:17"
        }
    ]
  }
}

备注

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