单位业务查询接口(接收方式)
方案目标 #01
商户在完成业务处理或变更时,可向收缴平台发送待查业务单信息,用于相应渠道商户查询使用。
运行流程 #02
接口调用说明 #03
接口 #04
统一接口为 com.bosssoft.sdk.model.Charge.create(chargeMap,serviceUrl,privateKey); 其中chargeMap为接口参数,见下方接口参数章节。 serviceUrl为我方提供的接口地址: 测试环境为: http://debug.epayservice.cn/thirdpay/charge/receivebusinessbill.do 正式环境为: http://api.epayservice.cn/thirdpay/charge/ receivebusinessbill.do privateKey为数据传输时签名加密所需使用的商户私钥。
接口参数 #05
chargeMap参数内容:
属性 | 描述 | 类型 | 是否必填 | 补充 |
---|---|---|---|---|
merchant_no | 商户号 | String | 是 | |
widget_content | 订单内容 | String | 是 | 转出时需使用私钥签名 |
extra | 扩展参数 | String | 否 |
widget_content参数内容(JSON):
属性 | 描述 | 类型 | 是否必填 | 补充 |
---|---|---|---|---|
merchant_no | 商户号 | String | 是 | |
business_no | 业务单号 | String | 是 | 主键 |
payer_name | 缴款人 | String | 是 | |
payer_id_no | 缴款人身份证 | String | 否 | |
payer_id_code | 身份识别码 | String | 否 | 辅助身份识别码,如准考证号,学号等 |
payer_phone_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 | 是 |
接口返回 #05
属性 | 描述 | 类型 | 是否必填 | 补充 |
---|---|---|---|---|
success | 返回状态 | Boolean | 是 | true:成功,false:失败 |
extraInfo | 返回跳转的信息 | String | 否 | 发生异常时字段为空, Key值paycode为缴款码 |
msg | 返回的描述信息 | String | 是 |
Demo #06
@RequestMapping(value = "/createCharge", method = RequestMethod.POST,
produces={"text/html;charset=UTF-8;","application/json;"})
@ResponseBody
public String createCharge(
@RequestParam(value = "merchant_no", required = true) String merchant_no,
@RequestParam(value = "merchant_order_no") String merchant_order_no,
@RequestParam(value = "amount") Integer amount,
@RequestParam(value = "channel") String channel,
@RequestParam(value = "widget_content", required = true) String widget_content,
@RequestParam(value = "service_url", required = true) String service_url,
HttpServletRequest request, HttpServletResponse response) {
// merchant_no,channel,merchant_order_no,amount用于验证订单一致性和获取信息。
logger.info(merchant_no);
logger.info(merchant_order_no);
logger.info(amount);
// 收缴渠道取值,用户选择收缴方式点提交后,会将channel传进来
logger.info(channel);
//重要:构造chargeMap
Map chargeMap = new HashMap();
chargeMap.put("merchant_no", merchant_no);
// 商户号,应与js中传入的一致,接到的merchant_no参数
chargeMap.put("widget_content", widget_content);// 组装json串
//chargeMap.put("front_url", ParamConstant.FRONT_URL);// 前端通知地址
//chargeMap.put("back_url",ParamConstant.BACK_URL);// 后端通知地址
Map extra = new HashMap();
chargeMap.put("extra", extra);
// 扩展参数,如果有需要的话构造一个map然后将map转换成json串传入
String chargeString = "";
String privateKey = "";//私钥赋值
try{
//发起 create创建charge请求(参数为构造的的chargeMap,传入的controller的service_url)
chargeString = Charge.create(chargeMap, service_url ,privateKey);
logger.info(chargeString);
} catch (Exception e) {
e.printStackTrace();
}
return chargeString;
}
关于我们
北京博思致新互联网科技有限责任公司成立于2016年,是行业领先的收缴服务提供商。
公司动态
其它信息
联系我们
获取方案