用户实名认证记录查询接口
接口说明
[!NOTE]
用户实名认证查询
http请求方式
[!NOTE]
POST form-data
http请求地址
[!NOTE]
$SERVICE_URL/v2/sign/saas/advancedAuth/record #其中$SERVICE_URL为生产或测试的地址
http请求参数
[!NOTE]
除公共必填参数外,还需要传以下参数
| 参数 | 类型 | 是否必填 | 默认值 | 说明 |
|---|---|---|---|---|
| authSerialNo | String | * | 认证流水号;由/v2/sign/saas/advancedAuth/link返回的认证流水号或异步回调返回的认证流水号 |
代码实现
JAVA实现
Map<String, Object> params = bodyParams;
String url = SERVICE_URL + "/v2/sign/saas/advancedAuth/record";
params.put("authSerialNo", "FAXXXXXXX27404"); //认证流水号
String str = HttpClientUtils.init().getPost(url, null, params, true);
System.out.println(str);
http返回参数
[!NOTE]
返回response为application/json的数据,其字段说明如下
| 参数 | 类型 | 是否必返回 | 说明 |
|---|---|---|---|
| success | bool | * | 成功true;异常false |
| msg | string | ? | 异常时,返回异常原因 |
| data | Object | ? | 响应数据 |
| resultCode | string | ? | 异常时返回 |
data参数说明
| 参数 | 类型 | 是否必返回 | 说明 |
|---|---|---|---|
| authSerialNo | String | * | 用户实名认证流水号 |
| userType | Integer | ? | 用户类型(0,个人用户;1,企业) |
| authTime | String | * | 用户实名认证时间 |
| status | String | * | 认证状态;个人用户认证状态:-1:未认证,1:认证通过。企业用户认证状态:-1:未认证,0:授权书待审核,1:认证通过,2:授权书审核未通过 |
| refuseReason | String | ? | 企业用户授权书未通过原因 |
| personalRecord | Object | ? | 个人认证信息 userType=0时返回 |
| enterpriseRecord | Object | ? | 企业认证信息 userType=1时返回 |
personalRecord个人认证信息返回参数说明
| 参数 | 类型 | 是否必返回 | 说明 |
|---|---|---|---|
| name | String | * | 用户姓名 |
| idCard | String | * | 用户身份证号 |
| faceOrderNo | String | ? | 人脸识别订单号 |
| bankCardNo | String | ? | 银行卡号 |
| bankMobile | String | ? | 银行卡预留手机号 |
| mobileNo | String | ? | 运营商三要素认证手机号 |
| authType | int | * | 1:人脸识别,2:银行卡四要素,3:运营商认证 |
enterpriseRecord企业认证信息返回参数说明
| 参数 | 类型 | 是否必返回 | 说明 |
|---|---|---|---|
| name | String | * | 企业名称 |
| creditCode | String | * | 统一社会信用代码 |
| legalName | String | * | 企业法定代表人姓名 |
| legalIdCard | String | ? | 企业法定代表人身份证号码 |
| legalMobile | String | ? | 企业法定代表人手机号 |
| legalFaceOrder | String | ? | 企业法定代表人人脸识别订单号 |
| agentName | String | ? | 企业授权人姓名 |
| agentIdentityCard | String | ? | 企业授权人身份证号 |
| agentMobilePhone | String | ? | 企业授权人手机号 |
| applyTableImg | String | ? | 授权书图片URL |
| agentFaceOrderNo | String | ? | 授权人人脸识别订单号 |
| legalBankCardNo | String | ? | 法定代表人银行卡卡号 |
| legalBankMobile | String | ? | 法定代表人银行卡预留手机号 |
| authType | int | * | 1:法定代表人人脸识别,2:法定代表人银行卡四要素,3:授权书认证 |
[!NOTE]
返回结果,参考:
//成功响应-个人:
{
"success": true,
"data": {
"authSerialNo": "AUTH202606050001",
"userType": 0,
"personalRecord": {
"name": "张三",
"idCard": "330102199001011234",
"faceOrderNo": "FACE202606050001",
"bankCardNo": "6222021234567890123",
"bankMobile": "13800138000",
"mobileNo": "13800138000"
},
"enterpriseRecord": null
}
}
//成功响应 - 企业认证记录
{
"success": true,
"data": {
"authSerialNo": "AUTH202606050002",
"userType": 1,
"personalRecord": null,
"enterpriseRecord": {
"name": "某某科技有限公司",
"creditCode": "91330100MA2XXXXXXY",
"legalName": "李四",
"legalIdCard": "330102198501011234",
"legalMobile": "13900139000",
"legalFaceOrderNo": "FACE202606050002",
"agentName": "王五",
"agentIdentityCard": "330102199001011234",
"agentMobilePhone": "13700137000",
"applyTableImg": "https://example.com/apply-table-123.png",
"agentFaceOrderNo": "FACE202606050003"
}
}
}