项目初始化

09-后台API说明/支付退款接口字段清单.md

@@ -0,0 +1,47 @@
+# 支付退款接口字段清单
+
+## 1. 创建支付单
+- 接口路径：`POST /api/user/orders/{orderId}/pay`
+- 功能说明：生成支付凭证，供小程序拉起支付。
+
+### 请求参数
+| 字段 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| orderId | string | 是 | 订单ID |
+
+### 返回字段
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| orderId | string | 订单ID |
+| payParams | object | 支付参数对象 |
+| payStatus | string | 当前支付状态 |
+
+## 2. 发起退款申请
+- 接口路径：`POST /api/user/refunds`
+- 功能说明：用户发起退款申请。
+
+### 请求参数
+| 字段 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| signupId | string | 是 | 报名单ID |
+| reason | string | 是 | 退款原因 |
+
+### 返回字段
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| refundId | string | 退款单ID |
+| refundStatus | string | 当前退款状态 |
+| refundAmount | number | 退款金额 |
+
+## 3. 查询退款详情
+- 接口路径：`GET /api/user/refunds/{refundId}`
+- 功能说明：查看退款处理进度。
+
+### 返回字段
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| refundId | string | 退款单ID |
+| refundStatus | string | 退款状态 |
+| refundAmount | number | 退款金额 |
+| reason | string | 退款原因 |
+| processedAt | string | 处理时间 |