第三章 模块接口(1) - 个体户注册
## 综合服务云平台 - API功能模块接口明细
## 版本更新记录
|修订日期|修订内容|修订人|
|-|-|-|
|2020.10.12|新增接口：3.1 个体户法人创建、3.2 创建个体户注册地接口、3.3 获取token接口、3.4 创建获取协议接口、3.5 协议签署、3.6 个体户状态查询、3.7.1 工商授权、3.7.2 重置手机号、3.7.3 验证码提交、3.7.3 实名采集、3.8 个体户注册状态回调、3.9 获取企业合作主体发票类目|松子|
## 1.1 个体户注册流程图
## 1.2 接口时序图
## 2. 接口加解密
>d 接口调用细节流程：
◆ 参数RSA加密[接口签名，加解密说明](https://easydoc.xyz/doc/42964146/FECM0vAG/1V3nG1zs)
◆ 将加密结果以及公共参数拼接成新的字符串通过MD5加密生成签名
◆ 将公共参数以及签名通过header传输，参数加密结果通过body传输，发起http请求
◆ 返回结果解密[接口签名，加解密说明](https://easydoc.xyz/doc/42964146/FECM0vAG/1V3nG1zs)
#### 接口响应参数都为如下固定json格式
|参数名称|参数含义|数据类型|是否必有|参数备注|
|-|-|-|-|-|
|resopnseType| 返回类型|int|是|无需关注此值|
|errorCode|错误码 |String|是|详情参考[系统错误码](https://easydoc.xyz/doc/42964146/FECM0vAG/BBRyQ4qh)|
|errorMessage| 错误信息|String|是|详情参考[系统错误码](https://easydoc.xyz/doc/42964146/FECM0vAG/BBRyQ4qh)|
|status|状态码|int|是|详情参考[系统错误码](https://easydoc.xyz/doc/42964146/FECM0vAG/BBRyQ4qh)|
|success|是否成功|boolean|是|true：成功 false：失败|
|data|返回结果数据|String|否|只有当success为true才会有该值，该值为RSA加密值，需解密使用,解密规则请看[接口签名，加解密说明](https://easydoc.xyz/doc/42964146/FECM0vAG/1V3nG1zs)|
## 3. 个体工商户注册管理
## 3.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接口获取|
## 3.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：账管家|
|mainstayId|主体ID|Integer|是||
|taxType|个税算法类型|String|是|0:累进制、1核定制、2、双定制|
|industryCode|行业code|String|是||
|invoices|发票类目code|String|是|多个用逗号隔开。但是必须都是所属于同一行业|
#### 接口响应参数说明：
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|status|状态|Integer|是|-2：开户失败，-1：待申请|
|failReason|失败原因|String|是|开户失败该值会有失败原因|
## 3.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小时，失效后需要重新获取|
## 3.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链接，等等"]}]
```
## 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 代表签署成功，反之则失败
## 3.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|是|详情请看[个体户注册状态码](https://easydoc.xyz/doc/42964146/FECM0vAG/BBRyQ4qh)|
|taxStatus|税务状态|Integer|是|0：未实名，1：已实名。当该状态变为已实名后才可以进行开票申请操作||
|refuseType|拒绝类型|Integer|否||
|refuseReason|审核拒绝原因|String|否||
|companyName|个体户公司名称|String|是||
|taxNumber|税号|String|否|个体户注册成功之后才会有税号|
|mobile|注册手机号码|String|是||
|address|注册地址|String|是||
|businessLicense|营业执照|String|否|个体户注册成功之后才会有|
|taxType|个税类型|Integer|是|0 累进制、1 核定制、2 双定制|
## 3.7.1 工商授权接口
开发环境：https://pay-dev.lx-rhino.com
生产环境：https://api.lx-rhino.com
#### 接口地址：/open/api/v1/selfRegistered/authorization/{token}
#### 请求方式：POST
#### 请求参数说明：
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|无|
#### 接口响应参数说明：
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|status|工商授权状态|Integer|是|[工商授权状态码](https://easydoc.xyz/doc/42964146/FECM0vAG/BBRyQ4qh)
|statusText|工商授权状态描述|String|是
|encryptMobile|掩码手机号|String|是
## 3.7.2 重置手机号接口
开发环境：https://pay-dev.lx-rhino.com
生产环境：https://api.lx-rhino.com
#### 接口地址：/open/api/v1/selfRegistered/resetPhone/{token}
#### 请求方式：POST
#### 请求参数说明：
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|mobile|更换的手机号|String|是
#### 接口响应参数说明：
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|status|工商授权状态|Integer|是|[工商授权状态码](https://easydoc.xyz/doc/42964146/FECM0vAG/BBRyQ4qh)
|statusText|工商授权状态描述|String|是
## 3.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|是|[工商授权状态码](https://easydoc.xyz/doc/42964146/FECM0vAG/BBRyQ4qh)
|statusText|工商授权状态描述|String|是
## 3.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
> 1.贵司写完后提供到接口url给发放平台即可。回调成功必须返回success，不然会重复回调，至多重试8次。
> 2.每次回调的间隔时间2N次方分钟，比如第一次回调间隔时间为2分钟，第二次就为4分钟，依次往后推，最多重试8次；
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|是|详情请看[个体户注册状态码](https://easydoc.xyz/doc/42964146/FECM0vAG/BBRyQ4qh)|
|taxStatus|税务状态|Integer|是|0：未实名，1：已实名。当该状态变为已实名后才可以进行开票申请操作||
|refuseType|拒绝类型|Integer|否|0：签名无法识别，请重新签名（从新调用3.5.签署接口）,1:政务网注册授权失败","政务网注册授权失败（从新调用3.7.1政务网授权接口）|
|refuseReason|审核拒绝原因|String|否||
|companyName|个体户公司名称|String|是||
|taxNumber|税号|String|否|个体户注册成功之后才会有税号|
|mobile|注册手机号码|String|是||
|address|注册地址|String|是||
|taxType|个税算法类型|String|是|0:累进制、1核定制、2、双定制|
|businessLicense|营业执照|String|否|个体户注册成功之后才会有|
## 3.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 //所属业务线 轻税
}]
```
## 3.10 上传文件接口
>d 该接口将需要上传的文件上传至发放平台服务器，获取到对应的地址用于其他接口作为入参
开发环境：https://pay-dev.lx-rhino.com
生产环境：https://api.lx-rhino.com
#### 接口地址：
/open/api/v1/common/uploadFile
#### 请求方式：POST
#### 请求参数说明：
|参数名称|参数含义|是否必填|参数备注|
|-|-|-|-|
|file|文件|是||
#### 响应参数说明：
|参数名称| 参数含义| 是否必有| 参数备注|
|-|-|-|-|
|url|文件地址|是||
java接口代码示例：
```json
@PostMapping(value = "/upload")
@ResponseBody
@NoPermission
public String upload(MultipartFile file) {
String url = baseUrl +"/open/api/v1/invoices/uploadFile";
final byte[] bytes ;
try {
bytes = file.getBytes();
String appKey = "";
String version = "1.0";
String secretkey = "";
String timestamp = String.valueOf(System.currentTimeMillis());
//注意此处签名无 body拼接
String localString = "&Timestamp=" + timestamp + "&AppKey=" + appKey + "&Version=" + version + "&SecretKey" + secretkey;
String sigin = Md5Util.getMd5(localString);
MultipartBody body = new MultipartBody.Builder()
.setType(MediaType.parse("multipart/form-data"))
.addFormDataPart("file", file.getOriginalFilename(), okhttp3.RequestBody.create(MediaType.parse("image/" + "打款凭证"), bytes))
.build();
Request request = new Request.Builder()
.post(body)
.addHeader("AppKey", appKey)
.addHeader("Timestamp", timestamp)
.addHeader("Version", "1.0")
.addHeader("Sign", sigin)
.url(url)
.build();
Call call = HttpUtil.getOkHttpClient().newCall(request);
try {
Response response = call.execute();
String res = response.body().string();
log.info("res====" + res);
return res;
} catch (IOException e) {
log.error("HttpUtil.post网络请求失败：{}", e.getMessage());
return "网络请求失败";
}
} catch (IOException e) {
log.warn("fail to read file", file.getOriginalFilename(), e);
}
return null;
}
```
postman 直接请求示例：
## 3.11 个体户主动支付申请接口
开发环境：https://pay-dev.lx-rhino.com
生产环境：https://api.lx-rhino.com
#### 接口地址：/open/api/v1/selfRegistered/pay/apply/{token}
#### 请求方式：POST
#### 请求参数说明：
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|mainstayId|主体id|Integer|是|
|confType|业务类型|Integer|是|0 系统注册费、 1 季度代理服务费、 2 系统注销费|
|payType|支付类型|Integer|否|0 银行卡|
|paymentAccount|支付账号|String|是|已绑定的银行卡卡号|
#### 接口响应参数说明：
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|transNo|支付订单号|String|是||
|amount|支付金额|BigDecimal|是|不同的业务类型对应的金额不同|
## 3.12 个体户支付确认接口
开发环境：https://pay-dev.lx-rhino.com
生产环境：https://api.lx-rhino.com
#### 接口地址：/open/api/v1/selfRegistered/pay/confirm/{token}
#### 请求方式：POST
#### 请求参数说明：
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|transNo|支付订单号|String|是|
|verifyCode|验证码|String|是|绑卡的手机号接受的验证码|
>d 绑卡手机号将收到来自银行的支付验证码短信
#### 接口响应参数说明：
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|transNo|支付订单号|String|是|
|transStatus|支付状态|Integer|是|[6.系统管理费 - 支付状态](https://easydoc.top/doc/42964146/FECM0vAG/BBRyQ4qh)|
## 3.13 个体户银行卡绑卡申请接口
开发环境：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|是
>d 支持绑卡银行列表
|序号|银行名称| 银行卡类型|参数备注|
|-|-|-|-|-|
|1|工商银行|借记卡||
|2|农业银行|借记卡||
|3|建设银行|借记卡||
|4|中国银行|借记卡||
|5|浦发银行|借记卡||
|6|光大银行|借记卡||
|7|兴业银行|借记卡||
|8|中信银行|借记卡||
|9|平安银行|借记卡||
|10|华夏银行|借记卡||
|11|广发银行|借记卡||
|12|交通银行|借记卡||
|13|上海银行|借记卡||
|14|浙商银行|借记卡||
|15|北京银行|借记卡||
|16|邮储银行|借记卡||
|17|招商银行|借记卡||
|18|民生银行|借记卡||
|19|渤海银行|借记卡||
## 3.14 银行卡绑定验证码确认接口
开发环境：https://pay-dev.lx-rhino.com
生产环境：https://api.lx-rhino.com
#### 接口地址：/open/api/v1/selfRegistered/bindCard/confirm/{token}
#### 请求方式：POST
#### 请求参数说明：
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|verifyCode|短信验证码|String|是||
|bindCardNo|绑卡订单号|String|是||
>d 该手机号将收到来自银行卡的绑卡验证码短信
#### 接口响应参数说明：
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|bindCardNo|绑卡订单号|String|是||
|status|绑卡状态|Boolean|是|绑定成功为true、绑定失败为false|
## 3.15 个体户支付回调
>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|是|[6.系统管理费 - 支付状态](https://easydoc.top/doc/42964146/FECM0vAG/BBRyQ4qh)|
|payType|支付类型|Integer|是|0银行卡|
|payMethod|付款方式|Integer|是|[7.系统管理费 - 付款方式状态码](https://easydoc.top/doc/42964146/FECM0vAG/BBRyQ4qh)|
|payer|支付对象|Integer|是|0个体户 1商户|
|amount|支付金额|BigDecimal|是||
|accountingPeriods|账期|List<String>|是|[8.系统管理费 - 账期状态码](https://easydoc.top/doc/42964146/FECM0vAG/BBRyQ4qh)|
## 3.16 个体户银行卡绑定查询接口
开发环境：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|是|绑定成功为true、绑定失败为false|
## 3.17 支付结果查询接口
开发环境：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|是|[6.系统管理费 - 支付状态](https://easydoc.top/doc/42964146/FECM0vAG/BBRyQ4qh)|
|payType|支付类型|Integer|是|0银行卡|
|payMethod|付款方式|Integer|是|[7.系统管理费 - 付款方式状态码](https://easydoc.top/doc/42964146/FECM0vAG/BBRyQ4qh)|
|payer|支付对象|Integer|是|0 个体户、 1 商户|
|amount|支付金额|BigDecimal|是||
|accountingPeriods|账期时间|List<String>|是|[8.系统管理费 - 账期状态码](https://easydoc.top/doc/42964146/FECM0vAG/BBRyQ4qh)|
#### 字段解释：
账期：这里的账期时间是指的，个体工商户支付的季度服务费的时间，分为Q1（1月 ~ 3月)、Q2(4月~ 6月)依次类推；
## 3. 18 个体户查询接口
开发环境：https://pay-dev.lx-rhino.com
生产环境：https://api.lx-rhino.com
#### 接口地址：/open/api/v1/ak/akSelfEmployedQuery
#### 请求方式：POST
#### 请求参数说明：
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|idCard|个体户身份证号|String|是||
|mainstayId|注册地|String|是|该参数值由[4.12 查询所拥有的主体发票行业接口](https://easydoc.top/doc/42964146/FECM0vAG/VSOEL8bv) 获得|
#### 接口响应参数说明：
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|status| 个体户状态|Integer|是|[3.个体户状态码对照表](https://easydoc.top/doc/42964146/FECM0vAG/BBRyQ4qh)|
|taxStatus|税务状态|Integer|是|0：未实名，1：已实名。当该状态变为“已实名”后才可以进行开票申请操作||
|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|否|该参数内容可能为空，成功的时候失败原因为空字符串|
|taxType|个税类型|Integer|是|0 累进制、1 核定制、2 双定制|