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`:代理钱包 IDBIGINT关联 tb_agent_wallet.id
- `shop_id`:店铺 IDBIGINT冗余字段便于查询
- `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: 充值支付完成