现在位置: 首页 / 随手记 / 正文

建行支付对接（H5）

  • Zachary Hao
  • 随手记
  • 9天前
  • 18热度
  • 0评论

1. 前期准备

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

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

  1. 获取对接资料

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

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

建行支付对接（H5）

建行支付对接（H5）

  1. 开通权限

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

  1. 流程图

建行支付对接（H5）

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. }
建行支付对接（H5）
  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. }
建行支付对接（H5）
  • 订单号工具类
  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. }
建行支付对接（H5）
  • 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. }
建行支付对接（H5）

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.     }
建行支付对接（H5）
  • 支付回调实体类
  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. }
建行支付对接（H5）
  1. 登录建行商户后台配置反馈地址，如下图：

    建行支付对接（H5）

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. }
建行支付对接（H5）
  • 支付详情实体类
  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包；
国内站：https://yulcell.com/aa 欢迎移步访问