跳至主要内容

建行支付对接（H5）

1. 前期准备

  1. 获取建行龙支付接入指南（接入前建行会发送相关资料）

如上PDF文档中介绍了PC网关支付、移动网关支付、二维码支付、无感支付、微信小程序/公众号支付、刷脸支付等6种支付方式，本文以移动网关支付（H5）进行开发对接。

  1. 获取对接资料

商户代码(merchantId)、商户登录密码(quPwd)、商户柜台代码(postId)、分行代码(branchId)、交易码(txCode)、公钥(pub)。

注：公钥需要登录商户后台（中国建设银行 商户服务平台）获取，登录进去点击服务管理-商户公钥下载，如下图：

  1. 开通权限

需要联系分管贵公司的建行工作人员，开通服务器实时反馈、IP白名单权限。

  1. 流程图

2. 开始对接

2.1. 配置

  1. 将netpay.jar引用至开发工程中，CCBSign.RSASig是签名包的封装类,验签时使用此类即可。
  1. <dependency>
  2.     <groupId>com.ccbsign.rsasig</groupId>
  3.     <artifactId>netpay</artifactId>
  4.     <version>1.0</version>
  5. </dependency>
  1. 配置yml文件
  1. thirdparty:
  2.   #建行支付配置     
  3.   ccb:
  4.     payUrl: 建行支付地址
  5.     merchantId: 商户代码
  6.     branchId: 分行代码
  7.     postId: 商户柜台代码
  8.     curCode: 币种
  9.     txCode: 交易码
  10.     type: 接口类型
  11.     pubKey: 公钥后30位
  12.     geteWay: 网关类型
  13.     payMap: 支付方式位图
  14.     quPwd: 商户登录密码

2.2. 支付

  1. 参考建行给的支付文档，如下：
  1. 定义支付参数对象，代码如下：
  1. @Data
  2. @ApiModel(value="CCBPayDTO", description="CCBPayDTO对象")
  3. public class CCBPayDTO {
  4.  
  5.     @ApiModelProperty(value = "open_id")
  6.     private String openId;
  7.  
  8.     @ApiModelProperty(value = "案件id")
  9.     private Long evtId;
  10.  
  11.  
  12.     @ApiModelProperty(value = "商户代码")
  13.     private String merchantId;
  14.  
  15.     @ApiModelProperty(value = "商户柜台代码")
  16.     private String postId;
  17.  
  18.     @ApiModelProperty(value = "分行代码")
  19.     private String branchId;
  20.  
  21.     @ApiModelProperty(value = "订单号")
  22.     private String orderId;
  23.  
  24.     @ApiModelProperty(value = "付款金额")
  25.     private String payment;
  26.  
  27.     @ApiModelProperty(value = "币种")
  28.     private String curCode;
  29.  
  30.     @ApiModelProperty(value = "备注信息1")
  31.     private String remark1;
  32.  
  33.     @ApiModelProperty(value = "备注信息2")
  34.     private String remark2;
  35.  
  36.     @ApiModelProperty(value = "交易码")
  37.     private String txCode;
  38.  
  39.     @ApiModelProperty(value = "MAC 校验域")
  40.     private String mac;
  41.  
  42.     @ApiModelProperty(value = "接口类型")
  43.     private String type;
  44.  
  45.     @ApiModelProperty(value = "公钥后30位")
  46.     private String pub;
  47.  
  48.     @ApiModelProperty(value = "网关类型")
  49.     private String geteway;
  50.  
  51.     @ApiModelProperty(value = "客户端 IP")
  52.     private String clientip;
  53.  
  54.     @ApiModelProperty(value = "客户注册信息")
  55.     private String reginfo;
  56.  
  57.     @ApiModelProperty(value = "商品信息")
  58.     private String proinfo;
  59.  
  60.     @ApiModelProperty(value = "商户 URL")
  61.     private String eferer;
  62.  
  63.     @ApiModelProperty(value = "订单超时时间")
  64.     private String timeout;
  65.  
  66. }
  1. 生成订单并获取建行支付链接，代码如下：
  • 根据支付参数获取建行支付链接
  1. public String pay(CCBPayDTO ccbPayDTO) {
  2.         if (UnionUtils.isEmpty(ccbPayDTO.getPayment())) {
  3.             throw new ServiceException("付款金额不能为空!");
  4.         }
  5.         String absHref = "";
  6.         ccbPayDTO.setMerchantId(merchantId);
  7.         ccbPayDTO.setBranchId(branchId);
  8.         ccbPayDTO.setPostId(postId);
  9.         ccbPayDTO.setOrderId(OrderUtil.randomOrderCode());
  10.         ccbPayDTO.setCurCode(curCode);
  11.         ccbPayDTO.setTxCode(txCode);
  12.         ccbPayDTO.setType(type);
  13.  
  14.         String pub = pubKey;
  15.         String pubSub = pub.substring(pub.length() - 30); //商户公钥后30位
  16.         ccbPayDTO.setPub(pubSub);
  17.         ccbPayDTO.setGeteway(geteWay);
  18.         if (UnionUtils.isEmpty(ccbPayDTO.getPayment())) {
  19.             ccbPayDTO.setPayment("0.01");
  20.         }
  21.         StringBuffer str = new StringBuffer();
  22.         str.append("MERCHANTID=");
  23.         str.append(ccbPayDTO.getMerchantId());
  24.         str.append("&POSID=");
  25.         str.append(ccbPayDTO.getPostId());
  26.         str.append("&BRANCHID=");
  27.         str.append(ccbPayDTO.getBranchId());
  28.         str.append("&ORDERID=");
  29.         str.append(ccbPayDTO.getOrderId());
  30.         str.append("&PAYMENT=");
  31.         str.append(ccbPayDTO.getPayment());
  32.         str.append("&CURCODE=");
  33.         str.append(ccbPayDTO.getCurCode());
  34.         str.append("&TXCODE=");
  35.         str.append(ccbPayDTO.getTxCode());
  36.  
  37.         str.append("&REMARK1=");
  38.         str.append("&REMARK2=");
  39.         str.append("&TYPE=");
  40.         str.append(ccbPayDTO.getType());
  41.         str.append("&PUB=");
  42.         str.append(ccbPayDTO.getPub());
  43.         str.append("&GATEWAY=");
  44.         str.append(ccbPayDTO.getGeteway());
  45.         str.append("&CLIENTIP=");
  46.         str.append("&REGINFO=");
  47.         str.append("&PROINFO=");
  48.         str.append("&REFERER=");
  49.  
  50.         Map map = new HashMap();
  51.         map.put("MERCHANTID", ccbPayDTO.getMerchantId());
  52.         map.put("POSID", ccbPayDTO.getPostId());
  53.         map.put("BRANCHID", ccbPayDTO.getBranchId());
  54.         map.put("ORDERID", ccbPayDTO.getOrderId());
  55.         map.put("PAYMENT", ccbPayDTO.getPayment());
  56.         map.put("CURCODE", ccbPayDTO.getCurCode());
  57.         map.put("TXCODE", ccbPayDTO.getTxCode());
  58.         map.put("REMARK1", "");
  59.         map.put("REMARK2", "");
  60.         map.put("TYPE", ccbPayDTO.getType());
  61.         map.put("GATEWAY", ccbPayDTO.getGeteway());
  62.         map.put("CLIENTIP", "");
  63.         map.put("REGINFO", "");
  64.         map.put("PROINFO", "");
  65.         map.put("REFERER", "");
  66.         map.put("MAC", Md5Util.md5Str(str.toString())); 
  67.         map.put("PAYMAP", payMap);
  68.         
  69.         String result = "";
  70.         try {
  71.             result = HttpUtil.post(payUrl, map);
  72.         } catch (Exception e) {
  73.             throw new ServiceException("建行接口连接超时，请稍后重试");
  74.         }
  75.         if (ObjectUtil.isNull(result)) {
  76.             return null;
  77.         }
  78.  
  79.         System.out.println("result:" + result);
  80.         //解析XML 得到支付链接
  81.         if (UnionUtils.isNotEmpty(result)) {
  82.             Document doc = Jsoup.parse(result);
  83.             Elements links = doc.select("form[action]");
  84.             absHref = links.attr("abs:action");
  85.             System.out.println("action: " + absHref);
  86.         }
  87.         return absHref;
  88. }
  • 订单号工具类
  1. public class OrderUtil {
  2.     public static String randomOrderCode() {
  3.         SimpleDateFormat dmDate = new SimpleDateFormat("yyyyMMddHHmmss");
  4.         String randata = getRandom(6);
  5.         Date date = new Date();
  6.         String dateran = dmDate.format(date);
  7.         String Xsode = dateran + randata;
  8.         if (Xsode.length() < 24) {
  9.             Xsode = Xsode + 0;
  10.         }
  11.         return Xsode;
  12.     }
  13.  
  14.     public static String getRandom(int len) {
  15.         Random r = new Random();
  16.         StringBuilder rs = new StringBuilder();
  17.         for (int i = 0; i < len; i++) {
  18.             rs.append(r.nextInt(10));
  19.         }
  20.         return rs.toString();
  21.     }
  22. }
  • MD5工具类（用于生成mac校验域）
  1. public class Md5Util {
  2.  
  3.     public static String md5Str(String str) {
  4.         if (str == null) return "";
  5.         return md5Str(str, 0);
  6.     }
  7.  
  8.     public static String md5Str(String str, int offset) {
  9.         try {
  10.             MessageDigest md5 = MessageDigest.getInstance("MD5");
  11.             byte[] b = str.getBytes("UTF8");
  12.             md5.update(b, offset, b.length);
  13.             return byteArrayToHexString(md5.digest());
  14.         } catch (NoSuchAlgorithmException ex) {
  15.             ex.printStackTrace();
  16.             return null;
  17.         } catch (UnsupportedEncodingException ex) {
  18.             ex.printStackTrace();
  19.             return null;
  20.         }
  21.     }
  22.  
  23.     public static String byteArrayToHexString(byte[] b) {
  24.         String result = "";
  25.         for (int i = 0; i < b.length; i++) {
  26.             result += byteToHexString(b[i]);
  27.         }
  28.         return result;
  29.     }
  30. }

2.3. 通知

  1. 参考建行给的支付通知文档，如下：
  1. 支付完成后，建行会自动调用回调地址（在建行官网商户平台配置，银行的客户经理也能配置），分为页面回调和服务器回调
  • 页面反馈（方法：get）：付款人付款完成后，点击“返回商户网站”按钮，触发页面反馈
  • 服务器反馈（方法：post）：只要支付成功，无需触发，由建行支付网关，以post 方法，发信息给反馈URL
  1.   /**
  2.      * 支付页面回调(页面反馈 get)付款人付款完成后，点击“返回商户网站”按钮，触发页面反馈
  3.      *
  4.      * @return
  5.      */
  6.     @GetMapping("/payCallBackForPage")
  7.     @ResponseBody
  8.     public String payCallBackForPage(PayCallBackDTO payCallBackDTO, HttpServletResponse response) throws Exception {
  9.         //此处可返回回调页面地址
  10.         return "SUCCESS";
  11.     }
  12.  
  13.     /**
  14.      * 支付服务器回调(服务器反馈 Post)付款人付款完成后，触发服务器反馈
  15.      *
  16.      * @return
  17.      */
  18.     @PostMapping("/payCallBackForServer")
  19.     @ResponseBody
  20.     public String payCallBackForServer(PayCallBackDTO payCallBackDTO, HttpServletResponse response) throws Exception {
  21.         System.out.println("payCallBackDTO = " + payCallBackDTO);
  22.         // 验签
  23.         rsaSig.setPublicKey(PUBLICKEY);
  24.         String src = "POSID=" + payCallBackDTO.getPOSID() + "&BRANCHID=" + payCallBackDTO.getBRANCHID() + "&ORDERID=" + payCallBackDTO.getORDERID()
  25.                 + "&PAYMENT=" + payCallBackDTO.getPAYMENT() + "&CURCODE=" + payCallBackDTO.getCURCODE() + "&REMARK1=" + payCallBackDTO.getREMARK1()
  26.                 + "&REMARK2=" + payCallBackDTO.getREMARK2() + "&ACC_TYPE=" + payCallBackDTO.getACC_TYPE() + "&SUCCESS=" + payCallBackDTO.getSUCCESS();
  27.         // 验签结果
  28.         boolean signResult = rsaSig.verifySigature(payCallBackDTO.getSIGN(), src);
  29.         if (!signResult) {
  30.             System.out.println("验签失败！");
  31.             return "SUCCESS";
  32.         }
  33.         String success = payCallBackDTO.getSUCCESS();
  34.         String orderId = payCallBackDTO.getORDERID();
  35.         String money = payCallBackDTO.getPAYMENT();
  36.         System.out.println("success: -" + success);
  37.         System.out.println("orderId: -" + orderId);
  38.         if ("Y".equals(success)) {
  39.             // 更新支付状态  记录收款日志
  40.          } else {
  41.               System.out.println("支付失败");
  42.          }
  43.         // 不论支付成功失败，给银行一个返回结果
  44.         return "SUCCESS";
  45.     }
  • 支付回调实体类
  1. @Data
  2. @ApiModel(value="CCBPayDTO", description="CCBPayDTO对象")
  3. public class PayCallBackDTO {
  4.  
  5.     @ApiModelProperty(value = "商户柜台代码")
  6.     @JsonProperty("POSTID")
  7.     private String POSTID;
  8.  
  9.     @ApiModelProperty(value = "分行代码")
  10.     @JsonProperty("BRANCHID")
  11.     private String BRANCHID;
  12.  
  13.     @ApiModelProperty(value = "订单号")
  14.     @JsonProperty("ORDERID")
  15.     private String ORDERID;
  16.  
  17.     @ApiModelProperty(value = "付款金额")
  18.     @JsonProperty("PAYMENT")
  19.     private String PAYMENT;
  20.  
  21.     @ApiModelProperty(value = "币种")
  22.     @JsonProperty("CURCODE")
  23.     private String CURCODE;
  24.  
  25.     @ApiModelProperty(value = "备注信息1")
  26.     @JsonProperty("REMARK1")
  27.     private String REMARK1;
  28.  
  29.     @ApiModelProperty(value = "备注信息2")
  30.     @JsonProperty("REMARK2")
  31.     private String REMARK2;
  32.  
  33.     @ApiModelProperty(value = "账户类型")
  34.     @JsonProperty("ACCTYPE")
  35.     private String ACCTYPE;
  36.  
  37.     @ApiModelProperty(value = "成功标志  成功－Y，失败－N")
  38.     @JsonProperty("SUCCESS")
  39.     private String SUCCESS;
  40.  
  41.     @ApiModelProperty(value = "数字签名")
  42.     @JsonProperty("SIGN")
  43.     private String SIGN;
  44. }
  1. 登录建行商户后台配置反馈地址，如下图：

2.4. 查询

  • 根据订单号获取支付详情
  1. public CCBPayStatusVO getOrderStatusById(String orderId) {
  2.     CCBPayStatusVO vo = new CCBPayStatusVO();
  3.     String ORDERDATE = "";
  4.     String BEGORDERTIME = "";
  5.     String ENDORDERTIME = "";
  6.     String TXCODE = "410408";
  7.     String SEL_TYPE = "3";
  8.     String OPERATOR = "";
  9.  
  10.     String TYPE = "0";
  11.     String KIND = "0";
  12.     String STATUS = "1";
  13.     String ORDERID = orderId;
  14.     String PAGE = "1";
  15.     String CHANNEL = "";
  16.  
  17.     String param = "MERCHANTID=" + merchantId + "&BRANCHID=" + branchId + "&POSID=" + postId + "&ORDERDATE="
  18.             + ORDERDATE + "&BEGORDERTIME=" + BEGORDERTIME + "&ENDORDERTIME=" + ENDORDERTIME + "&ORDERID="
  19.             + ORDERID + "&QUPWD=&TXCODE=" + TXCODE + "&TYPE=" + TYPE + "&KIND=" + KIND + "&STATUS=" + STATUS +
  20.             "&SEL_TYPE=" + SEL_TYPE + "&PAGE=" + PAGE + "&OPERATOR=" + OPERATOR + "&CHANNEL=" + CHANNEL;
  21.     Map map = new HashMap();
  22.     map.put("MERCHANTID", merchantId);
  23.     map.put("BRANCHID", branchId);
  24.     map.put("POSID", postId);
  25.     map.put("ORDERDATE", ORDERDATE);
  26.     map.put("BEGORDERTIME", BEGORDERTIME);
  27.     map.put("ENDORDERTIME", ENDORDERTIME);
  28.     map.put("QUPWD", quPwd);
  29.     map.put("TXCODE", TXCODE);
  30.     map.put("TYPE", TYPE);
  31.     map.put("KIND", KIND);
  32.     map.put("STATUS", STATUS);
  33.     map.put("ORDERID", ORDERID);
  34.     map.put("PAGE", PAGE);
  35.     map.put("CHANNEL", CHANNEL);
  36.     map.put("SEL_TYPE", SEL_TYPE);
  37.     map.put("OPERATOR", OPERATOR);
  38.     map.put("MAC", Md5Util.md5Str(param.toString()));
  39.     try {
  40.         String ret = HttpUtil.post(payUrl, map);
  41.         if (UnionUtils.isNotEmpty(ret)) {
  42.             Document doc = Jsoup.parse(ret);
  43.             String returnCode = doc.getElementsByTag("RETURN_CODE").first().text();
  44.             System.out.println("获取支付结果:" + ret);
  45.             if ("000000".equals(returnCode)) {
  46.                 vo.setMerchantId(doc.getElementsByTag("MERCHANTID").first().text());
  47.                 vo.setBranchId(doc.getElementsByTag("BRANCHID").first().text());
  48.                 vo.setPosId(doc.getElementsByTag("POSID").first().text());
  49.                 vo.setOrderId(doc.getElementsByTag("ORDERID").first().text());
  50.                 String timestampStr = doc.getElementsByTag("ORDERDATE").first().text();
  51.                 String year = timestampStr.substring(0, 4);
  52.                 String month = timestampStr.substring(4, 6);
  53.                 String day = timestampStr.substring(6, 8);
  54.                 String hour = timestampStr.substring(8, 10);
  55.                 String minute = timestampStr.substring(10, 12);
  56.                 String second = timestampStr.substring(12);
  57.                 vo.setOrderDate(year + "-" + month + "-" + day + " " + hour + ":" + minute + ":" + second);
  58.                 vo.setAccDate(doc.getElementsByTag("ACCDATE").first().text());
  59.                 vo.setAmount(doc.getElementsByTag("AMOUNT").first().text());
  60.                 vo.setStatusCode(doc.getElementsByTag("STATUSCODE").first().text());
  61.                 vo.setStatus(doc.getElementsByTag("STATUS").first().text());
  62.                 vo.setRefund(doc.getElementsByTag("REFUND").first().text());
  63.                 vo.setSign(doc.getElementsByTag("SIGN").first().text());
  64.             }
  65.         }
  66.     } catch (Exception e) {
  67.         e.printStackTrace();
  68.     }
  69.     return vo;
  70. }
  • 支付详情实体类
  1. @Data
  2. public class CCBPayStatusVO {
  3.     private String merchantId;
  4.     private String branchId;
  5.     private String posId;
  6.     private String orderId;
  7.     private String orderDate;
  8.     private String accDate;
  9.     private String amount;
  10.     private String statusCode;
  11.     private String status;
  12.     private String refund;
  13.     private String sign;
  14. }

3. 注意事项

  1. 生成MAC签名摘要时，需要商户的柜台公钥后30位；
  2. REMARK1和REMARK2可以传递两个备注，但长度不能超过30位，并且要求对中文需使用escape函数进行编码
  3. 在根据参数拼接MAC签名串时，要注意别把Null拼进去，就是说，要提前将Null 转成空值
  4. 回调验签坑1：文档中对于参数有返回值的意思是：包括空值，但不包括Null。再翻译一下：就算返回值是个空值，也算有返回值，但如果是Null就不算有返回值，就不参与验签；
  5. 回调验签坑2：在验签时还需要商户柜台公钥，如果还像上面那样只截取后面的30位，就会顺利入坑，因为这次是全部；
  6. 回调验签坑3：需要引入建行提供验签的jar包；

评论

发表评论

此博客中的热门博文

七星连珠的玄学秘密

图片 一生仅有一次的震撼天象，即将在2025年2月28日上演！就在今天晚上，太阳系的七大行星将在夜空中串成一条璀璨夺目的珠链，呈现出罕见的"七星连珠"奇观。而且这次可不一般，火星与木星还会在连珠时形成美轮美奂的双星拱月景象，整整持续四小时十七分，精准度更是达到了三百年以来的最高值。只要天气晴朗，我国全境都能大饱眼福！ “七星连珠”或许只能看见三颗 据上海天文台介绍，参与此次连珠的行星自西向东分别为土星、水星、海王星、金星、天王星、木星和火星，它们将出现在黄昏日落后不久。从最西端的土星到最东端的火星，张角为117°，横跨大半个天空。 然而，由于金星更靠北一些，因此这个连珠串看着不是很完美。更重要的是，其中天王星和海王星因为亮度太低了，肉眼不可见。即便完全天黑，天王星的亮度也仅仅在理论上的目力极限边缘。 而土星距离太阳只有12°，基本淹没在黄昏的天光中，直到它落下，天都没完全黑下来（完全天黑是指太阳在地平线以下18°）。 水星也好不到哪里去，它距离太阳14°，仅仅比土星晚10分钟落下，虽说比土星亮2个星等，但想凭肉眼直接找到，难度相当大。当然，不是说完全不可能，但必须满足西方地平线极为开阔、天气特别晴朗、大气透明度极佳等条件，通过拍照或可一试。 一般情况下，你能同时看见的，只有金星、木星、火星这3颗行星。 另外，不仅限于2月28日这一天，在2月20日至3月1日期间都可以。 图片 什么是“行星连珠”？ 据说有科学家计算了公元前3001年到公元3000年这6000年间的情况。 当张角在5°以下时，“六星连珠”发生49次，“七星连珠”发生3次，无“八星连珠”或“九星连珠”。如果张角扩大到10°，“六星连珠”有709次，“七星连珠”有52次，“八星连珠”有3次。想要发生“九星连珠”（冥王星曾为第九大行星），必须把张角扩大到15°，这样的话6000年间只有1次这样的“罕见天象”——将发生在2149年12月10日。 《七星连珠~意为变化之象》 罕见的天文奇观——神秘的天象即将到来。 …… 2025年2月28日晚9点左右天空会出现罕见的天文奇观——七星连珠的景象。 …… 太阳系七大行星将在夜空中形成璀璨的珠链，这是巧合还是神秘的预言？ …… 在中国古代，天象的变化被认为是和人间兴衰、朝代更迭有着密切关系。七星连珠现象往往被赋予神秘色彩，被认为是某种“天意”的显现。...
发表评论
阅读全文

信用卡使用成本更低的渠道

  很多朋友持有信用卡，如果从永续债的角度来看，那就可玩性非常大。但是输出渠道就决定了你的成本。办理渠道第一优先级是银行的M。当然需要一定的大表哥沟通与时间成本。那先用我今年找到的立刻能用的渠道吧。 （请注意，对照以下使用步骤时，您随时可以点击公众号页面右上角三个点，选择“浮窗”然后继续手机操作） 识别上方海报，注册完，下载拉生意APP，用进件手机号登陆，首次登陆需要刷脸。 首页-商户管理-新增商户。门头和店内照片、银行台均可任意上传。 提交完资料会自动审核，并不是人工干预。进入支付宝-顶端搜索“商家认证”，完成； 微信认证要稍微留意下，别用扫码，会显示已达上限。在代理端-商户管理-商户查询，找到要认证的商户，点开子商户，（也可以在拉卡拉APP-首页-支付认证-微信认证），复制出商户号，在微信商家认证里搜索。 认证路径：微信顶端搜索：商家注册。 下载“拉卡拉”APP，登录，做好实名认证；左上角三条杠，可以切换商户； 有任何问题，比如注册、改费率，识别下方二维码联系我吧。
发表评论
阅读全文