单位业务查询接口
方案目标 #01
商户平台在处理个人查询等业务时,可调用单位业务查询接口,通过通用缴款支撑服务查询相关单位业务信息。
运行流程 #02
接口调用说明 #03
我方后端通过调用单位端接口,按照接口文档规定的参数进行组织报文,通后端对参数进行加密请求到单位后端,单位将查询结果加密后,返回给我方。
接口参数 #04
1、解析request请求,将输入流转换成SringBuffer类型的字符串,然后用私钥进行解密,调用SDK封装的统一解密方法,转成json对象,根据接口字段来获取商户对账需要的字段,如下表:
属性 | 描述 | 类型 | 是否必填 | 补充 |
---|---|---|---|---|
conditions | 条件域 | String | 是 | 子Json方式传输条件 |
date_start | 时间起 | String | 是 | YYYYMMDD(含当日) |
date_end | 时间止 | String | 是 | YYYYMMDD(含当日 |
pay_ status | 缴款状态 | String | 是 | 0 全部 1 未缴款 2 已缴款(含处理中) 3 缴款失败 4 待退付 5 已退付 6 已作废 |
条件域说明(条件域需对接时约定实际可用条件)
属性 | 描述 | 类型 | 是否必填 | 补充 |
---|---|---|---|---|
id_no | 身份证号 | String | 否 | |
phone_no | 电话号 | String | 否 | |
business_no | 业务单号 | String | 否 | |
merchant_order_no | 商户订单号 | String | 否 | 北京通扫码缴款至少支持商户订单号查询 |
2、统一解密的方法
com.bosssoft.sdk.model.Message.decryptByPrivateKey(RsaStr, privateKey);
RsaStr为1中解析出加密后的字符串;
privateKey为数据传输时签名加密所需使用的商户私钥。
接口返回 #05
数据类型JSONArray:
属性 | 描述 | 类型 | 是否必填 | 补充 |
---|---|---|---|---|
business_no | 业务单号 | String | 是 | |
payer_name | 缴款人 | String | 是 | |
payer_id_no | 缴款人身份证 | String | 否 | |
payer_id_code | 身份识别码 | String | 否 | 辅助身份识别码,如准考证号,学号等 |
payer_phone_no | 缴款人电话号 | String | 否 | |
merchant_order_no | 单位端商户订单号 | String | 否 | |
items | 收费项目 | List | 是 | |
amt | 收费金额 | String | 是 | 单位:分 |
pay_ status | 缴款状态 | String | 是 | 1 未缴款 2 已缴款(含处理中) 3 缴款失败 4 待退付 5 已退付 |
create_date | 创建日期 | 是 | YYYYMMDD(含当日) | |
time_limit | 缴款期限 | 否 | YYYYMMDD(含当日) |
Items收费项目明细:
属性 | 描述 | 类型 | 是否必填 | 补充 |
---|---|---|---|---|
item_code | 项目编码 | String | 是 | |
item_name | 项目名称 | String | 是 | |
item_amt | 项目金额 | String | 是 |
Demo #06
@RequestMapping(value = "/bizQuery", method = RequestMethod.POST)
@ResponseBody
public String bizQuery (HttpServletRequest request,
HttpServletResponse response) throws Exception {
//从request中获取到输入流,然后解析流到StringBuffer中获取到加密后的Stringbuffer字符串
StringBuffer stringBuffer = new StringBuffer();
try {
InputStream is = request.getInputStream();
InputStreamReader isr = new InputStreamReader(is);
BufferedReader br = new BufferedReader(isr);
String s = "";
while ((s = br.readLine()) != null) {
stringBuffer.append(s);
}
} catch (IOException e) {
e.printStackTrace();
}
String str = stringBuffer.toString();
String privateKey="";//私钥赋值
String mes=Message.decryptByPrivateKey(str,privateKey);
logger.info(mes);
//组装查询返回值
String query ="";
RSAMethod rsaMethod=new RSAMethod();
Base64Utils bs = new Base64Utils();
//私钥将对象加密
byte[] chargeOBJ=null;
String chargeSTR=null;
try {
chargeOBJ = rsaMethod.encryptByPrivateKey(query.getBytes(), ThirdPay.privateKey);
chargeSTR= bs.encode(chargeOBJ);
} catch (Exception e1) {
e1.printStackTrace();
}
return chargeSTR;
}
关于我们
北京博思致新互联网科技有限责任公司成立于2016年,是行业领先的收缴服务提供商。
政付通小程序
公司动态
其它信息
联系我们
联系电话:
13189095618
获取方案
留下您的联系方式,获取专业解决方案。