This commit is contained in:
@@ -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"
|
||||
}
|
||||
|
||||
@@ -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: 充值支付完成
|
||||
|
||||
|
||||
Reference in New Issue
Block a user