微信支付代金券开发包分享

公众号程序猿DD

共 3321字,需浏览 7分钟

 ·

2020-12-06 22:59

点击上方蓝色“程序猿DD”,选择“设为星标”

回复“资源”获取独家整理的学习资料!

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 的一些难点胖哥也做了一些介绍。其实这个东西你研究了才会发现,无论微信支付也好还是支付宝也好都是下面的流程:

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

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

/**
 * 创建代金券批次API.
 *
 * @param params the params
 * @return the wechat response entity
 */

public WechatResponseEntity createStock(StocksCreateParams params) {
    WechatResponseEntity 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 框架提供的RestTemplateJackson类库。目前对代金券封装已经结束并进行了测试,其它的 API 封装只剩下体力活了,我会尽快完善。

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

集成

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

      <dependency>
            <groupId>cn.felordgroupId>
            <artifactId>payment-spring-boot-starterartifactId>
            <version>1.0.0.RELEASEversion>
      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: xxxxxxxxx
        app-secret: xxxxxxxxxxxxxxxxxxx

然后启用@EnableWechatPay注解:

@EnableMobilePay
@Configuration
public class PayConfig {
}

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

API 使用

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

    // 支付API
    @Autowired
    WechatPayApi wechatPayV3Api;
    // 营销API
    @Autowired
    WechatMarketingApi  wchatMarketingApi;

例如查询优惠券

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

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

推荐关注本文作者

DD自研的沪牌代拍业务,点击直达


【往期推荐】

殊途同归!招聘软件与社交软件最终都要走向约P宿命?

2020-12-05

Spring-Retry重试实现原理

2020-12-05

今年最后一月数据库排名公布!前三难以撼动!

2020-12-04

8 种常见的SQL错误用法

2020-12-04

一手好牌打的稀烂,如今面临倒计时,网友哭求众筹活下去...

2020-12-03

Elasticsearch Top 51 重中之重面试题及答案

2020-12-03



深度内容

推荐加入





浏览 58
点赞
评论
收藏
分享

手机扫一扫分享

分享
举报
评论
图片
表情
推荐
点赞
评论
收藏
分享

手机扫一扫分享

分享
举报