说明：本接口由交易平台提供，用于接收App扫码后共享的所有数据。
备注：type是收到数据类型，data是收到的数据。请根据type判断data。
一、type = 01（接收扫码状态信息）
平台系统方法名：receiveScanData
1、中招互连请求交易平台参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| type | varchar(2) | 是 | 数据类型01 扫码状态 |
| data | text | 是 | 参数内容（json） |
| ┗ encrypt | String | 是 | 加密的信息 |
2、调用SDK方法进行数据解密
SDK接口方法： HttpSweepCodeUtil.getScanstatusReceiveData(data);
入参： String data
返回值：ScanstatusReceiveVo
3、请求参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| data | text | 是 | 参数内容（json） |
4、响应参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| tId | varchar(50) | 事件ID |
| unifiedTransactionCode | varchar(50) | 机构交易码 |
| personalTransactionCode | varchar(50) | 个人交易码 |
| isScaned | varchar(50) | 扫码状态：01已扫00未扫 |
| qRCodeType | varchar(2) | 二维码类型 |
5、交易平台储存数据
数据入库，或放入缓存，由本平台的工具或web页面通过tId查询
6、交易平台响应给中招互连参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| header | ||
| ┗ ret | String | 0成功/1失败 |
| ┗ msg | String | 结果说明 |
| data | Null | 为空即可 |
二、type = 02（接收共享登录用户信息）
平台系统方法名：receiveScanData
1、中招互连请求交易平台参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| type | varchar(2) | 是 | 数据类型02 扫码用户信息 |
| data | text | 是 | 参数内容（json） |
| ┗ encrypt | String | 是 | 加密的信息 |
2、调用SDK方法进行数据解密
SDK接口方法：HttpSweepCodeUtil.getUserInfoReceiveData(data);
入参： String data
返回值：ScanningUserInfoReceiveVo
3、请求参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| data | text | 是 | 参数内容（json） |
4、请求示例
HttpSweepCodeUtil.getUserInfoReceiveData(data);
5、响应参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| TId | varchar(50) | 事件id |
| personName | varchar(50) | 用户姓名 |
| telephoneNum | varchar(20) | 手机号码 |
| idCard | varchar(18) | 身份证号 |
| personalTransactionCode | varchar(50) | 个人交易码 |
| unifiedTransactionCode | varchar(50) | 电子交易全国共享码 |
| sharedCodeStatus | varchar(2) | 电子交易全国共享码状态 正常01、作废02、冻结03 |
| legalCode | varchar(18) | 组织机构代码 |
| legalName | varchar(100) | 机构名称 |
| legalRepresent | varchar(50) | 法定代表人姓名 |
| legalIDCard | varchar(18) | 注册机构法人身份证 |
| managerTelephoneNum | varchar(20) | 管理员手机号 |
| certSn | varchar(40) | CA证书Id/序列号 |
| caType | varchar(2) | CA类型 |
| caOrgType | varchar(10) | CA机构类型编码 |
| signOriVal | varchar(50) | 签名原值 |
| signatureValue | text | CA签名值 |
| pubCert | text | 公钥证书 |
| algorithm | varchar(10) | 加密算法 |
| accessToken | text | 授权码（用于调用app服务端其他接口） |
| loginUserType | varchar(2) | 登录类型01个人/02机构 |
6、交易平台储存数据
数据入库，或放入缓存，由本平台的工具或web页面通过本次二维码里的tId查询。
用户信息绑定：机构登录使用机构交易码绑定。
如果账号已被绑定过再次绑定可以提醒：账号已被其他手机号绑定，确认要更新吗。
7、交易平台响应给中招互连参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| header | ||
| ┗ ret | String | 0成功/1失败 |
| ┗ msg | String | 结果说明 |
| data | Null | 为空即可 |
三、type = 03（接收撤章信息）
平台系统方法名：receiveScanData
1、中招互连请求交易平台参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| type | varchar(2) | 是 | 数据类型03 撤章信息 |
| data | text | 是 | 参数内容（json） |
| ┗encrypt | String | 是 | 加密的信息 |
2、调用SDK方法进行数据解密
SDK接口方法：HttpSweepCodeUtil.getSignatureReceiveData
入参： String data
返回值：ScanningSignatureReceiveVo signatureReceiveData
3、请求参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| data | text | 是 | 参数内容（json） |
4、请求示例
ScanningSignatureReceiveVo signatureReceiveData = HttpSweepCodeUtil.getSignatureReceiveData(data);
5、响应参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| TId | varchar(50) | 事件id |
| useStatus | varchar(2) | 使用状态00未使用01已使用 |
| personalTransactionCode | varchar(50) | 个人交易码 |
| unifiedTransactionCode | varchar(50) | 电子交易全国共享码 |
| certSn | varchar(40) | CA证书Id/序列号 |
| caOrgType | varchar(10) | CA机构类型编码 |
| signOriVal | varchar(50) | 签名原值 |
| signatureValue | text | CA签名值 |
| pubCert | text | 公钥证书 |
| algorithm | varchar(10) | 加密算法 |
6、交易平台储存数据
数据入库，或放入缓存，由本平台的工具或web页面通过本次二维码里的tId查询,然后在控件里合章
7、交易平台响应给中招互连参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| header | ||
| ┗ret | String | 0成功/1失败 |
| ┗msg | String | 结果说明 |
| data | Null | 为空即可 |
四、type = 05（接收扫码加密信息）
方法：receiveScanData
1、中招互连请求交易平台参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| type | varchar(2) | 是 | 数据类型05扫码加密信息 |
| data | text | 是 | 参数内容（json） |
| ┗encrypt | String | 是 | 加密的信息 |
2、调用SDK方法进行数据解密
SDK接口方法：HttpSweepCodeUtil.getEncryptCertReceiveData()；
入参： Stringdata
返回值：EncryptCertReceiveVo encryptCertReceiveData
3、请求参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| data | text | 是 | 参数内容（json） |
4、请求示例
EncryptCertReceiveVo encryptCertReceiveData = HttpSweepCodeUtil.getEncryptCertReceiveData(data);
5、响应参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| TId | varchar(50) | 事件id |
| personalTransactionCode | varchar(50) | 个人交易码 |
| caOrgType | varchar(10) | CA机构类型编码 |
| signOriVal | varchar(50) | 签名原值 |
| signatureValue | text | CA签名值 |
| encPubCert | text | 加密的公钥证书 |
| signCertSn | varchar(50) | 签名证书的序列号 |
| encCertSn | varchar(50) | 加密证书的序列号 |
| pubCert | varchar(50) | 签名公钥 |
| algorithm | varchar(10) | 签名算法：SM2和RSA |
| telephoneNum | varchar(11) | 加密人手机号码 |
6、交易平台储存数据
数据入库，或放入缓存，由本平台的工具或web页面通过tId查询
7、交易平台响应给中招互连参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| header | ||
| ┗ ret | String | 0成功/1失败 |
| ┗ msg | String | 结果说明 |
| data | Null | 为空即可 |
五、type = 06（接收扫码解密信息）
方法：receiveScanData
1、中招互连请求交易平台参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| type | varchar(2) | 是 | 数据类型06扫码解密信息 |
| data | text | 是 | 参数内容（json） |
| ┗ encrypt | String | 是 | 加密的信息 |
2、调用SDK方法进行数据解密
SDK接口方法：HttpSweepCodeUtil.getDecryInfoReceiveData();
入参： Stringdata
返回值：DecryptReceiveVo decryInfoReceiveData
3、请求参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| data | text | 是 | 参数内容（json） |
4、请求示例
DecryptReceiveVo decryInfoReceiveData = HttpSweepCodeUtil.getDecryInfoReceiveData(data);
5、响应参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| TId | varchar(50) | 事件id |
| personalTransactionCode | varchar(50) | 个人交易码 |
| decryptInfoList | List | |
| ┗ key | varchar(50) | 主键 |
| ┗ decryptStr | varchar(50) | 解密串 |
6、交易平台储存数据
数据入库，或放入缓存，由本平台的工具或web页面通过本次二维码里的tId查询
7、交易平台响应给中招互连参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| header | ||
| ┗ ret | String | 0成功/1失败 |
| ┗ msg | String | 结果说明 |
| data | Null | 为空即可 |
六、type = 08（接收SM2签章证书信息）
方法：receiveScanData
1、中招互连请求交易平台参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| type | varchar(2) | 是 | 数据类型08 SM2签章证书信息 |
| data | text | 是 | 参数内容（json） |
| ┗ encrypt | String | 是 | 加密的信息 |
2、调用SDK方法进行数据解密
SDK接口方法：HttpSweepCodeUtil.getSignCertReceiveData();
入参： Stringdata
返回值：SignCertVo signCertVo
3、请求参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| data | text | 是 | 参数内容（json） |
4、请求示例
SignCertVo signCertVo = HttpSweepCodeUtil.getSignCertReceiveData(data);
5、响应参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| tId | varchar(50) | 事件id |
| signCertSn | varchar(50) | 证书序列号 |
| pubCert | text | 公钥证书 |
6、交易平台储存数据
数据入库，或放入缓存，由本平台的工具或web页面通过本次二维码里的tId查询
7、交易平台响应给中招互连参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| header | ||
| ┗ ret | String | 0成功/1失败 |
| ┗ msg | String | 结果说明 |
| data | Null | 为空即可 |
七、type = 09（接收：谁扫谁解密用户信息）
平台系统方法名：receiveScanData
1、中招互连请求交易平台参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| type | varchar(2) | 是 | 数据类型09 谁扫谁解密用户信息 |
| data | text | 是 | 参数内容（json） |
| ┗ encrypt | String | 是 | 加密的信息 |
2、调用SDK方法进行数据解密
SDK接口方法：HttpSweepCodeUtil.getUserInfoReceiveData(data);
入参：String data
返回值：ScanningUserInfoReceiveVo
3、请求参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| data | text | 是 | 参数内容（json） |
4、请求示例
HttpSweepCodeUtil.getUserInfoReceiveData(data);
5、响应参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| TId | varchar(50) | 事件id |
| personName | varchar(50) | 用户姓名 |
| telephoneNum | varchar(20) | 手机号码 |
| idCard | varchar(18) | 身份证号 |
| personalTransactionCode | varchar(50) | 个人交易码 |
| unifiedTransactionCode | varchar(50) | 电子交易全国共享码 |
| sharedCodeStatus | varchar(2) | 电子交易全国共享码状态 正常01、作废02、冻结03 |
| legalCode | varchar(18) | 组织机构代码 |
| legalName | varchar(100) | 机构名称 |
| legalRepresent | varchar(50) | 法定代表人姓名 |
| legalIDCard | varchar(18) | 注册机构法人身份证 |
| managerTelephoneNum | varchar(20) | 管理员手机号 |
| certSn | varchar(40) | CA证书Id/序列号 |
| caType | varchar(2) | CA类型 |
| caOrgType | varchar(10) | CA机构类型编码 |
| signOriVal | varchar(50) | 签名原值 |
| signatureValue | text | CA签名值 |
| pubCert | text | 公钥证书 |
| algorithm | varchar(10) | 加密算法 |
| accessToken | text | 授权码（用于调用app服务端其他接口） |
| loginUserType | varchar(2) | 登录类型01个人/02机构 |
6、交易平台储存数据
数据入库，或放入缓存，由本平台的工具或web页面通过本次二维码里的tId查询。
7、交易平台响应给中招互连参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| header | ||
| ┗ ret | String | 0成功/1失败 |
| ┗ msg | String | 结果说明 |
| data | Null | 为空即可 |
八、type = 12（接收：退出连续签章）
平台系统方法名：receiveScanData
1、中招互连请求交易平台参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| type | varchar(2) | 是 | 数据类型12 退出连续签章 |
| data | text | 是 | 参数内容（json） |
| ┗ encrypt | String | 是 | 加密的信息 |
2、调用SDK方法进行数据解密
SDK接口方法：HttpSweepCodeUtil.getExitReceiveData(data);
入参：String data
返回值：ExitReceiveVo exitReceiveVo
3、请求参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| data | text | 是 | 参数内容（json） |
4、请求示例
ExitReceiveVo exitReceiveVo = HttpSweepCodeUtil.getExitReceiveData(data);
5、响应参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| tid | varchar(50) | 事件id |
| pid | varchar(50) | 用户姓名 |
| source | varchar(10) | 指令的来源00 app端，01 交易平台 |
| exitType | varchar(2) | 退出指令的类型 12：退出连续签章模式 |
6、交易平台储存数据
数据入库，或放入缓存，由本平台的工具或web页面通过本次二维码里的tId查询。
7、交易平台响应给中招互连参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| header | ||
| ┗ ret | String | 0成功/1失败 |
| ┗ msg | String | 结果说明 |
| data | Null | 为空即可 |
九、type = 13（接收：需要签章的用户信息）
1、接收扫码用户信息，本接口由交易平台提供，用于接收app服务端回调数据使用
平台系统方法名：receiveScanData
2、中招互连请求交易平台参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| type | varchar(2) | 是 | 数据类型13 ，需要签章的用户信息 |
| data | text | 是 | 参数内容（json） |
| ┗ encrypt | String | 是 | 加密的信息 |
3、调用SDK方法进行数据解密（获取用户信息）
SDK接口方法：HttpSweepCodeUtil.getUserInfoReceiveData(data);
入参： String data
返回值： ScanningUserInfoReceiveVo
4、请求参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| data | text | 是 | 参数内容（json） |
5、请求示例
HttpSweepCodeUtil.getUserInfoReceiveData(data);
6、响应参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| TId | varchar(50) | 事件id |
| personName | varchar(50) | 用户姓名 |
| telephoneNum | varchar(20) | 手机号码 |
| idCard | varchar(18) | 身份证号 |
| personalTransactionCode | varchar(50) | 个人交易码 |
| unifiedTransactionCode | varchar(50) | 电子交易全国共享码 |
| sharedCodeStatus | varchar(2) | 电子交易全国共享码状态 正常01、作废02、冻结03 |
| legalCode | varchar(18) | 组织机构代码 |
| legalName | varchar(100) | 机构名称 |
| legalRepresent | varchar(50) | 法定代表人姓名 |
| legalIDCard | varchar(18) | 注册机构法人身份证 |
| managerTelephoneNum | varchar(20) | 管理员手机号 |
| certSn | varchar(40) | CA证书Id/序列号 |
| caType | varchar(2) | CA类型 |
| caOrgType | varchar(10) | CA机构类型编码 |
| signOriVal | varchar(50) | 签名原值 |
| signatureValue | text | CA签名值 |
| pubCert | text | 公钥证书 |
| algorithm | varchar(10) | 加密算法 |
| accessToken | text | 授权码（用于调用app服务端其他接口） |
| loginUserType | varchar(2) | 登录类型01个人/02机构 |
| algorithmType | varchar(2) | 证书类型, 00 sm2/01 RSA |
| certBelongType | varchar(2) | 证书所属类型 01个人/02机构 |
7、交易平台储存数据
数据入库，或放入缓存，由本平台的工具或web页面通过本次二维码里的tId查询。
8、交易平台响应给App服务端参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| header | ||
| ┗ ret | String | 0成功/1失败 |
| ┗ msg | String | 结果说明 |
| data | Null | 为空即可 |
十、type = 14（接收：签名值信息）
1、app服务端推送签名值到交易平台
平台系统方法名：receiveScanData
2APP服务端请求参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| type | varchar(2) | 是 | 数据类型14 签名值信息 |
| data | text | 是 | 参数内容（json） |
| ┗ desKey | String | 是 | 加密的对称秘钥 |
| ┗ encrypt | String | 是 | 加密的信息 |
3、调用SDK方法进行数据解密
SDK接口方法：HttpSweepCodeUtil.getSignatureReceiveData
入参： String data
返回值：ScanningSignatureReceiveVo signatureReceiveData
4、请求参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| data | text | 是 | 参数内容（json） |
5、请求示例
ScanningSignatureReceiveVo signatureReceiveData = HttpSweepCodeUtil.getSignatureReceiveData(data);
6、响应参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| TId | varchar(50) | 事件id |
| useStatus | varchar(2) | 使用状态00未使用01已使用 |
| personalTransactionCode | varchar(50) | 个人交易码 |
| unifiedTransactionCode | varchar(50) | 电子交易全国共享码 |
| certSn | varchar(40) | CA证书Id/序列号 |
| caOrgType | varchar(10) | CA机构类型编码 |
| pubCert | text | 公钥证书 |
| algorithm | varchar(10) | 加密算法 |
| signatureValueList | text | 一组哈希值 |
7、交易平台储存数据
数据入库，或放入缓存，由本平台的工具或web页面通过本次二维码里的tId查询,然后在控件里合章
8、交易平台响应给App服务端参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| header | ||
| ┗ ret | String | 0成功/1失败 |
| ┗ msg | String | 结果说明 |
| data | Null | 为空即可 |