美文网首页
银联便民缴费

银联便民缴费

作者: 小花生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+"");

}

相关文章

  • 银联便民缴费

    一、银联便民缴费产品介绍 银联便民缴费产品向用户提供水电煤等缴费业务的账单费用查询及缴费服务。目前覆盖电费、水费、...

  • 公司产品及服务介绍

    ■ pos机 ■ 微信、支付宝扫码支付 ■ 银联银联云闪付 ■ 微信缴费平台 ■ 电商平台 ■ 会员积分系统 ■ ...

  • 银联多渠道平台对接，部分芯片卡不能交易

    最近对接银联多渠道，对接了“余额查询”和“缴费”功能。最近发生部分芯片卡不能交易的bug（磁条卡可以交易）。 ...

  • 银联商务扫码支付-被扫业务

    最近在业务系统中集成了银联商务扫码支付-被扫业务产品，最开始还错以为是银联，殊不知此银联非彼银联，银联商务跟银联好...

  • Apple pay 苹果支付

    1、银联认证，到银联下载证书 1.登录银联云闪付 查看《银联云闪付之 ApplePay 商户入网测试流程》http...

  • 便民也是一种服务……

    水城蒙银村镇银行在各网点配置便民服务箱

  • 银联

    有没有可能，共享信用体系 同时知道各个信用卡额度，信贷规模，信用消费水平

  • 【转载】银联的 CUPSecure 是什么？

    银联的CUPSecure指的是“银联安全支付服务”，是中国银联2005年推出的电子商务安全认证体系，最初推出的实际...

  • 银联手机控件支付+后台接口部署+支付流程说明

    说明 由于没有正式的银联商户号，只能用测试的银联商户号进行测试；正式的银联商户号需要提交资料给银联审核，并需要支付...

  • 《互联网金融支付》下

    关键词：第三方支付、银联、网关支付、收单、网银。 一、银联 在中国，银联是具有特殊地位的国有金融企业，目前中国境内...

网友评论

      本文标题：银联便民缴费

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

      延伸阅读

      深度阅读

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

      栏目导航

      热点阅读

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

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

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

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

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

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