功能模块接口 - 接口参数(老文档)
>d 接口调用细节流程:
◆ 参数RSA加密[接口签名,加解密说明](https://easydoc.xyz/doc/38214856/sLYGhH4w/aM5B3Vbr)
◆ 将加密结果以及公共参数拼接成新的字符串通过MD5加密生成签名
◆ 将公共参数以及签名通过header传输,参数加密结果通过body传输,发起http请求
◆ 返回结果解密[接口签名,加解密说明](https://easydoc.xyz/doc/38214856/sLYGhH4w/aM5B3Vbr)
## 接口响应参数都为如下固定json格式
|参数名称|参数含义|数据类型|是否必有|参数备注|
|-|-|-|-|-|
|resopnseType| 返回类型|int|是|无需关注此值|
|errorCode|错误码 |String|是|详情参考[系统错误码](https://easydoc.xyz/doc/38214856/sLYGhH4w/KskSPDLn)|
|errorMessage| 错误信息|String|是|详情参考[系统错误码](https://easydoc.xyz/doc/38214856/sLYGhH4w/KskSPDLn)|
|status|状态码|int|是|详情参考[系统错误码](https://easydoc.xyz/doc/38214856/sLYGhH4w/KskSPDLn)|
|success|是否成功|boolean|是|true:成功 false:失败|
|data|返回结果数据|String|否|只有当success为true才会有该值,该值为RSA加密值,需解密使用,解密规则请看[接口签名,加解密说明](https://easydoc.xyz/doc/38214856/sLYGhH4w/aM5B3Vbr)|
## 1. 创建法人信息接口
开发环境:https://pay-dev.lx-rhino.com
生产环境:https://api.lx-rhino.com
#### 接口地址:/open/api/v1/selfRegistered/createSelfInfo
#### 请求方式:POST
#### 请求参数说明:
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|idCard|个体户身份证号|String|是||
|name|姓名|String|是||
|mobile|手机号|String|是||
|frontIdCard|身份证正面照URL|String|是||
|backIdCard|身份证反面照URL|String|是||
|hatlessPhoto|人脸照URL|String|是||
#### 接口响应参数说明:
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|token|个体户token|String|是|该token有效期为2小时,如果失效则需要重新调用3.获取token接口获取|
## 2. 创建个体户接口
开发环境:https://pay-dev.lx-rhino.com
生产环境:https://api.lx-rhino.com
#### 接口地址:/open/api/v1/selfRegistered/createSelfEmployed/{token}
>d token直接拼接至接口 例如:token 为 xxxxx 则请求链接为 /open/api/v1/selfRegistered/createSelfEmployed/xxxxx
#### 请求方式:POST
#### 请求参数说明:
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|source|所属业务线|Integer|是|2:轻税 3:账管家 4:云纳税|
|mainstayId|主体ID|Integer|是||
|industryCode|行业code|String|是||
|invoices|发票类目code|String|是|多个用逗号隔开。但是必须都是所属于同一行业|
#### 接口响应参数说明:
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|status|状态|Integer|是|-2:开户失败,-1:待申请|
|failReason|失败原因|String|是|开户失败该值会有失败原因|
## 3. 获取token接口
开发环境:https://pay-dev.lx-rhino.com
生产环境:https://api.lx-rhino.com
#### 接口地址:/open/api/v1/selfRegistered/getToken
#### 请求方式:POST
>d 该接口必须在1.创建法人信息接口 后获取才有效
#### 请求参数说明:
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|idCard|个体户身份证号|String|是||
|name|姓名|String|是||
#### 接口响应参数说明:
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|token|个体户标识|String|是|该token有效期为2小时,失效后需要重新获取|
## 4. 创建协议接口
开发环境:https://pay-dev.lx-rhino.com
生产环境:https://api.lx-rhino.com
#### 接口地址:/open/api/v1/selfRegistered/createSelfEmployedProtocol/{token}
#### 请求方式:POST
#### 请求参数说明:无需入参
#### 接口响应参数说明:
>d 该接口返回内容为数组,如有多个注册地则会有多条数据
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|mainstayId|主体ID|Integer|是||
|mainstayIdName|主体名称|String|是||
|protocols|协议列表|List<String>|是|协议为多份|
>d 返回结果示例如下所示
```java
[{"mainstayId":1,"mainstayIdName":"xxx","protocols":["协议1链接","协议2链接","协议3链接,等等"]},{"mainstayId":2,"mainstayIdName":"xxx","protocols":["协议1链接","协议2链接","协议3链接,等等"]},{"mainstayId":3,"mainstayIdName":"xxx","protocols":["协议1链接","协议2链接","协议3链接,等等"]}]
```
## 5. 签署接口
开发环境:https://pay-dev.lx-rhino.com
生产环境:https://api.lx-rhino.com
#### 接口地址:/open/api/v1/selfRegistered/signature/{token}
#### 请求方式:POST
#### 请求参数说明:
>d 改接口入参与之前的不一致,参数无需加密。只需要将签名后的base64码放在body传输即可
postman示例如下:

#### 接口响应参数说明:
响应参数success 为ture 代表签署成功,反之则失败
## 6. 个体户状态查询接口
开发环境:https://pay-dev.lx-rhino.com
生产环境:https://api.lx-rhino.com
#### 接口地址:/open/api/v1/selfRegistered/querySelfEmployedInfo/{token}
#### 请求方式:POST
#### 请求参数说明:
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|mainstayId|主体ID|Integer|是||
#### 接口响应参数说明:
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|name|法人姓名|String|是||
|idCard|法人身份证号码|String|是||
|status|状态|Integer|是|详情请看[3.个体户状态码](doc:KskSPDLn)(该值为经营中的时候才可进行结算)|
|taxStatus|税务状态|Integer|是|0:未实名,1:已实名。该状态为已实名才可进行开票操作|
|taxType|税算法类型|Integer|是|0累进制、1核定制|
|refuseType|拒绝类型|Integer|否||
|refuseReason|审核拒绝原因|String|否||
|companyName|个体户公司名称|String|是||
|taxNumber|税号|String|否|个体户注册成功之后才会有税号|
|mobile|注册手机号码|String|是||
|address|注册地址|String|是||
|businessLicense|营业执照|String|否|个体户注册成功之后才会有|
## 7.1 调用工商授权接口
开发环境:https://pay-dev.lx-rhino.com
生产环境:https://api.lx-rhino.com
#### 接口地址:/open/api/v1/selfRegistered/authorization/{token}
#### 请求方式:POST
#### 请求参数说明:
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|无|
#### 接口响应参数说明:
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|status|工商授权状态|Integer|是|[2.工商授权状态码](https://easydoc.xyz/doc/38214856/sLYGhH4w/KskSPDLn)
|statusText|工商授权状态描述|String|是
|encryptMobile|掩码手机号|String|是
## 7.2 重置手机号接口
开发环境:https://pay-dev.lx-rhino.com
生产环境:https://api.lx-rhino.com
#### 接口地址:/open/api/v1/selfRegistered/resetPhone/{token}
#### 请求方式:POST
#### 请求参数说明:
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|mobile|更换的手机号(当状态为2,3时填写)|String|是
|encryptMobile|掩码手机号(当状态为3时填写)|String|是
#### 接口响应参数说明:
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|status|工商授权状态|Integer|是|[2.工商授权状态码](https://easydoc.xyz/doc/38214856/sLYGhH4w/KskSPDLn)
|statusText|工商授权状态描述|String|是
## 7.3 验证码提交接口
开发环境:https://pay-dev.lx-rhino.com
生产环境:https://api.lx-rhino.com
#### 接口地址:/open/api/v1/selfRegistered/submitVerificationCode/{token}
#### 请求方式:POST
#### 请求参数说明:
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|mobile|更换的手机号|String|是
|code|验证码|String|是
#### 接口响应参数说明:
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|status|工商授权状态|Integer|是|[2.工商授权状态码](https://easydoc.xyz/doc/38214856/sLYGhH4w/KskSPDLn)
|statusText|工商授权状态描述|String|是
~~## 7.4 实名采集接口(改接口已作废)~~
开发环境:https://pay-dev.lx-rhino.com
生产环境:https://api.lx-rhino.com
#### 接口地址:/open/api/v1/selfRegistered/certificationUrl/{token}
#### 请求方式:POST
#### 请求参数说明:
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|mainstayId|主体id|String|是
#### 接口响应参数说明:
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|url|实名采集地址|String|是
## 7.5 税务授权接口
开发环境:https://pay-dev.lx-rhino.com
生产环境:https://api.lx-rhino.com
#### 接口地址:/open/api/v1/selfRegistered/tax/authorization/{token}
#### 请求方式:POST
#### 请求参数说明:
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|无|
#### 接口响应参数说明:
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|status|税务授权状态|Integer|是|[7.税务授权状态码](https://easydoc.xyz/doc/38214856/sLYGhH4w/KskSPDLn)
|statusText|税务授权说明|String|是|
|taxMobile|税务授权手机号|String|是|用于接收电子税务局的验证码短信
## 7.6 税务授权重置手机号接口
开发环境:https://pay-dev.lx-rhino.com
生产环境:https://api.lx-rhino.com
#### 接口地址:/open/api/v1/selfRegistered/tax/resetPhone/{token}
#### 请求方式:POST
#### 请求参数说明:
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|mobile|更换的手机号(当状态为0时填写)|String|是
#### 接口响应参数说明:
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|status|状态|Integer|是|[7.税务授权状态码](https://easydoc.xyz/doc/38214856/sLYGhH4w/KskSPDLn)
|statusText|税务授权说明|String|是|
|taxMobile|税务授权手机号|String|是|用于接收电子税务局的验证码短信
## 7.7 税务授权验证码提交接口
开发环境:https://pay-dev.lx-rhino.com
生产环境:https://api.lx-rhino.com
#### 接口地址:/open/api/v1/selfRegistered/tax/submitVerificationCode/{token}
#### 请求方式:POST
#### 请求参数说明:
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|code|验证码|String|是
#### 接口响应参数说明:
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|status|状态|Integer|是|[7.税务授权状态码](https://easydoc.xyz/doc/38214856/sLYGhH4w/KskSPDLn)
|failReason|失败原因|String|否|
## 8. 个体户状态回调通知
>d 该接口需要第三方自行编写提供接口到发放平台 接口编写示例如下。
#### 请求方式:POST
```java
@PostMapping("signCallBack")
@ResponseBody
public String signCallBack(HttpServletRequest request, @RequestBody String data){
String publicKey = "该公钥由发放平台提供发放到贵司邮箱";
//解密
String decode = RSAHelper.decryptByPublicKey(data, publicKey);
/*贵公司处理业务逻辑*/
return "success";
}
```
解密工具类在 [JAVA_DEMO](https://gitee.com/xinfudblog/lxapi_java_demo) 的 RSAHelper 类中
>d 贵司写完后提供到接口url给发放平台即可。回调成功需返回success,不然回重复回调,至多重试5次
postman中模拟接口是否正常接收数据如下操作

#### 传给回调接口参数data 解密结果json说明:
解密结果示例如下:
```json
{"idCard":"12456484","name":"张三","status":30,"mobile":"1888888888","refuseType":"","refuseReason":"","companyName":"xxxx","taxNumber":"xxxx","mobile":"xxxx","address":"xxxx","businessLicense":"xxxxx","realNameCollectionUrl":"xxxx"}";
```
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|name|法人姓名|String|是||
|idCard|法人身份证号码|String|是||
|status|状态|Integer|是|详情请看[3.个体户状态码](doc:KskSPDLn)(该值为经营中的时候才可进行结算)|
|taxStatus|税务状态|Integer|是|0:未实名,1:已实名。该状态为已实名才可进行开票操作。未实名变成已实名的时候会有回调通知|
|refuseType|拒绝类型|Integer|否|0:签名无法识别,请重新签名(从新调用5.签署接口),1:政务网注册授权失败","政务网注册授权失败(从新调用7.1政务网授权接口),2:市场监管局授权失败(未完善)3:身份证照片不可用,请重新上传身份证照片,4:签名及身份证不可用,请重新上传身份证照片,5:注册异常:详情请联系客服咨询|
|refuseReason|审核拒绝原因|String|否||
|companyName|个体户公司名称|String|是||
|taxNumber|税号|String|否|个体户注册成功之后才会有税号|
|mobile|注册手机号码|String|是||
|address|注册地址|String|是||
|businessLicense|营业执照|String|否|个体户注册成功之后才会有|
|realNameCollectionUrl|实名采集地址|String|否|只有当个体户状态为待实名认证的时候该参数才会有内容|
## 9.获取企业合作主体,发票类目等信息
开发环境:https://pay-dev.lx-rhino.com
生产环境:https://api.lx-rhino.com
#### 接口地址:/open/api/v1/selfRegistered/queryCompanyInfo
#### 请求方式:POST
#### 请求参数说明:无需传任何参数
#### 接口响应参数说明:
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|source|所属业务线|Integer|是|2:轻税业务 3:账管家业务|
|mainstayId|合作主体|Integer|是||
|name|合作主体名称|String|是||
|industryCode|所属行业code|String|是||
|industryName|所属行业名称|String|是||
|invoiceCode|发票编码|String|是||
|invoiceContent|发票内容|String|是||
>d 示例数据结构如下
```json
[{
"akMainstayOpResponses": [{
"invoiceOpResponseList": [{
"industryCode": "ZXBYFW",
"industryName": "装卸搬运服务",
"invoiceCode": "WLFZFWXSZXF",
"invoiceContent": "物流辅助服务**运输装卸费"
}],
"mainstayId": 主体ID,
"name": "主体2"
}, {
"invoiceOpResponseList": [{
"industryCode": "ZXBYFW",
"industryName": "装卸搬运服务",
"invoiceCode": "WLFZFWXSZXF",
"invoiceContent": "物流辅助服务**运输装卸费"
}],
"mainstayId": 主体Id,
"name": "主体3"
}, {
"invoiceOpResponseList": [{ //发票列表
"industryCode": "ZXBYFW",
"industryName": "装卸搬运服务",
"invoiceCode": "WLFZFWXSZXF",
"invoiceContent": "物流辅助服务**运输装卸费"
}, {
"industryCode": "ZXBYFW",
"industryName": "装卸搬运服务",
"invoiceCode": "WLFZFWZXBYFW",
"invoiceContent": "物流辅助服务*装卸搬运服务"
}],
"mainstayId": 主体ID,
"name": "主体1"
}],
"source": 3 //所属业务线 账管家
}, {
"akMainstayOpResponses": [{
"invoiceOpResponseList": [{
"industryCode": "YXTG_01",
"industryName": "营销推广",
"invoiceCode": "XDFWCHFWF",
"invoiceContent": "现代服务*策划服务费"
}, {
"industryCode": "YXTG_01",
"industryName": "营销推广",
"invoiceCode": "XDFWTGFWF",
"invoiceContent": "现代服务*推广服务费"
}, {
"industryCode": "YXTG_01",
"industryName": "营销推广",
"invoiceCode": "XDFWYXFWF",
"invoiceContent": "现代服务*营销服务费"
}, {
"industryCode": "KJHY_01",
"industryName": "科技行业",
"invoiceCode": "XXJSFWJSFWF",
"invoiceContent": "信息技术服务*技术服务费"
}],
"mainstayId": 主体ID,
"name": "主体1"
}, {
"invoiceOpResponseList": [{
"industryCode": "WLGW_02",
"industryName": "管理&顾问",
"invoiceCode": "JZZXFWZXFWF",
"invoiceContent": "鉴证咨询服务*咨询服务费"
}, {
"industryCode": "YXTG_02",
"industryName": "营销推广",
"invoiceCode": "XDFWCHFWF",
"invoiceContent": "现代服务*策划服务费"
}],
"mainstayId":主体Id,
"name": "主体2"
}, {
"invoiceOpResponseList": [{
"industryCode": "WHZB_03",
"industryName": "网红&直播",
"invoiceCode": "XDFWHLWXXFW",
"invoiceContent": "现代服务*互联网信息服务"
}],
"mainstayId": 主体Id,
"name": "主体3"
}],
"source": 2 //所属业务线 轻税
}]
```
## 10.1.个体户银行卡绑卡申请接口
开发环境:https://pay-dev.lx-rhino.com
生产环境:https://api.lx-rhino.com
#### 接口地址:/open/api/v1/selfRegistered/bindCard/apply/{token}
#### 请求方式:POST
#### 请求参数说明:
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|cardNo|银行卡卡号|String|是||
|phone|银行卡预留手机号|String|是||
>d 该手机号将收到来自快捷通的绑卡验证码短信
#### 接口响应参数说明:
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|bindCardNo|绑卡订单号|String|是
## 10.2.个体户银行卡绑定验证码确认接口
开发环境:https://pay-dev.lx-rhino.com
生产环境:https://api.lx-rhino.com
#### 接口地址:/open/api/v1/selfRegistered/bindCard/confirm/{token}
#### 请求方式:POST
#### 请求参数说明:
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|verifyCode|验证码|String|是||
|bindCardNo|绑卡订单号|String|是||
#### 接口响应参数说明:
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|bindCardNo|绑卡订单号|String|是
|status|绑卡状态|Boolean|是
## 10.3.个体户银行卡绑定查询接口
开发环境:https://pay-dev.lx-rhino.com
生产环境:https://api.lx-rhino.com
#### 接口地址:/open/api/v1/selfRegistered/bindCard/query/{token}
#### 请求方式:POST
#### 请求参数说明:
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|cardNo|银行卡卡号|String|是||
#### 接口响应参数说明:
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|bindCardNo|绑卡订单号|String|是
|status|绑卡状态|Boolean|是
## 11.1.个体户支付申请接口
开发环境:https://pay-dev.lx-rhino.com
生产环境:https://api.lx-rhino.com
#### 接口地址:/open/api/v1/selfRegistered/pay/apply/{token}
#### 请求方式:POST
#### 请求参数说明:
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|mainstayId|主体|Integer|是|
|confType|业务类型|Integer|是|0系统注册费 1代理服务费 2系统注销费|
|payType|支付类型|Integer|否|0银行卡|
|paymentAccount|支付账号|String|是|已绑定的银行卡卡号|
>d 该手机号将收到来自快捷通的支付验证码短信
#### 接口响应参数说明:
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|transNo|支付订单号|String|是|
|amount|支付金额|BigDecimal|是||
## 11.2.1.个体户支付确认接口
开发环境:https://pay-dev.lx-rhino.com
生产环境:https://api.lx-rhino.com
#### 接口地址:/open/api/v1/selfRegistered/pay/confirm/{token}
#### 请求方式:POST
#### 请求参数说明:
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|transNo|支付订单号|String|是|
|verifyCode|验证码|String|是||
#### 接口响应参数说明:
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|transNo|支付订单号|String|是|
|transStatus|支付状态|Integer|是|[4.系统管理费支付状态](doc:KskSPDLn)|
## 11.2.2.个体户支付回调
>d 该接口需要第三方自行编写提供接口到发放平台 接口编写示例如下。
#### 请求方式:POST
```java
@PostMapping("signCallBack")
@ResponseBody
public String signCallBack(HttpServletRequest request, @RequestBody String data){
String publicKey = "该公钥由发放平台提供发放到贵司邮箱";
//解密
String decode = RSAHelper.decryptByPublicKey(data, publicKey);
/*贵公司处理业务逻辑*/
return "success";
}
```
解密工具类在 [JAVA_DEMO](https://gitee.com/xinfudblog/lxapi_java_demo) 的 RSAHelper 类中
>d 贵司写完后提供到接口url给发放平台即可。回调成功需返回success,不然回重复回调,至多重试5次
postman中模拟接口是否正常接收数据如下操作

#### 接口响应参数说明:
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|transNo|支付订单号|String|是|
|transStatus|支付状态|Integer|是|[4.系统管理费支付状态](doc:KskSPDLn)|
|payType|支付类型|Integer|是|0银行卡|
|payMethod|付款方式|Integer|是|[5.系统管理费付款方式状态码](doc:KskSPDLn)|
|payer|支付对象|Integer|是|0个体户 1商户|
|amount|支付金额|BigDecimal|是||
|accountingPeriods|账期|List<String>|是|[6.系统管理费账期状态码](doc:KskSPDLn)|
## 11.3.个体户支付结果查询接口
开发环境:https://pay-dev.lx-rhino.com
生产环境:https://api.lx-rhino.com
#### 接口地址:/open/api/v1/selfRegistered/pay/query/{token}
#### 请求方式:POST
#### 请求参数说明:
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|transNo|支付订单号|String|是|
#### 接口响应参数说明:
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|transNo|支付订单号|String|是|
|transStatus|支付状态|Integer|是|[4.系统管理费支付状态](doc:KskSPDLn)|
|payType|支付类型|Integer|是|0银行卡|
|payMethod|付款方式|Integer|是|[5.系统管理费付款方式状态码](doc:KskSPDLn)|
|payer|支付对象|Integer|是|0个体户 1商户|
|amount|支付金额|BigDecimal|是||
|accountingPeriods|账期|List<String>|是|[6.系统管理费账期状态码](doc:KskSPDLn)|
## 12.个体户注销接口
开发环境:https://pay-dev.lx-rhino.com
生产环境:https://api.lx-rhino.com
#### 接口地址:/open/api/v1/selfRegistered/selfEmployedLogout
#### 请求方式:POST
#### 请求参数说明:
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|idCard|身份证号码|String|是|
|mainstayId|主体ID|Integer|是|
|source|业务线|Integer|业务线| 2轻税,3账管家,4云纳税|
#### 接口响应参数说明:
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|status|个体户状态|Integer|是|40:注销中,注销中代表调用接口成功,等待系统处理即可|
|needPay|是否需要支付|boolean|是|ture:需要支付注销费,false:无需支付注销费|
|transNo|注销费支付订单号|String|否|只要当需要支付的时候该字段才有值|
|payAmount|注销费|BigDecimal|否|只要当需要支付的时候该字段才有值|
|agencyTransNos|季度服务费支付订单号|List<String>|否|只要当需要支付的时候该字段才有值|
|agencyPayAmount|季度服务费|BigDecimal|否|只要当需要支付的时候该字段才有值|
|totalPayAmount|总支付金额|BigDecimal|否|只要当需要支付的时候该字段才有值|
## 13.个体户批量查询
开发环境:https://pay-dev.lx-rhino.com
生产环境:https://api.lx-rhino.com
#### 接口地址:/open/api/v1/selfRegistered/qsSelfEmployedBatchQuery
#### 请求方式:POST
#### 请求参数说明:
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|idCards|身份证号码|List<String>|是|身份证号码数组,身份证个数不可超过100个|
|mainstayId|主体ID|Integer|是|
#### 接口响应参数说明:
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|name|姓名|String|是||
|idCard|身份证号码|String|是||
|mainstayName|注册地|String|是||
|status|个体户状态|Integer|是|详情请看[3.个体户状态码](doc:KskSPDLn)(该值为经营中的时候才可进行结算)|
|taxStatus|税务状态|Integer|是|0:未实名,1:已实名。该状态为已实名才可进行开票操作|
|taxType|税算法类型|Integer|是|0累进制、1核定制|
|isRefuse|审核拒绝|Integer|0:未拒绝 1:审核拒绝||
|companyName|个体户公司名称|String|是||
|bankNameAccount|开户行及账户信息|String|是||
|taxNumber|税号|String|否|个体户注册成功之后才会有税号|
|phoneAddress|手机号、注册地|String|是||
|license|营业执照|String|否|个体户注册成功之后才会有|
|failReason|异常原因|
|selectStatus|是否查询到|boolean|false:未查询到 true:查询到了|
|source|所属业务线|Integer|2:轻税 3:账管家 4:云纳税|
## 14. 创建个体户接口v2(待开发)
开发环境:https://pay-dev.lx-rhino.com
生产环境:https://api.lx-rhino.com
#### 接口地址:/open/api/v1/selfRegistered/create
#### 请求方式:POST
#### 请求参数说明:
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|source|所属业务线|Integer|是|2:轻税 3:账管家 4:云纳税|
|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|身份证反面|String|否|URL地址|
|facePhoto|人脸照|String|否|URL地址|
#### 接口响应参数data字段解密后的参数说明:
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|status|个体户状态|Integer|是|[个体户状态码对照表](doc:FAjfb1c5)|
|failReason|失败原因|String|是|该参数内容可能为空,成功的时候失败原因为空字符串|
## 15.个体户H5免密登录接口获取(待开发)
开发环境:https://pay-dev.lx-rhino.com
生产环境:https://api.lx-rhino.com
接口地址:/open/api/v1/selfRegistered/getTokenUrl
请求方式:POST
请求参数说明:
#### data数据中参数说明:
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|mobile|手机号码|String|是||
#### 接口响应参数data字段解密后的参数说明:
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|url|H5免密登录链接|String|是||