代码DEMO websocket mq redis pdf

[](https://www.javadoc.io/doc/com.github.wechatpay-apiv3/wechatpay-java/latest/index.html)  [](https://sonarcloud.io/summary/overall?id=wechatpay-apiv3_wechatpay-java) [](https://sonarcloud.io/summary/overall?id=wechatpay-apiv3_wechatpay-java) [](https://sonarcloud.io/summary/overall?id=wechatpay-apiv3_wechatpay-java) # 微信支付 APIv3 Java SDK [微信支付 APIv3](https://pay.weixin.qq.com/docs/merchant/development/interface-rules/introduction.html) 官方 Java 语言客户端开发库。 开发库由 `core` 和 `service` 组成： - core 为基础库，包含自动签名和验签的 HTTP 客户端、回调处理、加解密库。 - service 为业务服务，包含[业务接口](service/src/main/java/com/wechat/pay/java/service)和[使用示例](service/src/example/java/com/wechat/pay/java/service)。 ## 帮助微信支付改进 为了向广大开发者提供更好的使用体验，微信支付诚挚邀请您反馈使用微信支付 Java SDK 中的感受。您的反馈将对改进 SDK 大有帮助，点击参与[问卷调查](https://wj.qq.com/s2/11503706/aa9a/)。 ## 前置条件 - Java 1.8+。 - [成为微信支付商户](https://pay.weixin.qq.com/index.php/apply/applyment_home/guide_normal)。 - [商户 API 证书](https://pay.weixin.qq.com/docs/merchant/development/interface-rules/privatekey-and-certificate.html#%E5%95%86%E6%88%B7api%E8%AF%81%E4%B9%A6)：指由商户申请的，包含[证书序列号](https://pay.weixin.qq.com/docs/merchant/development/interface-rules/certificate-faqs.html#%E5%A6%82%E4%BD%95%E6%9F%A5%E7%9C%8B%E8%AF%81%E4%B9%A6%E5%BA%8F%E5%88%97%E5%8F%B7)、商户的商户号、公司名称、公钥信息的证书。 - [商户 API 私钥](https://pay.weixin.qq.com/docs/merchant/development/interface-rules/privatekey-and-certificate.html#%E5%95%86%E6%88%B7api%E7%A7%81%E9%92%A5)：商户申请商户API证书时，会生成商户私钥，并保存在本地证书文件夹的文件 apiclient_key.pem 中。 - [APIv3 密钥](https://pay.weixin.qq.com/docs/merchant/development/interface-rules/apiv3key.html)：为了保证安全性，微信支付在回调通知和平台证书下载接口中，对关键信息进行了 AES-256-GCM 加密。APIv3 密钥是加密时使用的对称密钥。 ## 快速开始 ### 安装 最新版本已经在 [Maven Central](https://search.maven.org/artifact/com.github.wechatpay-apiv3/wechatpay-java) 发布。 #### Gradle 在你的 build.gradle 文件中加入如下的依赖 ```groovy implementation 'com.github.wechatpay-apiv3:wechatpay-java:0.2.12' ``` #### Maven 加入以下依赖 ```xml <dependency> <groupId>com.github.wechatpay-apiv3</groupId> <artifactId>wechatpay-java</artifactId> <version>0.2.12</version> </dependency> ``` ### 调用业务请求接口 以 Native 支付下单为例，先补充商户号等必要参数以构建 `config`，再构建 `service` 即可调用 `prepay()` 发送请求。 ```java package com.wechat.pay.java.service; import com.wechat.pay.java.core.Config; import com.wechat.pay.java.core.RSAAutoCertificateConfig; import com.wechat.pay.java.service.payments.nativepay.NativePayService; import com.wechat.pay.java.service.payments.nativepay.model.Amount; import com.wechat.pay.java.service.payments.nativepay.model.PrepayRequest; import com.wechat.pay.java.service.payments.nativepay.model.PrepayResponse; /** Native 支付下单为例 */ public class QuickStart { /** 商户号 */ public static String merchantId = "190000****"; /** 商户API私钥路径 */ public static String privateKeyPath = "/Users/yourname/your/path/apiclient_key.pem"; /** 商户证书序列号 */ public static String merchantSerialNumber = "5157F09EFDC096DE15EBE81A47057A72********"; /** 商户APIV3密钥 */ public static String apiV3Key = "..."; public static void main(String[] args) { // 使用自动更新平台证书的RSA配置 // 一个商户号只能初始化一个配置，否则会因为重复的下载任务报错 Config config = new RSAAutoCertificateConfig.Builder() .merchantId(merchantId) .privateKeyFromPath(privateKeyPath) .merchantSerialNumber(merchantSerialNumber) .apiV3Key(apiV3Key) .build(); // 构建service NativePayService service = new NativePayService.Builder().config(config).build(); // request.setXxx(val)设置所需参数，具体参数可见Request定义 PrepayRequest request = new PrepayRequest(); Amount amount = new Amount(); amount.setTotal(100); request.setAmount(amount); request.setAppid("wxa9d9651ae******"); request.setMchid("190000****"); request.setDescription("测试商品标题"); request.setNotifyUrl("https://notify_url"); request.setOutTradeNo("out_trade_no_001"); // 调用下单方法，得到应答 PrepayResponse response = service.prepay(request); // 使用微信扫描 code_url 对应的二维码，即可体验Native支付 System.out.println(response.getCodeUrl()); } } ``` 从示例可见，使用 SDK 不需要计算请求签名和验证应答签名。详细代码可从 [QuickStart](service/src/example/java/com/wechat/pay/java/service/QuickStart.java) 获得。 ## 示例 ### 查询支付订单 ```java QueryOrderByIdRequest queryRequest = new QueryOrderByIdRequest(); queryRequest.setMchid("190000****"); queryRequest.setTransactionId("4200001569202208304701234567"); try { Transaction result = service.queryOrderById(queryRequest); System.out.println(result.getTradeState()); } catch (ServiceException e) { // API返回失败, 例如ORDER_NOT_EXISTS System.out.printf("code=[%s], message=[%s]\n", e.getErrorCode(), e.getErrorMessage()); System.out.printf("reponse body=[%s]\n", e.getResponseBody()); } ``` ### 关闭订单 ```java CloseOrderRequest closeRequest = new CloseOrderRequest(); closeRequest.setMchid("190000****"); closeRequest.setOutTradeNo("out_trade_no_001"); // 方法没有返回值，意味着成功时API返回204 No Content service.closeOrder(closeRequest); ``` ### 下单并生成调起支付的参数 JSAPI 支付和 APP 支付推荐使用服务拓展类 [JsapiServiceExtension](https://github.com/wechatpay-apiv3/wechatpay-java/blob/main/service/src/main/java/com/wechat/pay/java/service/payments/jsapi/JsapiServiceExtension.java) 和 [AppServiceExtension](https://github.com/wechatpay-apiv3/wechatpay-java/blob/main/service/src/main/java/com/wechat/pay/java/service/payments/app/AppServiceExtension.java)，两者包含了下单并返回调起支付参数方法。 ```java JsapiServiceExtension service = new JsapiServiceExtension.Builder().config(config).build(); // 跟之前下单示例一样，填充预下单参数 PrepayRequest request = new PrepayRequest(); // response包含了调起支付所需的所有参数，可直接用于前端调起支付 PrepayWithRequestPaymentResponse response = service.prepayWithRequestPayment(request); ``` ### 上传图片 ```java import com.wechat.pay.java.service.file.FileUploadService; import com.wechat.pay.java.service.file.model.FileUploadResponse; FileUploa