1
All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 7m59s

This commit is contained in:
2026-05-18 10:34:04 +08:00
parent ed071918ed
commit 480d4c4583
6 changed files with 27 additions and 11 deletions

View File

@@ -47,12 +47,12 @@ POST /api/admin/agent-recharges
| 字段名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| shop_id | integer | 是 | 目标店铺 ID。代理账号只能填写自己所属店铺 ID |
| amount | integer | 是 | 充值金额(单位:分)。范围:10000~100000000(即 100 元~100 万元) |
| amount | integer | 是 | 充值金额(单位:分)。范围:1~100000000(即 1 分~100 万元) |
| payment_method | string | 是 | 支付方式。可选值:`wechat`(在线微信支付)、`offline`(线下转账,仅平台可用) |
**业务规则**
- `amount` 最小值为 `AgentRechargeMinAmount`(10000 分 = 100 元),最大值为 `AgentRechargeMaxAmount`(100000000 分 = 100 万元)
- `amount` 最小值为 `AgentRechargeMinAmount`(1 分),最大值为 `AgentRechargeMaxAmount`(100000000 分 = 100 万元)
- `payment_method=wechat` 时,系统根据当前激活的支付配置自动路由至微信直连或富友通道,并记录 `payment_config_id`;客户端发起支付的具体流程本期暂不实现(Stub)
- `payment_method=offline` 仅平台账号可使用,代理账号调用此方式将返回 `1005 CodeForbidden`
- 订单创建后状态为 `1`(待支付)
@@ -103,7 +103,7 @@ POST /api/admin/agent-recharges
```json
{
"code": 1001,
"msg": "充值金额超出允许范围(100元~100万元)",
"msg": "充值金额超出允许范围(1分~100万元)",
"data": null,
"timestamp": "2026-03-16T10:00:00+08:00"
}

View File

@@ -121,7 +121,7 @@
- `agent_wallet_id`:代理钱包 ID(BIGINT,关联 tb_agent_wallet.id)
- `shop_id`:店铺 ID(BIGINT,冗余字段,便于查询)
- `recharge_no`:充值订单号(VARCHAR(50),唯一,格式:ARCH+时间戳+随机数)
- `amount`:充值金额(BIGINT,单位:分,≥ 10000)
- `amount`:充值金额(BIGINT,单位:分,≥ 1)
- `payment_method`:支付方式(VARCHAR(20),枚举值:"alipay"-支付宝 | "wechat"-微信 | "bank"-银行转账 | "offline"-线下)
- `payment_channel`:支付渠道(VARCHAR(50),可空)
- `payment_transaction_id`:第三方支付交易号(VARCHAR(100),可空)
@@ -137,7 +137,7 @@
**表名**:`tb_agent_recharge_record`
**充值金额限制**:
- 最小充值金额:10000 分(100 元)
- 最小充值金额:1 分
- 最大充值金额:100000000 分(1000000 元)
**索引**:
@@ -153,8 +153,8 @@
#### Scenario: 充值金额低于最小限制
- **WHEN** 店铺管理员尝试充值 5000 分(50 元)
- **THEN** 系统拒绝创建充值订单,返回错误信息"充值金额不能低于 100 元"
- **WHEN** 店铺管理员尝试充值 0 分
- **THEN** 系统拒绝创建充值订单,返回错误信息"充值金额超出允许范围"
#### Scenario: 充值支付完成