单位业务查询接口
接口调用说明 #01
商户后端通过调用我方接口,按照接口文档规定的参数进行组织报文,调用生成create的方法, 通过商户后端对参数进行加密请求到我方后端。
接口 统一接口为 com.bosssoft.sdk.model.Charge.create(chargeMap,serviceUrl,privateKey); 其中chargeMap为接口参数,见下方接口参数章节。 serviceUrl为我方提供的接口地址,在挂件js中已指定。 privateKey为数据传输时签名加密所需使用的商户私钥。
接口参数 #02
chargeMap参数内容:
属性 | 描述 | 类型 | 是否必填 | 补充 |
---|---|---|---|---|
merchant_no | 商户号 | String | 是 | |
conditions | 条件域 | String | 是 | 子Json方式传输条件 |
depts | 单位集 | String | 否 | 集合方式,#号分割 |
date_start | 时间起 | String | 是 | YYYYMMDD(含当日) |
date_end | 时间止 | String | 是 | YYYYMMDD(含当日) |
pay_ status | 缴款状态 | String | 是 | 0 全部 1 未缴款 2 已缴款(含处理中) 3 缴款失败 4 待退付 5 已退付 |
属性 | 描述 | 类型 | 是否必填 | 补充 |
---|---|---|---|---|
id_no | 身份证号 | String | 否 | |
id_code | 身份识别码 | String | 否 | 辅助身份识别码,如准考证号,学号等 |
phone_no | 电话号 | String | 否 | |
business_no | 业务单号 | String | 否 | |
auth_code | 授权码 | String | 否 |
接口返回 #03
接口返回值统一使用String类型接收,再转为相应的值集类型进行后续处理。
数据类型JSONArray::
属性 | 描述 | 类型 | 是否必填 | 补充 |
---|---|---|---|---|
dept | 单位 | String | 是 | |
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 已退付 6 已作废 |
create_date | 创建日期 | 是 | YYYYMMDD | |
time_limit | 缴款期限 | 否 | YYYYMMDD(含当日) |
Items明细:
属性 | 描述 | 类型 | 是否必填 | 补充 |
---|---|---|---|---|
item_code | 项目编码 | String | 是 | |
item_name | 项目名称 | String | 是 | |
item_amt | 项目金额 | String | 是 |
Demo #04
Map chargeMap = new HashMap();
chargeMap.put("merchant_no", "1000002017061622");//商户号
chargeMap.put("conditions"," {phone:13700000000, student:170372001}");
chargeMap.put("depts","1000001#1000002");
chargeMap.put("date_start","20170801");
chargeMap.put("date_end","20170830");
chargeMap.put("pay_ status","0");
String querySingle= "";
try{
//发起 create创建charge请求(参数为构造的的chargeMap,传入的controller的service_url)
String privateKey = "";//私钥赋值
querySingle = Charge.create(chargeMap, service_url,privateKey);
logger.info(querySingle);
} catch (Exception e) {
e.printStackTrace();
}
return querySingle;
}
关于我们
北京博思致新互联网科技有限责任公司成立于2016年,是行业领先的收缴服务提供商。
政付通小程序
公司动态
其它信息
联系我们
联系电话:
13189095618
获取方案
留下您的联系方式,获取专业解决方案。