mirror of
https://github.com/dromara/payment-spring-boot.git
synced 2026-03-14 05:43:46 +08:00
修改文档
This commit is contained in:
felord.cn
158
README.md
158
README.md
@@ -1,159 +1,7 @@
|
|||||||
# 移动支付 Spring Boot 组件
|
# 移动支付 Spring Boot 组件
|
||||||
为了满足业务中出现app支付、公众号支付、小程序支付等多appid并存的场景，对原有的进行了增强开发出了多租户版本。
|
为了满足业务中出现app支付、公众号支付、小程序支付等多appid并存的场景，对原有的进行了增强开发出了多租户版本。
|
||||||
|
|
||||||
## 支持类型
|
# 文档地址
|
||||||
|
|
||||||
- [x] **微信支付V3** 全量支持，并支持多租户。
|
[payment-spring-boot 文档](https://notfound403.github.io/payment-spring-boot)
|
||||||
- [x] **支付宝** 集成SDK，作简单适配。
|
|
||||||
## 进度
|
|
||||||
- 微信支付营销-代金券 `WechatMarketingFavorApi` 100%
|
|
||||||
- 微信支付 支付功能-普通支付直连模式 `WechatDirectPayApi` 100%
|
|
||||||
|
|
||||||
## 采用技术
|
|
||||||
- Spring
|
|
||||||
- Jackson
|
|
||||||
- Ali-pay-sdk
|
|
||||||
## 使用方法
|
|
||||||
### 集成
|
|
||||||
以**Spring Boot Starter**的形式集成到项目中。
|
|
||||||
|
|
||||||
```xml
|
|
||||||
<dependency>
|
|
||||||
<groupId>cn.felord</groupId>
|
|
||||||
<artifactId>payment-spring-boot-starter</artifactId>
|
|
||||||
<version>1.0.0.RELEASE</version>
|
|
||||||
</dependency>
|
|
||||||
```
|
|
||||||
### 配置
|
|
||||||
#### 微信支付
|
|
||||||
在Spring Boot项目中的`application.yaml`中配置`wechat.pay`相关参数。
|
|
||||||
```yaml
|
|
||||||
wechat:
|
|
||||||
pay:
|
|
||||||
v3:
|
|
||||||
# 租户id
|
|
||||||
<tentantID>:
|
|
||||||
# 应用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
|
|
||||||
|
|
||||||
```
|
|
||||||
然后启用`@EnableWechatPay`注解：
|
|
||||||
```java
|
|
||||||
@EnableMobilePay
|
|
||||||
@Configuration
|
|
||||||
public class PayConfig {
|
|
||||||
}
|
|
||||||
```
|
|
||||||
> 请注意：只有`wechat.pay.v3.app-id`设置了有效值才能启用下面的API。
|
|
||||||
##### API使用
|
|
||||||
微信支付V3开放接口引入：
|
|
||||||
```java
|
|
||||||
@Autowired
|
|
||||||
WechatApiProvider wechatApiProvider;
|
|
||||||
```
|
|
||||||
###### V3
|
|
||||||
例如V3 查询商户下的优惠券
|
|
||||||
|
|
||||||
```java
|
|
||||||
// 查询商户下的优惠券
|
|
||||||
@Test
|
|
||||||
public void v3MchStocks() {
|
|
||||||
// 配置文件中对应的tenantID:
|
|
||||||
String tenantId =<tenantID>;
|
|
||||||
StocksQueryParams params = new StocksQueryParams();
|
|
||||||
params.setOffset(0);
|
|
||||||
params.setLimit(10);
|
|
||||||
WechatResponseEntity<ObjectNode> objectNodeWechatResponseEntity = wechatApiProvider.favorApi(tenantId).queryStocksByMch(params);
|
|
||||||
System.out.println("objectNodeWechatResponseEntity = " + objectNodeWechatResponseEntity);
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
#### 支付宝
|
|
||||||
##### 使用须知
|
|
||||||
请注意因为未来**SHA1withRSA**将被淘汰，因此采用最新的**SHA256withRSA**证书，旧的模式将不提供支持。步骤如下：
|
|
||||||
|
|
||||||
1.使用支付宝开发助手申请CSR文件
|
|
||||||
|
|
||||||
|
|
||||||
申请成功后看文件说明：
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
2.上传CSR设置证书
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
上传成功后需要下载证书，和配置的对应关系为：
|
|
||||||
|
|
||||||
|
|
||||||
3. 其它开发平台商户平台的配置，参考支付宝接入文档。
|
|
||||||
##### 项目开发配置
|
|
||||||
在Spring Boot项目中的`application.yaml`中配置`ali.pay`相关参数。
|
|
||||||
```yaml
|
|
||||||
ali:
|
|
||||||
pay:
|
|
||||||
v1:
|
|
||||||
# 可以替换为沙箱
|
|
||||||
server-url: https://openapi.alipaydev.com/gateway.do
|
|
||||||
# 蚂蚁开放平台申请并认证的应用appId
|
|
||||||
app-id: 2016102700769563
|
|
||||||
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。
|
|
||||||
##### API的使用
|
|
||||||
|
|
||||||
引入接口：
|
|
||||||
```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());
|
|
||||||
}
|
|
||||||
```
|
|
||||||
打印响应体：
|
|
||||||
```json
|
|
||||||
{"alipay_marketing_campaign_cash_create_response":{"code":"40004","msg":"Business Failed","sub_code":"isv.UNKNOW_SYSTEM_ERROR","sub_msg":"系统繁忙，请稍后再试"},"alipay_cert_sn":"e65893247c520d9d46db3000158505ee","sign":"M7gyi6ZwnRoHmdzd1IIxLc+XEE1pCx6ptOyQP4aRGMc01bJebNL7PbMpfU7TcB75KHmk3Oor2fYZfVEB7+5gxV9YwMuW3QtZbyACw3Gzt7wz4D1YCXkQD9PRvSsgw8xgNL+WnZxEI2yFdSp47Mc/Um73M101zFeo2dYKYXyVRdsGxnipY8fZs0JaXlX5OoROfHDcbvzBDjQyernspIoFoNiAwpaBwyQcEzh8V34ca4Rep/LSyI4N4VtU0n2nq3dO0Jor36n0o4j0QobWSE3c8StkVjbdP5XJB+adE51MUmh7xDdixQXE2fTRKw5wYlBO9O3bpF/uw78hWW/y3JwG9Q=="}
|
|
||||||
```
|
|
||||||
## CHANGELOG
|
|
||||||
### 1.0.0.RELEASE
|
|
||||||
|
|
||||||
- 支持微信支付V3、支付宝支付
|
|
||||||
- 微信支付多租户
|
|
||||||
@@ -1 +1,2 @@
|
|||||||
|
* [项目简介](README.md)
|
||||||
* [快速接入](quick_start.md)
|
* [快速接入](quick_start.md)
|
||||||
Reference in New Issue
Block a user