“查询缴款”接口文档
接口调用说明 #01
用户访问商户页面时,按照接口文档规定的参数进行组织报文,调用SDK中生成create的方法,通过商户后端对参数进行加密请求到我方后端,通过我方处理后返回给商户一个可以自动提交的表单加密返回,SDK解密后自动进行提交即可访问到我方‘查询缴款’页面。
缴款查询接口 #02
统一接口为 com.bosssoft.sdk.model.Charge.create(chargeMap,serviceUrl,privateKey);其中chargeMap为接口参数,见下方接口参数章节。 serviceUrl为我方提供的接口地址: 测试环境为: http://debug.epayservice.cn/thirdpay/app/receive.do 正式环境为: http://api.epayservice.cn/thirdpay/app/receive.do privateKey为数据传输时签名加密所需使用的商户私钥。
接口参数 #02.1
chargeMap参数内容:
属性 | 描述 | 类型 | 是否必填 | 补充 |
---|---|---|---|---|
merchant_no | 商户号 | String | 是 | |
merchant_order_no | 商户订单号 | String | 是 | H5查缴时填唯一随 |
service_url | 服务地址 | String | 是 | 向我方申请商户号时分配给商户 |
device_type | 设备类型 | String | 是 | pc、phone |
effective_time | 有效时间 | String | 否 | 1m~15d,m-分钟,h-小时,d-天 默认当天1c,24点失效 |
version_no | 版本编码 | String | 是 | 默认1.1 |
接口返回 #03
属性 | 描述 | 类型 | 是否必填 | 补充 |
---|---|---|---|---|
form | 可以自动提交的表单 | String |
Demo #04
Map chargeMap = new HashMap();
chargeMap.put("merchant_no", "2102002017061622");//商户号
chargeMap.put("order_no","order1234567890");// 商户端订单号
chargeMap.put("device_type","phone");// 设备类型
chargeMap.put("effective_time","1c");// 有效时间
chargeMap.put("version_no","1.1");// 版本号1.1
chargeMap.put("front_url","http://192.168.1.13:8081/MerchantDemo/frontnotice");
//前端通知地址(商户端后台的地址)
chargeMap.put("back_url","http://192.168.1.13:8081/MerchantDemo/backnotice");
// 后端通知地址(商户端后台地址)
String privateKey = "";//私钥赋值
String form = "";
try{
form = Charge.create(chargeMap, service_url ,privateKey);
logger.info(chargeString);
} catch (Exception e) {
e.printStackTrace();
}
return form;
}
跳转缴款查询页面说明 #05
缴款服务后端返回跳转查询页面的表单,商户端自动提交表单即可跳转到我方查询缴款页面。
关于我们
北京博思致新互联网科技有限责任公司成立于2016年,是行业领先的收缴服务提供商。