代理在线充值
All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 8m6s

This commit is contained in:
2026-07-27 16:02:55 +08:00
parent a2166c8011
commit cbf909b878
42 changed files with 3121 additions and 195 deletions

View File

@@ -490,6 +490,91 @@ components:
description: 总记录数
type: integer
type: object
DtoAgentRechargeOnlineResponse:
properties:
amount:
description: 在线充值金额范围10000分~100000000分
type: integer
payment_method:
description: 支付方式 (wechat:微信, alipay:支付宝)
type: string
payment_no:
description: 支付单号PAY前缀
type: string
qr_content:
description: 支付渠道原始扫码付款内容,由前端渲染二维码
type: string
recharge_id:
description: 充值记录ID
minimum: 0
type: integer
recharge_no:
description: 充值单号ARCH前缀
type: string
recharge_source:
description: 充值来源 (agent_online:代理在线自充)
type: string
recharge_source_name:
description: 充值来源名称(中文)
type: string
status:
description: 状态 (1:待支付, 2:已支付, 3:已完成, 4:已关闭, 5:已退款, 6:已驳回)
type: integer
status_name:
description: 状态名称(中文)
type: string
type: object
DtoAgentRechargePaymentMethodsResponse:
properties:
max_amount:
description: 在线充值最大金额固定为100000000
type: integer
methods:
description: 可用支付方式,固定顺序 (wechat:微信, alipay:支付宝)
items:
type: string
nullable: true
type: array
min_amount:
description: 在线充值最小金额固定为10000
type: integer
type: object
DtoAgentRechargePaymentStatusResponse:
properties:
completed_at:
description: 钱包入账完成时间
nullable: true
type: string
paid_at:
description: 第三方支付确认时间
nullable: true
type: string
payment_status:
description: 支付状态 (0:待支付, 1:已支付, 2:已失败, 3:已退款)
type: integer
payment_status_name:
description: 支付状态名称(中文)
type: string
recharge_id:
description: 充值记录ID
minimum: 0
type: integer
recharge_no:
description: 充值单号ARCH前缀
type: string
recharge_source:
description: 充值来源 (platform_offline:平台线下代充, agent_online:代理在线自充)
type: string
recharge_source_name:
description: 充值来源名称(中文)
type: string
status:
description: 充值状态 (1:待支付, 2:已支付, 3:已完成, 4:已关闭, 5:已退款, 6:已驳回)
type: integer
status_name:
description: 充值状态名称(中文)
type: string
type: object
DtoAgentRechargeRejectParams:
properties:
rejection_reason:
@@ -546,7 +631,7 @@ components:
nullable: true
type: integer
payment_method:
description: 支付方式 (wechat:微信在线支付, offline:线下转账)
description: 支付方式 (wechat:微信在线支付, alipay:支付宝在线支付, offline:线下转账)
type: string
payment_transaction_id:
description: 第三方支付流水号
@@ -560,6 +645,12 @@ components:
recharge_no:
description: 充值单号(ARCH前缀)
type: string
recharge_source:
description: 充值来源 (platform_offline:平台线下代充, agent_online:代理在线自充)
type: string
recharge_source_name:
description: 充值来源名称(中文)
type: string
rejection_reason:
description: 驳回原因,仅 status=6 时有值
nullable: true
@@ -3580,7 +3671,7 @@ components:
minimum: 1
type: integer
payment_method:
description: 支付方式 (wechat:微信在线支付, offline:线下转账仅平台可用)
description: 支付方式 (wechat:微信在线支付, alipay:支付宝在线支付, offline:线下转账仅平台可用)
type: string
payment_voucher_key:
description: 支付凭证对象存储Key列表payment_method=offline 时至少1个最多5个微信支付时忽略
@@ -3593,12 +3684,16 @@ components:
description: 运营备注(可选,创建后只读)
maxLength: 1000
type: string
request_id:
description: 在线充值幂等请求标识,微信或支付宝支付时必填
maxLength: 64
type: string
shop_id:
description: 目标店铺ID代理只能填自己店铺
description: 目标店铺ID仅平台线下代充可填;代理在线充值禁止传入
minimum: 0
nullable: true
type: integer
required:
- shop_id
- amount
- payment_method
type: object
@@ -12194,6 +12289,12 @@ paths:
description: 按状态过滤 (1:待支付, 2:已支付, 3:已完成, 4:已关闭, 5:已退款, 6:已驳回)
nullable: true
type: integer
- description: 按充值来源过滤 (platform_offline:平台线下代充, agent_online:代理在线自充)
in: query
name: recharge_source
schema:
description: 按充值来源过滤 (platform_offline:平台线下代充, agent_online:代理在线自充)
type: string
- description: 创建时间起始日期(YYYY-MM-DD)
in: query
name: start_date
@@ -12279,7 +12380,7 @@ paths:
example: 0
type: integer
data:
$ref: '#/components/schemas/DtoAgentRechargeResponse'
$ref: '#/components/schemas/DtoAgentRechargeOnlineResponse'
msg:
description: 响应消息
example: success
@@ -12463,6 +12564,73 @@ paths:
summary: 确认线下充值
tags:
- 代理预充值
/api/admin/agent-recharges/{id}/payment-status:
get:
parameters:
- description: ID
in: path
name: id
required: true
schema:
description: ID
minimum: 0
type: integer
responses:
"200":
content:
application/json:
schema:
properties:
code:
description: 响应码
example: 0
type: integer
data:
$ref: '#/components/schemas/DtoAgentRechargePaymentStatusResponse'
msg:
description: 响应消息
example: success
type: string
timestamp:
description: 时间戳
format: date-time
type: string
required:
- code
- msg
- data
- timestamp
type: object
description: 成功
"400":
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: 请求参数错误
"401":
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: 未认证或认证已过期
"403":
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: 无权访问
"500":
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: 服务器内部错误
security:
- BearerAuth: []
summary: 查询代理充值本地支付与到账状态
tags:
- 代理预充值
/api/admin/agent-recharges/{id}/reject:
post:
parameters:
@@ -12509,6 +12677,64 @@ paths:
summary: 驳回代理充值订单
tags:
- 代理预充值
/api/admin/agent-recharges/payment-methods:
get:
responses:
"200":
content:
application/json:
schema:
properties:
code:
description: 响应码
example: 0
type: integer
data:
$ref: '#/components/schemas/DtoAgentRechargePaymentMethodsResponse'
msg:
description: 响应消息
example: success
type: string
timestamp:
description: 时间戳
format: date-time
type: string
required:
- code
- msg
- data
- timestamp
type: object
description: 成功
"400":
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: 请求参数错误
"401":
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: 未认证或认证已过期
"403":
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: 无权访问
"500":
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: 服务器内部错误
security:
- BearerAuth: []
summary: 查询代理在线充值可用支付方式
tags:
- 代理预充值
/api/admin/asset-allocation-records:
get:
parameters: