在本教程中,你將簡要了解微信支付的 Java SDK。在學(xué)習(xí)過程中,你將
- 掌握如何安裝 Java SDK
- 了解請求微信支付需要哪些密鑰和證書
- 了解如何使用 Java SDK 請求微信支付
# 環(huán)境要求
- Java 1.8+
# 安裝
使用包管理系統(tǒng),例如 Maven、Gradle,快速添加微信支付官方 SDK。
如果你使用的 Gradle (opens new window),請在 build.gradle
中加入:
1implementation 'com.github.wechatpay-apiv3:wechatpay-java:${VERSION}'
如果你使用的 Maven (opens new window),請在 pom.xml
中加入:
1<dependency>2 <groupId>com.github.wechatpay-apiv3</groupId>3 <artifactId>wechatpay-java</artifactId>4 <version>${VERSION}</version>5</dependency>
你可以在 GitHub 找到 Java SDK (opens new window) 的源代碼、使用說明和最新版本信息。
# 必需的證書和密鑰
運行 SDK 必需以下的商戶身份信息,用于構(gòu)造請求的簽名和驗證應(yīng)答的簽名:
# 發(fā)起請求
以 Native 支付為例,向微信支付發(fā)起你的第一個請求:
1package com.wechat.pay.java.service;23import com.wechat.pay.java.core.Config;4import com.wechat.pay.java.core.RSAAutoCertificateConfig;5import com.wechat.pay.java.service.payments.nativepay.NativePayService;6import com.wechat.pay.java.service.payments.nativepay.model.Amount;7import com.wechat.pay.java.service.payments.nativepay.model.PrepayRequest;8import com.wechat.pay.java.service.payments.nativepay.model.PrepayResponse;910/** Native 支付下單為例 */11public class QuickStart {1213 /** 商戶號 */14 public static String merchantId = "190000****";15 /** 商戶API私鑰路徑 */16 public static String privateKeyPath = "/Users/yourname/your/path/apiclient_key.pem";17 /** 商戶證書序列號 */18 public static String merchantSerialNumber = "5157F09EFDC096DE15EBE81A47057A72********";19 /** 商戶APIV3密鑰 */20 public static String apiV3key = "...";2122 public static void main(String[] args) {23 // 使用自動更新平臺證書的RSA配置24 // 建議將 config 作為單例或全局靜態(tài)對象,避免重復(fù)的下載浪費系統(tǒng)資源25 Config config =26 new RSAAutoCertificateConfig.Builder()27 .merchantId(merchantId)28 .privateKeyFromPath(privateKeyPath)29 .merchantSerialNumber(merchantSerialNumber)30 .apiV3Key(apiV3key)31 .build();32 // 構(gòu)建service33 NativePayService service = new NativePayService.Builder().config(config).build();34 // request.setXxx(val)設(shè)置所需參數(shù),具體參數(shù)可見Request定義35 PrepayRequest request = new PrepayRequest();36 Amount amount = new Amount();37 amount.setTotal(100);38 request.setAmount(amount);39 request.setAppid("wxa9d9651ae******");40 request.setMchid("190000****");41 request.setDescription("測試商品標(biāo)題");42 request.setNotifyUrl("https://notify_url");43 request.setOutTradeNo("out_trade_no_001");44 // 調(diào)用下單方法,得到應(yīng)答45 PrepayResponse response = service.prepay(request);46 // 使用微信掃描 code_url 對應(yīng)的二維碼,即可體驗Native支付47 System.out.println(response.getCodeUrl());48 }49}
# 聯(lián)系 SDK 團隊獲取幫助
- 在開發(fā)者社區(qū) (opens new window)提交問題
- 在 GitHub 上提交 issue (opens new window)
- 聯(lián)系我們的在線技術(shù)支持 (opens new window)
# 接下來閱讀
通過這個快速介紹,你已經(jīng)安裝了 Java SDK 并學(xué)習(xí)了一些基礎(chǔ)知識。接下來,你可以:
- 閱讀 SDK 配置詳解 (opens new window),詳細(xì)了解如何配置商戶信息和超時等網(wǎng)絡(luò)設(shè)置。
- 閱讀具體的產(chǎn)品文檔,學(xué)習(xí)如何接入微信支付。