5.个体户接口文档
## 5.1.个体户查询
#### 接口地址：/open/api/v1/yns/selfEmployedQuery
#### 请求方式：POST
#### 请求参数说明：
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|idCard|个体户身份证号|String|是||
|mainstayId|注册地|String|是|该参数值由[8.查询所拥有的主体发票行业接口](https://easydoc.xyz/doc/74041090/O7YZPiYm/b0rHe8PU) 获得|
#### 接口响应参数说明：
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|status| 个体户状态|Integer|是|[1.个体户状态码对照表](https://easydoc.xyz/doc/74041090/O7YZPiYm/FAjfb1c5)|
|isRefuse| 是否审核拒绝 0:未拒绝 1：审核拒绝|String|是|当个体户审核拒绝时候，该参数值为 1(表示审核拒绝)。个体户状态（status）参数依旧为 -1（待申请状态）。|
|name|个体户姓名|String|是|例：张三|
|idCard|个体户身份证号|String|是|例：410422199405051167|
|mainstayName|注册地|String|是|例：长兴|
|companyName|公司名|String|是|例：xxxx有限公司|
|taxNumber|纳税人识别号|String|否|例：91330100FS234（纳税人识别号）|
|phoneAddress|手机号、地址|String|否|例：浙江省杭州市滨江区网商路xx号 130xxxx3381|
|bankNameAccount|开户行及账户信息|String|否|例：中国工商银行杭州富春支行 330501164xxxxxxx|
|license| 营业执照|String|否|例：https://qiniu.lx-rhino.com/XXXX|
|failReason| 异常原因|String|否|该参数内容可能为空，成功的时候失败原因为空字符串|
## 5.2.个体户创建
>d 注意：上传身份证正反面有两种方式(可选)：第一，传入图片的方式（参数fileIdCardFront文件、fileIdCardBack文件），第二，传入图片链接的方式（idCardFrontUrl、idCardBackUrl）。 当同时传入（fileIdCardFront文件、fileIdCardBack文件）和data参数中（idCardFrontUrl、idCardBackUrl）时，优先使用（fileIdCardFront文件、fileIdCardBack文件）
开发环境：https://pay-dev.lx-rhino.com
生产环境：https://api.lx-rhino.com
#### 接口地址：/open/api/v1/selfRegistered/ynsSelfEmployedImport
#### 请求方式：POST
#### 请求参数说明：
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|fileIdCardFront|上传的身份证正面图片|MultipartFile|否|该参数值是身份证正面图片（注：不能仅传入该参数，应与身份证反面（fileIdCardBack）一起传）|
|fileIdCardBack|上传的身份证反面图片|MultipartFile|否|该参数值是身份证反面图片（注：不能仅传入该参数，应与身份证正面（fileIdCardFront）一起传）|
|data|该参数为个体户信息json加密后的值|String|是|说明示例如下 |
#### data数据中参数说明：
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|name|个体户姓名|String|是|例：张三|
|idCard|个体户身份证号|String|是|例：410422199405051167|
|phone|个体户手机号|String|否|例：130xxxx3381|
|mainstayId|注册地|String|是|该参数值由[3.1.查询所拥有的主体发票行业接口](doc:b0rHe8PU) 获得|
|invoiceCode|开票编码|String|是|可多选（必须属于同一行业），用英文逗号隔开。该参数值由[3.1.查询所拥有的主体发票行业接口](doc:b0rHe8PU) 获得|
|industryCode|所属行业code|String|是|该参数值由[3.1.查询所拥有的主体发票行业接口](doc:b0rHe8PU) 获得|
|idCardFrontUrl|身份证正面|String|否|该参数值由身份证正面图片的URL地址（注：不能仅传入该参数，应与身份证反面（idCardBackUrl）一起传）|
|idCardBackUrl|身份证反面|String|否|该参数值由身份证反面图片的URL地址（注：不能仅传入该参数，应与身份证正面（idCardFrontUrl）一起传）|
|facePhoto|人脸照|String|否|人脸照URL地址|
>d data参数示例如下
```java
String paramsJson = "{\"idCard\":\"xxxx\",\"idCardBackUrl\":\"https://xxxx/xxxx.jpeg\",\"idCardFrontUrl\":\"https://xxxx/xxxx.jpeg\",\"industryCode\":\"xxxx\",\"invoiceCode\":\"xxxx\",\"mainstayId\":\"xxxx\",\"name\":\"xxxx\",\"phone\":\"xxxx\"}"
String data= RSAHelper.encryptByPublicKey(paramsJson, publicKey);
```
#### 接口响应参数data字段解密后的参数说明：
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|status|个体户状态|Integer|是|[个体户状态码对照表](doc:FAjfb1c5)|
|failReason|失败原因|String|是|该参数内容可能为空，成功的时候失败原因为空字符串|
## 5.3.个体户H5免密登录接口获取
开发环境：https://pay-dev.lx-rhino.com
生产环境：https://api.lx-rhino.com
接口地址：/open/api/v1/yns/getTokenUrl
请求方式：POST
请求参数说明：
#### data数据中参数说明：
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|mobile|手机号码|String|是||
#### 接口响应参数data字段解密后的参数说明：
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|url|H5免密登录链接|String|是||