200 lines
4.5 KiB
Markdown
200 lines
4.5 KiB
Markdown
# 后端接口 TODO 清单 - 支付集成模块
|
||
|
||
## 支付SDK集成说明
|
||
|
||
**文件**: `RoomDetailActivity.java`
|
||
|
||
### 需要集成的支付方式
|
||
1. 微信支付
|
||
2. 支付宝支付
|
||
3. 其他支付方式（可选）
|
||
|
||
## 1. 创建支付订单
|
||
**接口路径**: `POST /api/payment/create`
|
||
**请求参数**:
|
||
```json
|
||
{
|
||
"userId": "string",
|
||
"orderType": "recharge",
|
||
"amount": "number",
|
||
"coinAmount": "number",
|
||
"paymentMethod": "wechat|alipay",
|
||
"rechargeOptionId": "string"
|
||
}
|
||
```
|
||
**返回数据**:
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"data": {
|
||
"orderId": "string",
|
||
"orderNo": "string",
|
||
"amount": "number",
|
||
"paymentParams": {
|
||
"appId": "string",
|
||
"partnerId": "string",
|
||
"prepayId": "string",
|
||
"packageValue": "string",
|
||
"nonceStr": "string",
|
||
"timeStamp": "string",
|
||
"sign": "string"
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
## 2. 查询支付状态
|
||
**接口路径**: `GET /api/payment/status/{orderId}`
|
||
**请求参数**: orderId (路径参数)
|
||
**返回数据**:
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"data": {
|
||
"orderId": "string",
|
||
"status": "pending|success|failed|cancelled",
|
||
"paidAt": "number",
|
||
"amount": "number"
|
||
}
|
||
}
|
||
```
|
||
|
||
## 3. 支付回调通知
|
||
**接口路径**: `POST /api/payment/callback/wechat` 或 `/api/payment/callback/alipay`
|
||
**说明**:
|
||
- 此接口由支付平台调用，不是前端调用
|
||
- 用于接收支付成功的异步通知
|
||
- 支付成功后更新订单状态和用户金币余额
|
||
|
||
## 4. 获取支付历史
|
||
**接口路径**: `GET /api/payment/history`
|
||
**请求参数**:
|
||
- userId: 用户ID（从token中获取）
|
||
- page (可选): 页码
|
||
- pageSize (可选): 每页数量
|
||
**返回数据**:
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"data": [
|
||
{
|
||
"orderId": "string",
|
||
"orderNo": "string",
|
||
"amount": "number",
|
||
"coinAmount": "number",
|
||
"status": "string",
|
||
"paymentMethod": "string",
|
||
"createdAt": "number",
|
||
"paidAt": "number"
|
||
}
|
||
]
|
||
}
|
||
```
|
||
|
||
## 微信支付集成步骤
|
||
|
||
### 1. 添加依赖
|
||
```gradle
|
||
implementation 'com.tencent.mm.opensdk:wechat-sdk-android:6.8.0'
|
||
```
|
||
|
||
### 2. 配置微信支付
|
||
- 在微信开放平台注册应用
|
||
- 获取 AppID 和 AppSecret
|
||
- 配置支付回调URL
|
||
|
||
### 3. 调用支付
|
||
```java
|
||
// 1. 创建支付订单，获取支付参数
|
||
// 2. 调用微信支付SDK
|
||
IWXAPI api = WXAPIFactory.createWXAPI(context, APP_ID);
|
||
PayReq request = new PayReq();
|
||
request.appId = paymentParams.getAppId();
|
||
request.partnerId = paymentParams.getPartnerId();
|
||
request.prepayId = paymentParams.getPrepayId();
|
||
request.packageValue = paymentParams.getPackageValue();
|
||
request.nonceStr = paymentParams.getNonceStr();
|
||
request.timeStamp = paymentParams.getTimeStamp();
|
||
request.sign = paymentParams.getSign();
|
||
api.sendReq(request);
|
||
```
|
||
|
||
### 4. 处理支付结果
|
||
```java
|
||
// 在 WXPayEntryActivity 中接收支付结果
|
||
@Override
|
||
public void onResp(BaseResp resp) {
|
||
if (resp.getType() == ConstantsAPI.COMMAND_PAY_BY_WX) {
|
||
if (resp.errCode == 0) {
|
||
// 支付成功
|
||
// 查询订单状态确认
|
||
} else if (resp.errCode == -2) {
|
||
// 用户取消
|
||
} else {
|
||
// 支付失败
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
## 支付宝支付集成步骤
|
||
|
||
### 1. 添加依赖
|
||
```gradle
|
||
implementation 'com.alipay.sdk:alipaysdk-android:15.8.11'
|
||
```
|
||
|
||
### 2. 配置支付宝
|
||
- 在支付宝开放平台注册应用
|
||
- 获取 AppID 和私钥
|
||
- 配置支付回调URL
|
||
|
||
### 3. 调用支付
|
||
```java
|
||
// 1. 创建支付订单，获取支付参数（orderInfo）
|
||
// 2. 调用支付宝SDK
|
||
PayTask alipay = new PayTask(activity);
|
||
Map<String, String> result = alipay.payV2(orderInfo, true);
|
||
```
|
||
|
||
### 4. 处理支付结果
|
||
```java
|
||
// 解析支付结果
|
||
String resultStatus = result.get("resultStatus");
|
||
if (TextUtils.equals(resultStatus, "9000")) {
|
||
// 支付成功
|
||
// 查询订单状态确认
|
||
} else if (TextUtils.equals(resultStatus, "6001")) {
|
||
// 用户取消
|
||
} else {
|
||
// 支付失败
|
||
}
|
||
```
|
||
|
||
## 支付流程
|
||
|
||
### 充值流程
|
||
1. 用户选择充值金额
|
||
2. 选择支付方式（微信/支付宝）
|
||
3. 调用创建支付订单接口
|
||
4. 获取支付参数
|
||
5. 调用支付SDK发起支付
|
||
6. 用户完成支付
|
||
7. 接收支付结果回调
|
||
8. 查询订单状态确认支付成功
|
||
9. 更新用户金币余额
|
||
10. 显示充值成功提示
|
||
|
||
### 安全建议
|
||
1. 支付参数签名验证
|
||
2. 订单金额二次验证
|
||
3. 防止重复支付
|
||
4. 支付超时处理
|
||
5. 异常订单处理
|
||
|
||
### 错误处理
|
||
- 网络错误: 提示用户重试
|
||
- 支付取消: 关闭支付页面
|
||
- 支付失败: 显示失败原因，允许重试
|
||
- 订单查询失败: 提示联系客服
|