48 lines
1.3 KiB
Markdown
48 lines
1.3 KiB
Markdown
|
# 支付退款接口字段清单
|
||
|
|
|
||
|
|
## 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 | 处理时间 |
|