## Maven 中央仓库坐标

```xml
<dependency>
    <groupId>cn.felord</groupId>
    <artifactId>payment-spring-boot-starter</artifactId>
    <version>1.0.21.RELEASE</version>
</dependency>
```
> 基于 **Spring Boot 2.x** 

## Spring Boot 版本适配

需要自行克隆项目，修改根目录下的`pom.xml`以下配置项：
```xml
    <properties>
        <!--  修改为你对应的Spring Boot版本号 -->
        <spring-boot.version>2.7.18</spring-boot.version>
    </properties>
```
然后安装使用

## 自行安装

以**Spring Boot Starter**的形式集成到项目中。从[GitHub项目地址](https://github.com/NotFound403/payment-spring-boot)拉取`release`分支到本地后使用以下两种方式之一进行环境集成：

- `mvn install` 安装到本地
- `mvn deploy`部署到**Maven**仓库



然后引用**Maven**坐标，请注意`${payment-spring-boot-starter.version}`要同你安装的一致。

```xml
      <dependency>
            <groupId>cn.felord</groupId>
            <artifactId>payment-spring-boot-starter</artifactId>
            <version>${payment-spring-boot-starter.version}</version>
      </dependency>
```
## 配置

### 微信支付
在Spring Boot项目中的`application.yaml`中配置`wechat.pay.v3`相关参数。
```yaml
wechat:
  pay:
    v3:
#    租户id  
     <tentantID>: 
#  应用appId  服务商模式下为服务商的appid 必填  
      app-id: xxxxxxxx
#  v2 api 密钥  1.0.5版本以后如果用到V2的接口时必填
      app-secret: xxxxxxxxxxx
#  api v3 密钥 必填
      app-v3-secret: xxxxxxxx
#  微信支付商户号 服务商模式下为服务商的mchid 必填
      mch-id: xxxxxxx
#  商户服务器域名 用于回调  需要放开回调接口的安全策略 必填
      domain: https://felord.cn
#  商户 api 证书路径 必填  填写classpath路径 位于 maven项目的resources文件下
      cert-path: apiclient_cert.p12
 
```
#### <span style="color:red;">微信支付 tentantID 场景说明</span>

当项目中需要同时支持微信App支付、微信公众号支付、微信小程序支付时，上述配置中的`app-id`可能为多个，因此我们需要进行路由标识以区分它们，所以这里需要你定义一个`tentanID`来进行标识。假如我们同时有App支付和微信小程序支付，我们应该这样配置：

```yaml
wechat:
  pay:
    v3:
    # App租户租户标识为 mobile
     mobile:
      app-id: wx524534x423234
      app-secret: felord
      app-v3-secret: 0e5b123323h12234927e455703ec
      mch-id: 1603337223
      domain: https://felord.cn/mobile
      cert-path: mobile/apiclient_cert.p12
    # 微信小程序租户标识为 miniapp  
     miniapp:
      app-id: wx344123x3541223
      app-secret: felord
      app-v3-secret: 0e5b123323h12234927e455703ec
      mch-id: 1603337223
      domain: https://felord.cn/miniapp
      cert-path: miniapp/apiclient_cert.p12
      # 是否启用微信支付公钥
      enable-wechat-pay-public: true
      #微信公钥ID
      wechat-pay-public-key-id: PUB_KEY_ID_0116278111111115222222501
      #微信公钥
      wechat-pay-public-key-path: pub_key.pem
      wechat-pay-public-key-absolute-path: D:\\felord\\wechat\\cert\\pub_key.pem
      #是否启用从平台证书切换成微信支付公钥 不填默认为false，
      switch-verify-sign-method: true
```

>  ❗注意：在一套系统中需要开发者保证`tentanID`唯一。

### 支付宝

在Spring Boot项目中的`application.yaml`中配置`ali.pay.v1`相关参数。证书细节参见【日常踩坑】
```yaml
ali:
  pay:
    v1:
# 可以替换为沙箱
      server-url: https://openapi.alipaydev.com/gateway.do
# 蚂蚁开放平台申请并认证的应用appId
      app-id: 2016223700762343
      app-private-key-path: META-INF/app_rsa
      alipay-public-cert-path: META-INF/alipayCertPublicKey_RSA2.crt
      alipay-root-cert-path: META-INF/alipayRootCert.crt
      app-cert-public-key-path: META-INF/appCertPublicKey_2016102700769563.crt
      charset: utf-8
      format: json
      sign-type: RSA2
```
> ❗注意：只有`ali.pay.v1.app-id`设置了有效值才能启用支付宝API。

## 启用配置

配置完毕后需要启用`@EnableMobilePay`注解来开启支付功能：

```java
@EnableMobilePay
@Configuration
public class PayConfig {
}
```
## 使用API

### 微信支付

微信支付V3开放接口都是通过`WechatApiProvider`引入的，当[启用配置](/quick_start?id=启用配置)步骤完成后会被初始化并注入了**Spring IoC**，可通过如下形式引入：
```java
    @Autowired
    WechatApiProvider wechatApiProvider;
```
`WechatApiProvider`需要开发者明确租户ID[tenantID](quick_start?id=微信支付-tentantid-场景说明)以初始化具体场景的**Api**。例如查询终端用户在租户`mobile`下的优惠券：

```java
     // 查询商户下的优惠券
     @Test
     public void v3MchStocks() {
        // 配置文件中对应的tenantID:
        String tenantId =“mobile”;
        StocksQueryParams params = new StocksQueryParams();
        params.setOffset(0);
        params.setLimit(10);
        WechatResponseEntity<ObjectNode> objectNodeWechatResponseEntity = wechatApiProvider.favorApi(tenantId).queryStocksByMch(params);
        System.out.println("objectNodeWechatResponseEntity = " + objectNodeWechatResponseEntity);
     }
```


### 支付宝
当[启用配置](/quick_start?id=启用配置)步骤完成后会初始化支付宝支付客户端接口`AlipayClient`并注入**Spring IoC**，可通过以下形式引入：
```java
    @Autowired
    AlipayClient alipayClient;
```
调用，以现金红包为例：
```java
    @SneakyThrows
    public void campaignCash() {
        AlipayMarketingCampaignCashCreateRequest request = new AlipayMarketingCampaignCashCreateRequest();
        request.setBizContent("{" +
                "\"coupon_name\":\"XXX周年庆红包\"," +
                "\"prize_type\":\"random\"," +
                "\"total_money\":\"10000.00\"," +
                "\"total_num\":\"1000\"," +
                "\"prize_msg\":\"XXX送您大红包\"," +
                "\"start_time\":\"2020-11-02 22:48:30\"," +
                "\"end_time\":\"2020-12-01 22:48:30\"," +
                "\"merchant_link\":\"http://www.weibo.com\"," +
                "\"send_freqency\":\"D3|L10\"" +
                "  }");

        AlipayMarketingCampaignCashCreateResponse execute = alipayClient.certificateExecute(request);

        System.out.println("execute = " + execute.getBody());
    }
```