签约人
## OCR识别接口
#### 接口地址：
/open/api/v1/lw/naturalPerson/ocrBackAndIdCard
#### 请求方式：POST
#### 请求参数说明：
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|idCardFrontUrl|身份证正面照URL|String(512)|是||
|idCardBackUrl|身份证反面照URL|String(512)|是||
|bankCardFrontUrl|银行卡正面照URL|String(512)|是||
|mainstayId|注册地|Integer|是|直接填写 1|
#### 接口响应参数data字段解密后的参数说明：
|参数名称|参数含义|数据类型|是否必有|参数备注|
|-|-|-|-|-|
|idCardFrontInfo|身份证正面信息|IdCardFrontInfo|是||
|idCardBackInfo|身份证反面信息|IdCardBackInfo|是||
|bankCardFrontInfo|银行卡信息|BankCardFrontInfo|是||
|checkResult|三要素鉴权结果|Boolean|否|当身份证正面信息识别失败或银行卡正面识别失败时将不会做三要素的校验即结果为null|
|checkFailReason|鉴权识别原因|String|否||
##### IdCardFrontInfo
|参数名称|参数含义|数据类型|是否必有|参数备注|
|-|-|-|-|-|
|failReason|OCR识别失败原因|String|是|该参数内容可能为空，成功的时候失败原因为空字符串|
|name|姓名|String(16)|否|例：张三 |
|sex|性别|String(16)|否|例：男 |
|nation|民族|String(16)|否|例：汉 |
|dateOfBirth|出生年月|String(16)|否|例：20000101 |
|address|住址|String(255)|否|例：北京市xxxx|
|idCard|身份证号|String(18)|否|例：4104xxxx51167|
##### IdCardBackInfo
|参数名称|参数含义|数据类型|是否必有|参数备注|
|-|-|-|-|-|
|failReason|OCR识别失败原因|String|是|该参数内容可能为空，成功的时候失败原因为空字符串|
|issueDate|签发日期|String(16)|否|例：20000101 |
|expiryDate|失效日期|String(16)|否|例：20000101 |
|issuingAuthority|签发机关|String(255)|否|例：北京市xxxx |
##### BankCardFrontInfo
|参数名称|参数含义|数据类型|是否必有|参数备注|
|-|-|-|-|-|
|failReason|OCR识别失败原因|String|是|该参数内容可能为空，成功的时候失败原因为空字符串|
|bankCardNumber|银行卡卡号|String(16)|否|例：4104xxxx |
|bankName|银行名|String(16)|否|例：建设银行 |
|validDate|有效期|String(255)|否|例：03/29 |
|bankCardType|银行卡类型|String(2)|否|例：1 (0：不能识别; 1：借记卡; 2：贷记卡（原信用卡大部分为贷记卡）; 3：准贷记卡; 4：预付费卡) |
|holderName|持卡人姓名|String(255)|否|例：张三|
#### 返回报文示例：
```java
{"idCardFrontInfo":{"failReason":"","name":"张三","sex":"男","nation":"汉","dateOfBirth":"20000101","address":"北京市xxxx","idCard":"xxxx"},"idCardBackInfo":{"failReason":"","issueDate":"20000101","expiryDate":"20100101","issuingAuthority":"北京市xxxx"},"bankCardFrontInfo":{"failReason":"","bankCardNumber":"xxxx","bankName":"建设银行","validDate":"03/29","bankCardType":"1","holderName":""}}
```
## OCR识别身份证+校验接口
#### 接口地址：
/open/api/v1/lw/naturalPerson/checkOcrIdCard
#### 请求方式：POST
#### 请求参数说明：
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|idCardFrontUrl|身份证正面照URL|String(512)|是||
|idCardBackUrl|身份证反面照URL|String(512)|是||
|name|姓名|String(16)|是|例：张三|
#### 接口响应参数data字段解密后的参数说明：
|参数名称|参数含义|数据类型|是否必有|参数备注|
|-|-|-|-|-|
|idCardFrontInfo|身份证正面信息|IdCardFrontInfo|是||
|idCardBackInfo|身份证反面信息|IdCardBackInfo|是||
|checkResult|校验结果|Boolean|否|当身份证正面信息识别失败时将不会做校验即结果为null|
##### IdCardFrontInfo
|参数名称|参数含义|数据类型|是否必有|参数备注|
|-|-|-|-|-|
|failReason|OCR识别失败原因|String|是|该参数内容可能为空，成功的时候失败原因为空字符串|
|name|姓名|String(16)|否|例：张三 |
|sex|性别|String(16)|否|例：男 |
|nation|民族|String(16)|否|例：汉 |
|dateOfBirth|出生年月|String(16)|否|例：20000101 |
|address|住址|String(255)|否|例：北京市xxxx|
|idCard|签约人身份证号|String(18)|否|例：4104xxxx51167|
##### IdCardBackInfo
|参数名称|参数含义|数据类型|是否必有|参数备注|
|-|-|-|-|-|
|failReason|OCR识别失败原因|String|是|该参数内容可能为空，成功的时候失败原因为空字符串|
|issueDate|签发日期|String(16)|否|例：20000101 |
|expiryDate|失效日期|String(16)|否|例：20000101 |
|issuingAuthority|签发机关|String(255)|否|例：北京市xxxx |
#### 返回报文示例：
```java
{"idCardFrontInfo":{"failReason":"","name":"张三","sex":"男","nation":"汉","dateOfBirth":"20000101","address":"北京市xxxx","idCard":"xxxx"},"idCardBackInfo":{"failReason":"","issueDate":"20000101","expiryDate":"20100101","issuingAuthority":"北京市xxxx"}}
```
## 更改银行卡接口
#### 接口地址：
/open/api/v1/lw/naturalPerson/changeBankCard
#### 请求方式：POST
#### 请求参数说明：
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|name|签约人姓名|String(18)|是|例：张三|
|idCard|签约人身份证号|String(18)|是|例：4104xxxx51167|
|bankCardFrontUrl|银行卡正面照URL|String(512)|是||
|mainstayId|注册地|Integer|直接填写 1|
#### 接口响应参数data字段解密后的参数说明：
|参数名称|参数含义|数据类型|是否必有|参数备注|
|-|-|-|-|-|
|bankCardFrontInfo|银行卡信息|BankCardFrontInfo|是||
|checkResult|三要素鉴权结果|Boolean|是|该结果也作为是否更改成功结果|
|checkFailReason|鉴权识别原因|String|否||
##### BankCardFrontInfo
|参数名称|参数含义|数据类型|是否必有|参数备注|
|-|-|-|-|-|
|failReason|OCR识别失败原因|String|是|该参数内容可能为空，成功的时候失败原因为空字符串|
|bankCardNumber|银行卡卡号|String(16)|否|例：4104xxxx |
|bankName|银行名|String(16)|否|例：建设银行 |
|validDate|有效期|String(255)|否|例：03/29 |
|bankCardType|银行卡类型|String(2)|否|例：1 (0：不能识别; 1：借记卡; 2：贷记卡（原信用卡大部分为贷记卡）; 3：准贷记卡; 4：预付费卡) |
|holderName|持卡人姓名|String(255)|否|例：张三|
#### 返回报文示例：
```java
{"checkResult":true,"bankCardFrontInfo":{"failReason":"","bankCardNumber":"xxxx","bankName":"建设银行","validDate":"03/29","bankCardType":"1","holderName":""}}
```
## 签约接口
#### 接口地址：
/open/api/v1/lw/naturalPerson/registered
#### 请求方式：POST
#### 请求参数说明：
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|idCardFrontUrl|身份证正面照URL|String(512)|是||
|idCardBackUrl|身份证反面照URL|String(512)|是||
|phone|签约人注册手机号|String(11)|是|例：130xxxx3381|
|mainstayId|注册地|Integer|是|直接填写 1|
#### 接口响应参数data字段解密后的参数说明：
|参数名称|参数含义|数据类型|是否必有|参数备注|
|-|-|-|-|-|
|status|签约人状态|Integer|是|开户状态码 10：待身份认证，20：待人脸识别，30：待签约协议，100：签约成功，-10：签约失败|
|failReason|失败原因|String|是|该参数内容可能为空，成功的时候失败原因为空字符串|
#### 返回报文示例：
```java
{"status":-1,"failReason":""}
```
## 人员信息查询接口
#### 接口地址：
/open/api/v1/lw/naturalPerson/queryDetails
#### 请求方式：POST
#### 请求参数说明：
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|idCard|签约人身份证号|String(18)|是|例：4104xxxx51167|
|mainstayId|注册地|Integer|是|直接填写 1|
#### 接口响应参数data字段解密后的参数说明：
|参数名称|参数含义|数据类型|是否必有|参数备注|
|-|-|-|-|-|
|status|签约人状态|String(32)|是|签约人状态，10：待身份认证，20：待人脸识别，30：待签约协议，100：签约成功，-10：签约失败|
|name|签约人姓名|String|是|例：张三|
|idCard|签约人身份证号|String|是|例：4104xxxx51167|
|mainstayName|注册地|String|是|例：安吉|
|companyName|公司名|String|是|例：xxxx有限公司|
|bankCode|银行卡信息|String|否|例：330501164xxxxxxx|
|failReason| 异常原因|String|否|该参数内容可能为空，成功的时候失败原因为空字符串|
|taxInstitution|所属税务机关|String|否||
|laborType|劳务费类型|Integer|否|劳务费类型：0：待开其他劳务普通发票 1：代开讲课费普通发票 2：代开评审费普通发票|
#### 返回报文示例：
```java
{"status":-1,"name":"张三","idCard":"4104xxxx51167","mainstayName":"安吉","companyName":"xxxx有限公司","bankNameAccount":"中国工商银行杭州富春支行 330501164xxxxxxx","failReason":"","taxInstitution":"","laborType":0}
```