首先,你得先有微信開發平台賬號密碼還需要開通應用,然后還有微信服務商平台商戶版賬號(這些我都是給產品經理拿的)
其次我認為你先去看一看微信開發平台的文檔! https://pay.weixin.qq.com/wiki/doc/api/index.html
這里有很多種支付,我就采用APP支付來說了(會了APP支付其實H5支付都差不多的!)
進來后是這樣的,隨便看看'APP支付那幾篇文章'講的流程!,看完后知道大概了就可以看看'API列表了'
我們后台開發需要關注的就是這三個API了!
那我還是簡單介紹一下APP支付的一個業務流程吧(其實文檔里簡述的了,我就直接貼圖了!)
這些圈圈起來的流程步驟,就是我們后台要做的了,其他的都是由移動端來實現的,我們可以不理會,還有步驟6查詢訂單支付結果,這個可做可不做吧,為了系統更安全些更慎重些也可以去實現,不過我就沒有實現了
下面就說一下如何對接這個所謂的第三方接口,其實就是跟前端來調用我們后端接口是一樣的,我們在寫接口文檔時,有請求地址,請求參數,返回數據以及返回數據格式這4樣!
只要提供這4種東西,前端就可以來對接我們后台接口啦!所以,同個道理的,這次是由我們后台人員去請求微信提供的接口!
所以文檔上都有提供的了,我們只需要用httpclient來想微信接口那邊發送同步請求獲取返回結果數據即可,這樣聽起來貌似很簡單!不過還真不是很簡單,很多坑的,畢竟是騰訊的文檔!
然后要注意的首先是請求參數,請求參數是否必填這個如果是否的話我就建議不用填上去了,然后簽名參數也要去看文檔,如何生成簽名,還有,參數是要以xml格式形式發送過去,
而且返回結果也是以xml返回回來,所以和微信對接的交互就是xml,這點有點蛋疼呀!
好了,上面說了該怎么去請求第三方接口,想必大家有點懵吧,不知道該如何下手,其實上面的那個請求方式有點難度,小白可以忽略上面那套方式,直接使用微信支付的一個開源jar!
對 你沒看錯,就這一個,這個jar包里面已經封裝好了我們如何獲取簽名,如何驗簽等api方法,而且還不需要我們去將參數轉化成xml格式,它已經封裝好了一切了,所以非常方便!
這個jar包可以在這個地址去下載http://www.mvnjar.com/com.github.liyiorg/weixin-popular/2.8.14/detail.html
好了,那上面的介紹看完還有微信jar拿到手后,現在就可以開始來實現了! 我就直接亮代碼了!
1 /** 2 * @description:微信支付JAVA-SDK: APP支付,退款 3 * @author:小黑 4 */ 5 @Service 6 public class WechatPayService { 7 private static final Logger LOGGER = LoggerFactory.getLogger(WechatPayService.class); 8 9 /************ 微信開放平台配置 ***************/ 10 11 /** APPID */ 12 private static final String APPID = ""; 13 14 /** 商戶號 */ 15 private static final String MCH_ID = ""; 16 17 /** 密鑰 */ 18 private static final String PRIVATE_KEY = ""; 19 20 /** 用戶訂單支付結果異步通知url */ 21 private static final String NOTIFY_URL = ""; 22 23 /** 商戶支付證書路徑 */ 24 private static final String API_CLIENT_CERT_PATH = ""; 25 26 // 加載商戶支付證書文件; 27 static { 28 LocalHttpClient.initMchKeyStore(MCH_ID, API_CLIENT_CERT_PATH); 29 } 30 31 /** 32 * @description:使用微信支付-APP支付方式-統一下單; 33 * @return 支付參數,如果支付失敗則返回null 34 * @author:Fanhaojian 35 */ 36 public MchPayApp orderAppPay(PayLog payLog) { 37 38 Unifiedorder unifiedorder = new Unifiedorder(); 39 40 /** APPID */ 41 unifiedorder.setAppid(APPID); 42 43 /** 商戶號 */ 44 unifiedorder.setMch_id(MCH_ID); 45 46 /** 隨機字符串 */ 47 unifiedorder.setNonce_str(UUID.randomUUID().toString().replaceAll("-", "")); 48 49 /** 商品描述 */ 50 unifiedorder.setBody(payLog.getPayCode()); 51 52 /** 商戶訂單號 */ 53 unifiedorder.setOut_trade_no(payLog.getPayCode()); 54 55 /** 訂單總金額 */ 56 unifiedorder.setTotal_fee(payLog.getPayPrice().multiply(new BigDecimal(100)).intValue() + ""); // 訂單總金額,單位為分; 57 58 /** 用戶端請求IP地址 */ 59 unifiedorder.setSpbill_create_ip(IpUtils.getClientIp()); 60 61 /** 異步通知回調地址 */ 62 unifiedorder.setNotify_url(NOTIFY_URL); 63 64 /** 交易類型 */ 65 unifiedorder.setTrade_type("APP"); 66 67 LOGGER.warn("微信APP支付--(簽名前):" + XMLConverUtil.convertToXML(unifiedorder)); 68 69 /** 獲取簽名 */ 70 UnifiedorderResult unifiedorderResult = PayMchAPI.payUnifiedorder(unifiedorder, PRIVATE_KEY); 71 72 LOGGER.warn("微信APP支付--支付統一下單接口請求狀態(return_code):" + unifiedorderResult.getReturn_code()); 73 LOGGER.warn("微信APP支付--支付統一下單接口請求狀態(return_msg):" + unifiedorderResult.getReturn_msg()); 74 LOGGER.warn("微信APP支付--支付統一下單接口請求狀態(result_code):" + unifiedorderResult.getResult_code()); 75 LOGGER.warn("微信APP支付--支付請求參數封裝(簽名后):" + XMLConverUtil.convertToXML(unifiedorder)); 76 LOGGER.warn("微信APP支付--支付統一下單接口返回數據:" + FastJSONUtils.getJsonHelper().toJSONString(unifiedorderResult)); 77 78 // 下單結果驗簽; 79 if(unifiedorderResult.getSign_status() != null && unifiedorderResult.getSign_status()) { 80 LOGGER.warn("微信APP支付驗簽成功"); 81 return PayUtil.generateMchAppData(unifiedorderResult.getPrepay_id(), APPID, MCH_ID, PRIVATE_KEY); 82 } 83 return null; 84 } 85 86 /** 87 * @description:微信退款業務封裝(支付押金退還); 88 * @param PayLog order:支付訂單信息 89 * Double refundAmount:退款金額 90 * @return 微信退款接口返回數據 true 退款成功 false 退款失敗 91 * @author:FanHaoJian 92 */ 93 public Boolean refundOrder(PayLog order, Double refundAmount) { 94 95 // 調用微信支付退款接口; 96 SecapiPayRefund payRefund = new SecapiPayRefund(); 97 payRefund.setAppid(APPID); 98 payRefund.setMch_id(MCH_ID); 99 payRefund.setNonce_str(UUID.randomUUID().toString().replaceAll("-", "")); 100 payRefund.setOut_trade_no(order.getPayCode());//支付訂單號 101 payRefund.setOut_refund_no(order.getRefundCode());//退款單號 102 payRefund.setTotal_fee(order.getPayPrice().multiply(new BigDecimal(100)).intValue());//原訂單金額,單位:分; 103 payRefund.setRefund_fee(new BigDecimal(refundAmount).multiply(new BigDecimal(100)).intValue());//退款訂單金額,單位:分; 104 105 SecapiPayRefundResult refundResult = PayMchAPI.secapiPayRefund(payRefund, PRIVATE_KEY); 106 107 // 微信支付退款接口返回數據驗簽; 108 if(refundResult.getSign_status() != null && refundResult.getSign_status()) { 109 LOGGER.warn("微信退款接口--接口請求狀態(return_code):" + refundResult.getReturn_code()); 110 LOGGER.warn("微信退款接口--接口請求狀態(return_msg):" + refundResult.getReturn_msg()); 111 112 // 退款信息提交成功; 113 if("SUCCESS".equals(refundResult.getReturn_code())) { 114 LOGGER.warn("微信退款接口--接口請求狀態(result_code):" + refundResult.getResult_code()); 115 LOGGER.warn("微信退款接口--接口請求狀態(err_code):" + refundResult.getErr_code()); 116 LOGGER.warn("微信退款接口--接口請求狀態(err_code_des):" + refundResult.getErr_code_des()); 117 118 return Boolean.TRUE; 119 } 120 } 121 122 return Boolean.FALSE; 123 } 124 }
在項目建一個sdk包,然后統一放入sdk,類似這樣!
然后創建一個微信支付SDK,將上面代碼復制過去,然后看一遍代碼里的方法流程,看明白后在改改里面的代碼!
然后我簡單介紹一下上面的微信支付SDK吧,里面有兩個方法,一個是統一下單,一個是退款!
統一下單返回的數據就是要拿給移動端的簽名數據,退款返回的數據就是true和false,沒什么判斷成功還是失敗就行了,成功該做什么,失敗該做什么!
OK! 現在說完了統一下單和退款后,還有一個支付通知結果的API,也就是異步通知了!如果你看完了那篇流程圖,你就會知道,當移動端調起支付並且支付成功后,微信后台那邊會向我們這邊后台發送一個請求過來!
當然微信那邊發送請求過來我們這邊的接口,我也直接亮代碼了!
1 /** 2 * @description:微信支付異步通知請求URL 3 * @author:小黑 4 */ 5 public class WechatOrderNotify extends ActionSupport { 6 private static final Logger LOGGER = LoggerFactory.getLogger(WechatOrderNotify.class); 7 private static final long serialVersionUID = 1L; 8 9 /** 密鑰 */ 10 private static final String PRIVATE_KEY = ""; 11 12 /** 定義應答變量 */ 13 private String xml; 14 15 @Override 16 public String wechatOrderNotify() throws Exception { 17 18 // 解析微信支付異步通知請求參數; 19 HttpServletRequest request = ServletActionContext.getRequest(); 20 String xml = StreamUtils.copyToString(request.getInputStream(), Charset.forName("utf-8")); 21 Map<String, String> params = XMLConverUtil.convertToMap(xml); 22 MchPayNotify payNotify = XMLConverUtil.convertToObject(MchPayNotify.class, xml); 23 24 /** 打印日志信息 */ 25 LOGGER.warn("$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$---進入微信支付異步通知請求接口---$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$"); 26 LOGGER.warn("微信支付用戶訂單支付結果異步通知請求參數(xml):" + params); 27 LOGGER.warn("微信支付用戶訂單支付結果異步通知請求參數(map):" + params); 28 LOGGER.warn("return_code:" + payNotify.getReturn_code()); 29 LOGGER.warn("return_msg:" + params.get("return_msg")); 30 31 /** 校驗支付成功還是失敗 */ 32 if("SUCCESS".equals(payNotify.getReturn_code())) { 33 34 /** 獲取微信后台返回來的異步通知參數 */ 35 String outTradeNo = payNotify.getOut_trade_no(); // 用戶訂單號; 36 String tradeNo = payNotify.getTransaction_id(); // 微信交易號; 37 String tradeStatus = payNotify.getResult_code(); // 微信支付狀態; 38 Integer totalFee = payNotify.getTotal_fee(); // 支付金額 39 40 /** 獲取驗簽結果 true說明驗簽成功 false說明驗簽失敗 */ 41 boolean flag = SignatureUtil.validateSign(params, PRIVATE_KEY); 42 43 /** 打印日志信息 */ 44 LOGGER.warn("微信支付--APP支付方式支付用戶訂單異步通知訂單號(out_trade_no):" + outTradeNo); 45 LOGGER.warn("微信支付--APP支付方式支付用戶訂單異步通知交易號(trade_no):" + tradeNo); 46 LOGGER.warn("微信支付--APP支付方式支付用戶訂單異步通知交易狀態(result_code):" + tradeStatus); 47 LOGGER.warn("微信支付--APP支付方式支付用戶訂單異步通知支付金額(total_fee):" + totalFee); 48 LOGGER.warn("微信支付--APP支付方式支付用戶訂單異步通知驗簽狀態:" + flag); 49 50 /** 根據訂單號獲取訂單支付信息: 支付狀態為 '未支付' */ 51 ...此處省略 根據訂單號去查訂單 我用hibernate的 你們可能用mybatis或者其他,所以自己去查吧! 52 53 /** 支付成功/處理訂單業務信息 */ 54 if(flag && "SUCCESS".equals(tradeStatus) && order != null) { 55 56 /** 更新訂單支付信息: */ 57 ...此處省略 根據自己項目的業務去處理邏輯! 58 59 /** 封裝通知信息 */ 60 MchBaseResult baseResult = new MchBaseResult(); 61 baseResult.setReturn_code("SUCCESS"); 62 baseResult.setReturn_msg("OK"); 63 xml = XMLConverUtil.convertToXML(baseResult); 64 65 /** 支付成功 */ 66 }else if(flag && "SUCCESS".equals(tradeStatus)){ 67 MchBaseResult baseResult = new MchBaseResult(); 68 baseResult.setReturn_code("SUCCESS"); 69 baseResult.setReturn_msg("OK"); 70 xml = XMLConverUtil.convertToXML(baseResult); 71 72 /** 支付失敗 */ 73 }else { 74 MchBaseResult baseResult = new MchBaseResult(); 75 baseResult.setReturn_code("FAIL"); 76 baseResult.setReturn_msg("FAIL"); 77 xml = XMLConverUtil.convertToXML(baseResult); 78 } 79 80 /** 支付失敗 */ 81 }else { 82 MchBaseResult baseResult = new MchBaseResult(); 83 baseResult.setReturn_code("FAIL"); 84 baseResult.setReturn_msg("FAIL"); 85 xml = XMLConverUtil.convertToXML(baseResult); 86 } 87 LOGGER.warn("微信支付--APP支付方式支付用戶訂單異步通知返回數據:" + xml); 88 return Results.XML; 89 } 90 91 public String getXml() { 92 return xml; 93 } 94 95 public void setXml(String xml) { 96 this.xml = xml; 97 } 98 }
這里也是直接招搬過去,然后改改代碼即可!需要注意的就是這個返回數據xml,你可能要自己定義一下,應答是要這種格式的:
