美文网首页
银联便民缴费

银联便民缴费

作者: 小花生L | 来源:发表于2020-04-09 11:42 被阅读0次

    一、银联便民缴费产品介绍

    • 银联便民缴费产品向用户提供水电煤等缴费业务的账单费用查询及缴费服务。目前覆盖电费、水费、燃气费、通讯费、有线电视、手机充值、交通罚没等300余项可开放缴费项目，覆盖300多个地级市。

    二、快速接入

    流程图

    • 便民缴费


      便民缴费

    • APP 缴费类

    APP缴费类

    • 后台扣款类


      后台扣款类

    • 前台扣款类

    前台扣款类

    • Token缴费


      Token缴费
    缴费产品Token

    代码示例

    • 使用SDK快速接入（账单支付）
      账单支付接口com.unionpay.acp.demo.Form_6_3_BillPay_Back：
    protected void  doPost(HttpServletRequest req, HttpServletResponse resp)

throws ServletException,  IOException {


String merId = req.getParameter("merId");

String orderId =  req.getParameter("orderId");

String txnTime =  req.getParameter("txnTime");

String txnAmt =  req.getParameter("txnAmt");

String bussCode =  req.getParameter("bussCode");

String origQryId =  req.getParameter("origQryId");

String billQueryInfo =  req.getParameter("billQueryInfo");


Map<String, String> data =  new HashMap<String, String>();


/***银联全渠道系统，产品参数，除了encoding自行选择外其他不需修改***/

data.put("version",  DemoBase.version);          //版本号

data.put("encoding",  DemoBase.encoding);      //字符集编码 可以使用UTF-8,GBK两种方式

data.put("signMethod",  SDKConfig.getConfig().getSignMethod()); //签名方法

data.put("txnType",  "13");                //交易类型 13 账单支付

data.put("txnSubType",  "01");               //交易子类型 01 便民缴费

data.put("bizType",  "000601");              //业务类型

data.put("channelType",  "07");              //渠道类型07-PC

data.put("accessType",  "0");

data.put("currencyCode",  "156");


/***商户接入参数***/

data.put("merId",  merId);           //商户号码（商户号码777290058110097仅做为测试调通交易使用，该商户号配置了需要对敏感信息加密）测试时请改成自己申请的商户号，【自己注册的测试777开头的商户号不支持代收产品】

data.put("orderId",  orderId);        //商户订单号，8-40位数字字母，不能含“-”或“_”，可以自行定制规则

data.put("txnTime",  txnTime);       //订单发送时间，格式为YYYYMMDDhhmmss，必须取当前时间，否则会报txnTime无效

data.put("txnAmt",  txnAmt);

if(null != origQryId &&  !"".equals(origQryId)){

data.put("origQryId",  origQryId); //账单要素，根据前文显示要素列表由用户填写值，此处默认取demo演示页面传递的参数

}

data.put("bussCode",  bussCode);          //

data.put("billQueryInfo",  AcpService.base64Encode(billQueryInfo, DemoBase.encoding));


Map<String,String>  customerInfoMap = new HashMap<String,String>();

customerInfoMap.put("certifTp",  "01"); //证件类型

customerInfoMap.put("certifId",  "341126197709218366"); //证件号码

customerInfoMap.put("customerNm",  "全渠道"); //姓名

customerInfoMap.put("phoneNo",  "13552535506");   //手机号

//customerInfoMap.put("cvn2",  "123");      //卡背面的cvn2三位数字

//customerInfoMap.put("expired",  "1711");    //有效期 年在前月在后


/////////不对敏感信息加密使用：

//contentData.put("accNo",  "6216261000000000018");      //这里测试的时候使用的是测试卡号，正式环境请使用真实卡号

//String customerInfoStr =  AcpService.getCustomerInfo(customerInfoMap,null,DemoBase.encoding_UTF8);

////////


//////////如果商户号开通了 商户对敏感信息加密的权限那么，需要对 卡号accNo，pin和phoneNo，cvn2，expired加密（如果这些上送的话），对敏感信息加密使用：

data.put("encryptCertId",AcpService.getEncryptCertId());

String accNo =  AcpService.encryptData("6216261000000000018", DemoBase.encoding);

data.put("accNo",  accNo);

String customerInfoStr =  AcpService.getCustomerInfoWithEncrypt(customerInfoMap,"6216261000000000018",DemoBase.encoding);

//////////


data.put("customerInfo",  customerInfoStr);

data.put("backUrl",  DemoBase.backUrl);//后台通知地址


// 请求方保留域，

// 透传字段，查询、通知、对账文件中均会原样出现，如有需要请启用并修改自己希望透传的数据。

// 出现部分特殊字符时可能影响解析，请按下面建议的方式填写：

// 1. 如果能确定内容不会出现&={}[]"'等符号时，可以直接填写数据，建议的方法如下。

// data.put("reqReserved",  "透传信息1|透传信息2|透传信息3");

// 2. 内容可能出现&={}[]"'符号时：

// 1) 如果需要对账文件里能显示，可将字符替换成全角＆＝｛｝【】“‘字符（自己写代码，此处不演示）；

// 2) 如果对账文件没有显示要求，可做一下base64（如下）。

//  注意控制数据长度，实际传输的数据长度不能超过1024位。

//  查询、通知等接口解析时使用new String(Base64.decodeBase64(reqReserved),  DemoBase.encoding);解base64后再对数据做后续解析。

// data.put("reqReserved",  Base64.encodeBase64String("任意格式的信息都可以".toString().getBytes(DemoBase.encoding)));


/**对请求参数进行签名并发送http  post请求，接收同步应答报文**/

Map<String, String>  reqData = AcpService.sign(data,DemoBase.encoding); //报文中certId,signature的值是在signData方法中获取并自动赋值的，只要证书配置正确即可。

String requestBackUrl =  SDKConfig.getConfig().getJfBackRequestUrl();  //交易请求url从配置文件读取对应属性文件acp_sdk.properties中的 acpsdk.backTransUrl

Map<String, String>  rspData = AcpService.post(reqData,requestBackUrl,DemoBase.encoding); //发送请求报文并接受同步应答（默认连接超时时间30秒，读取返回结果超时时间30秒）;这里调用signData之后，调用submitUrl之前不能对submitFromData中的键值对做任何修改，如果修改会导致验签不通过


/**对应答码的处理，请根据您的业务逻辑来编写程序,以下应答码处理逻辑仅供参考------------->**/

//应答码规范参考open.unionpay.com帮助中心 下载 产品接口规范 《平台接入接口规范-第5部分-附录》

if(!rspData.isEmpty()){

if(AcpService.validate(rspData,  DemoBase.encoding)){

LogUtil.writeLog("验证签名成功");

String respCode =  rspData.get("respCode") ;

if(("00").equals(respCode)){

//成功

//TODO

String  queryId = rspData.get("queryId");

String  billDetailInfo = rspData.get("billDetailInfo");


}else  if("03".equals(respCode)||

"04".equals(respCode)||

   "05".equals(respCode)){

//TODO

//处理超时，请稍后查询。

}

else{

//其他应答码为失败请排查原因或做失败处理

//TODO

}

}else{

LogUtil.writeErrorLog("验证签名失败");

//TODO 检查验证签名失败的原因

}

}else{

//未返回正确的http状态

LogUtil.writeErrorLog("未获取到返回报文或返回http状态码非200");

}

String reqMessage =  DemoBase.genHtmlResult(reqData);

String rspMessage =  DemoBase.genHtmlResult(rspData);

resp.getWriter().write("请求报文:<br/>"+reqMessage+"<br/>"  + "应答报文:</br>"+rspMessage+"");

}
    • 使用SDK快速接入（账单查询）
      账单查询接口com.unionpay.acp.demo. Form_6_2_BillQuery：
    protected void doPost(HttpServletRequest req, HttpServletResponse resp)

throws ServletException, IOException {


String merId = req.getParameter("merId");

String orderId = req.getParameter("orderId");

String txnTime = req.getParameter("txnTime");

String bussCode = req.getParameter("bussCode");

String billQueryInfo = req.getParameter("billQueryInfo");

String origQryId = req.getParameter("origQryId");


Map<String, String> data = new HashMap<String, String>();


/***银联全渠道系统，产品参数，除了encoding自行选择外其他不需修改***/

data.put("version", DemoBase.version);                  //版本号

data.put("encoding", DemoBase.encoding);           //字符集编码 可以使用UTF-8,GBK两种方式

data.put("signMethod", SDKConfig.getConfig().getSignMethod()); //签名方法

data.put("txnType", "73");                              //交易类型 73 账单查询

data.put("txnSubType", "01");                           //交易子类型 01 便民缴费

data.put("bizType", "000601");                          //业务类型 

data.put("channelType", "07");                          //渠道类型

data.put("accessType", "0");


/***商户接入参数***/

data.put("merId", merId);                     //商户号码（商户号码777290058110097仅做为测试调通交易使用，该商户号配置了需要对敏感信息加密）测试时请改成自己申请的商户号，【自己注册的测试777开头的商户号不支持代收产品】

data.put("orderId", orderId);               //商户订单号，8-40位数字字母，不能含“-”或“_”，可以自行定制规则

data.put("txnTime", txnTime);           //订单发送时间，格式为YYYYMMDDhhmmss，必须取当前时间，否则会报txnTime无效


data.put("bussCode", bussCode);// 业务类型号，此处默认取demo演示页面传递的参数

data.put("billQueryInfo", AcpService.base64Encode(billQueryInfo,DemoBase.encoding));// 账单要素，根据前文显示要素列表由用户填写值，此处默认取demo演示页面传递的参数


if(null!=origQryId && !"".equals(origQryId)){

data.put("origQryId", origQryId);

}


/**对请求参数进行签名并发送http post请求，接收同步应答报文**/

Map<String, String> reqData = AcpService.sign(data,DemoBase.encoding);//报文中certId,signature的值是在signData方法中获取并自动赋值的，只要证书配置正确即可。

String requestBackUrl = SDKConfig.getConfig().getJfBackRequestUrl();  //交易请求url从配置文件读取对应属性文件acp_sdk.properties中的 acpsdk.backTransUrl

Map<String, String> rspData = AcpService.post(reqData,requestBackUrl,DemoBase.encoding); //发送请求报文并接受同步应答（默认连接超时时间30秒，读取返回结果超时时间30秒）;这里调用signData之后，调用submitUrl之前不能对submitFromData中的键值对做任何修改，如果修改会导致验签不通过


/**对应答码的处理，请根据您的业务逻辑来编写程序,以下应答码处理逻辑仅供参考------------->**/

//应答码规范参考open.unionpay.com帮助中心 下载  产品接口规范  《平台接入接口规范-第5部分-附录》

if(!rspData.isEmpty()){

if(AcpService.validate(rspData, DemoBase.encoding)){

LogUtil.writeLog("验证签名成功");

String respCode = rspData.get("respCode") ;

if(("00").equals(respCode)){

//成功

//TODO

String queryId = rspData.get("queryId");

String billDetailInfo = AcpService.base64Decode(rspData.get("billDetailInfo"),DemoBase.encoding);


//*****以下注释的账单查询结果可以自行调试使用********//

//账单查询查询到的 bill类型账单支付展示页面（账单条目项）

//String billDetailInfo="{"title":"账单缴费 - 青岛联通GSM","form":[{"type":"string","label":"合同号","value":"3200401849"},{"type":"string","label":"用户名","value":"马振海"},{"type":"string","label":"代表号","value":"13061339218"},{"type":"string","label":"手机区域","value":"0532"},{"type":"string","label":"用户数量","value":"1"},{"value":"后付费","label":"付费标志","type":"String"},{"type":"hidden","name":"amount","value":"45.71"},{"type":"string","label":"账单金额(元)","value":"45.71","name":"amountstr"},{"name":"owe_tag","value":"D","label":"欠费标志","type":"hidden"}],"action":"prepay","code":"I1_4520_0001"}";


//账单查询查询到的 singlebill类型账单支付展示页面（包含详情的单选账单）

//String billDetailInfo="{"title": "账单缴费 - 青岛联通GSM","form": [{"type":"singlebill","label":"账单条目","name":"bill_id","options":[{"disable":"0","label":"物业费6.00元","value":"1234567890","amount":"6.00","detail":[{"label":"订单编号","value":"00001"},{"value":"物业费"},{"label":"账期","value":"3月"},{"label":"收费金额","value":"6.00元"}]},{"label":"取暖费600元","disable":"1","value":"1234567891","amount":"600","detail":[{"label": "订单编号","value":"00002"},{"label":"收费名称","value":"取暖费"},{"label":"账期","value":"3月"},{"label":"收费金额","value":"600元"}]},{"label":"垃圾费21元","disable":"1","value":"1234567892","amount":"21.00","detail":[{"label":"订单编号","value":"00003"},{"label":"收费名称","value":"垃圾费"},{"label":"账期","value":"3月"},{"label":"收费金额","value":"21.00元"}]}]}],"action": "prepay","code": "I1_4520_0001"}";


//账单查询查询到的  multibill类型账单支付展示页面（包含详情的可多选账单）

//String billDetailInfo="{"title": "账单缴费 - 青岛联通GSM","form": [{"type": "multibill","label": "账单条目","name": "mbill_no","options": [{"label": "物业费6.00元","value": "1","amount": "6.00","detail": [{"label": "订单编号","value": "00001"},{"label": "收费名称","value": "物业费"},{"label": "账期","value": "3月"},{"label": "收费金额","value": "6.00元"}]},{"label": "取暖费600元","value": "2","amount": "600","detail": [{"label": "订单编号","value": "00002"},{"label": "收费名称","value": "取暖费"},{"label": "账期","value": "3月"},{"label": "收费金额","value": "600元"}]},{"label": "垃圾费21元","value": "3","amount": "21.00","detail": [{"label": "订单编号","value": "00003"},{"label": "收费名称","value": "垃圾费"},{"label": "账期","value": "3月"},{"label": "收费金额","value": "21.00元"}]}]}],"action": "prepay","code": "I1_4520_0001"}";


//账单查询查询到的  multibillstring类型账单支付展示页面（包含详情的多账单明细展示项）

//String billDetailInfo ="{"title": "账单缴费 - 青岛联通GSM","form": [{"type": "multibillstring","label": "账单条目","options": [{"label": "物业费6.00元","amount": "6.00","detail": [{"label": "订单编号","value": "00001"},{"label": "收费名称","value": "物业费"},{"label": "账期","value": "3月"},{"label": "收费金额","value": "6.00元"}]},{"label": "取暖费600元","amount": "600","detail": [{"label": "订单编号","value": "00002"},{"label": "收费名称","value": "取暖费"},{"label": "账期","value": "3月"},{"label": "收费金额","value": "600元"}]},{"label": "垃圾费21元","amount": "21.00","detail": [{"label": "订单编号","value": "00003"},{"label": "收费名称","value": "垃圾费"},{"label": "账期","value": "3月"},{"label": "收费金额","value": "21.00元"}]}]}],"action": "prepay","code": "I1_4520_0001"}";


// 带button的

//String billDetailInfo ="{"code":"I1_8700_0821","action":"none","title":"账单缴费 - 宁夏有线电视","form":[{"value":"张三","label":"客户姓名","type":"string"},{"value":"XX路XX号","label":"用户地址","type":"string"},{"value":"正常","label":"用户状态","type":"string"},{"value":"0.00","label":"本期余额(元)","type":"string"},{"name":"businessType","value":"2","action":"prequery","label":"确认","type":"button"},{"name":"businessType","value":"3","action":"prepay","label":"随便点点","type":"button"}]}";


String respJson = "{"queryId":""+queryId+"","billDetailInfo":"+billDetailInfo+"}";

System.out.println("respJson:"+respJson);

resp.getWriter().write(respJson);

return;

}else{

//其他应答码为失败请排查原因或做失败处理

//TODO

}

}else{

LogUtil.writeErrorLog("验证签名失败");

//TODO 检查验证签名失败的原因

}

}else{

//未返回正确的http状态

LogUtil.writeErrorLog("未获取到返回报文或返回http状态码非200");

}

String reqMessage = DemoBase.genHtmlResult(reqData);

String rspMessage = DemoBase.genHtmlResult(rspData);

resp.getWriter().write("请求报文:<br/>"+reqMessage+"<br/>" + "应答报文:</br>"+rspMessage+"");

}

    相关文章

      网友评论

          本文标题：银联便民缴费

          本文链接：https://www.haomeiwen.com/subject/jrbqmhtx.html

          延伸阅读

          深度阅读

          • 您也可以注册成为美文阅读网的作者，发表您的原创作品、分享您的心情！

          栏目导航

          热点阅读

          关于我们|服务条款|联系我们|银联便民缴费|投稿指南|网站地图|RSS订阅|排版工具|手机版

          提供经典美文摘抄,优美散文欣赏,现代诗歌精选,短篇小说,心情随笔,表白情书范文,故事会在线阅读欣赏

          Copyright © 2014-2023 Haomeiwen.com All Rights Reserved. 好美文阅读网 版权所有

          备案信息：桂公网安备 45052102000051号 · 桂ICP备13007215号-3

          本站所收录作品、热点评论等信息部分来源互联网，目的只是为了系统归纳学习和传递资讯

          所有作品版权归原创作者所有，与本站立场无关，如不慎侵犯了你的权益，请联系我们告知，我们将做删除处理！