挂件收缴接口说明（渠道商户收缴）
获取授权码 #01
渠道商户交易前需先获取实际商户授权码，根据不同场景可选择使用二维码扫描方式或接口业务单号方式获取。
二维码扫描获取授权码 #02
二维码扫描获取授权码说明
用户使用渠道商户APP扫描商户收缴二维码时，渠道商户APP获取到相应收缴授权码串。需对相应授权码串解析出授权码，用于后续收缴流程。
授权码串格式为：bosssoft://thirdpay/授权码
接口获取授权码说明
商户后端通过调用我方接口获取授权码，按照接口文档规定的参数进行组织报文，调用生成create的方法，通过商户后端对参数进行加密请求到我方后端。
接口
统一接口为com.bosssoft.sdk.model.Charge.create(chargeMap,serviceUrl,privateKey);
其中chargeMap为接口参数，见下方接口参数章节。
serviceUrl为我方提供的接口地址,在挂件js中已指定。
privateKey为数据传输时签名加密所需使用的商户私钥。
接口返回 #03
接口返回值统一使用String类型接收，再转为相应的值集类型进行后续处理。 数据类型JSONArray：
| 属性 | 描述 | 类型 | 是否必填 | 补充 |
|---|---|---|---|---|
| success | 返回状态 | Boolean | 是 | true：成功,false：失败 |
| auth_code | 授权码 | String | 否 | 发生异常时字段为空 |
| msg | 返回的描述信息 | String | 是 |
Demo #04
@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 = "dept") String dept,
@RequestParam(value = "business_no") String business_no,
HttpServletRequest request, HttpServletResponse response) {
chargeMap.put("merchant_no", merchant_no);// 商户号
chargeMap.put("dept", dept);
chargeMap.put("business_no", business_no);
chargeMap.put("back_url",ParamConstant.BACK_URL);
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年，是行业领先的收缴服务提供商。
政付通小程序
