Java微信支付V3 DEMO分享

1. 前言

距离上次发原创分享应该有 12 天了，最近忙里忙外的，无论是 Spring Security OAuth2 相关的，还是微信支付相关的都留了很多坑没有来得及去补，所以十分抱歉。今天得空赶紧分享一些有用的东西。今天就分享一下关于微信支付代金券的一些开发知识。

2. 微信支付营销

微信支付提供了商家券、代金券、立减金等营销能力来帮助商家进行拉新保活，增强与用户的互动性。从开发层面上来说比接入微信支付要难一些，而且涉及的策略也会更多一些。那么本次分享胖哥将分享自己的一些经验。

3. 开发前准备

开发前我们需要申请微信支付相关的账号，手续还是比较多的。

微信商户账号

地址为https://pay.weixin.qq.com 用来开通微信支付能力，没有商户号是无法使用微信支付的。而且后续申请的公众号 appid 和移动应用、小程序的 appid 都要同微信商户帐号进行绑定。

微信开放平台账号

地址为https://open.weixin.qq.com 用来开发第三方平台、移动应用、公众平台、网站应用的开发。后续申请的微信公众号服务号、移动应用 appid 需要绑定到开放平台中。

微信公众平台服务号

通过https://mp.weixin.qq.com申请， 切记是服务号，不是订阅号，也不是个人号！服务号才是企业开发用的。申请认证完毕后需要同微信商户帐号和微信开放平台帐号进行绑定。

具体的操作步骤去查看官方指引，总之需要准备的材料是比较多的，而且走的流程也比较多，需要专人去办理。

4. 微信支付 V3

在之前对微信支付 V3 的一些难点胖哥也做了一些介绍。其实这个东西你研究了才会发现，无论微信支付也好还是支付宝也好都是下面的流程：

收集对应 API 的参数。
对参数进行签名。
请求对应的 API
对响应的来源的验证以确保响应来自支付服务器。
对响应进行解析。
对回调请求的响应。

所以针对上面的流程，胖哥做了一个小小的模型设计，以代金券创建为例：

/*** 创建代金券批次API.** @param params the params* @return the wechat response entity*/
public WechatResponseEntity<ObjectNode> createStock(StocksCreateParams params) {WechatResponseEntity<ObjectNode> wechatResponseEntity = new WechatResponseEntity<>();// 1. 根据请求类型组织参数this.client().withType(WechatPayV3Type.MARKETING_FAVOR_STOCKS_COUPON_STOCKS, params)// 2. 对参数进行归纳处理.function(this::createStocksFunction)// 3. 嵌入对结果进行消费的逻辑.consumer(wechatResponseEntity::convert).request();return wechatResponseEntity;
}

无论微信支付 V3 的哪个 API 都可以按照上面的模型进行封装。

5. 微信支付开发包

针对上面的设计，以 Spring Boot Starter 的形式封装了一个开发包，第三方依赖几乎为零。仅仅使用了 Spring 框架提供的RestTemplate和Jackson类库。目前对代金券封装已经结束并进行了测试，其它的 API 封装只剩下体力活了，我会尽快完善。

github : https://github.com/NotFound403/payment-spring-boot.git

集成

以Spring Boot Starter的形式集成到项目中，目前并没有提交到 maven 中央仓库，需要自己编译安装。

      <dependency><groupId>cn.felord</groupId><artifactId>payment-spring-boot-starter</artifactId><version>1.0.0.RELEASE</version></dependency>

配置

在 Spring Boot 项目中的application.yaml中配置wechat.pay相关参数。

wechat:pay:v3:
#  应用appId 必填app-id: xxxxxxxx
#  api 密钥 必填app-secret: xxxxxxxxxxx
#  api v3 密钥 必填app-v3-secret: xxxxxxxx
#  微信支付商户号 必填mch-id: xxxxxxx
#  合作商 选填partner-key:
#  商户服务器域名 用于回调  需要放开回调接口的安全策略 必填domain: https://xxxx.xxx.com
#  商户 api 证书 必填cert-path: apiclient_cert.p12
#  微信服务号 优惠券必须mp:app-id: xxxxxxxxxapp-secret: xxxxxxxxxxxxxxxxxxx

然后启用@EnableWechatPay注解：

@EnableMobilePay
@Configuration
public class PayConfig {
}

请注意：只有wechat.pay.v3.app-id设置了有效值才能启用下面的 API。

API 使用

微信支付 V3 开放接口引入：

    // 支付API@AutowiredWechatPayApi wechatPayV3Api;// 营销API@AutowiredWechatMarketingApi  wchatMarketingApi;

例如查询优惠券

     // 查询商户下的优惠券@Testpublic void v3MchStocks() {StocksQueryParams params = new StocksQueryParams();params.setOffset(0);params.setLimit(10);WechatResponseEntity<ObjectNode> objectNodeWechatResponseEntity = wechatPayV3Api.queryStocksByMch(params);System.out.println("objectNodeWechatResponseEntity = " + objectNodeWechatResponseEntity);}

如果你在微信支付中有什么疑问可以给我留言，知无不答。感谢对胖哥的关注。

Java中的微信支付（3）：API V3对微信服务器响应进行签名验证

Java中的微信支付（2）：API V3 微信平台证书的获取与刷新

Java中的微信支付（1）：API V3版本签名详解