package dto // CreateAgentRechargeRequest 创建代理充值请求 type CreateAgentRechargeRequest struct { ShopID uint `json:"shop_id" validate:"required" required:"true" description:"目标店铺ID,代理只能填自己店铺"` Amount int64 `json:"amount" validate:"required,min=10000,max=100000000" required:"true" minimum:"10000" maximum:"100000000" description:"充值金额(分),范围100元~100万元"` PaymentMethod string `json:"payment_method" validate:"required,oneof=wechat offline" required:"true" description:"支付方式 (wechat:微信在线支付, offline:线下转账仅平台可用)"` } // AgentOfflinePayRequest 代理线下充值确认请求 type AgentOfflinePayRequest struct { OperationPassword string `json:"operation_password" validate:"required" required:"true" description:"操作密码"` } // AgentOfflinePayParams 确认线下充值聚合参数 (用于文档生成) type AgentOfflinePayParams struct { IDReq AgentOfflinePayRequest } // AgentRechargeResponse 代理充值记录响应 type AgentRechargeResponse struct { ID uint `json:"id" description:"充值记录ID"` RechargeNo string `json:"recharge_no" description:"充值单号(ARCH前缀)"` ShopID uint `json:"shop_id" description:"店铺ID"` ShopName string `json:"shop_name" description:"店铺名称"` AgentWalletID uint `json:"agent_wallet_id" description:"代理钱包ID"` Amount int64 `json:"amount" description:"充值金额(分)"` PaymentMethod string `json:"payment_method" description:"支付方式 (wechat:微信在线支付, offline:线下转账)"` PaymentChannel string `json:"payment_channel" description:"实际支付通道 (wechat_direct:微信直连, fuyou:富友, offline:线下转账)"` PaymentConfigID *uint `json:"payment_config_id" description:"关联支付配置ID,线下充值为null"` PaymentTransactionID string `json:"payment_transaction_id" description:"第三方支付流水号"` Status int `json:"status" description:"状态 (1:待支付, 2:已完成, 3:已取消)"` PaidAt *string `json:"paid_at" description:"支付时间"` CompletedAt *string `json:"completed_at" description:"完成时间"` CreatedAt string `json:"created_at" description:"创建时间"` UpdatedAt string `json:"updated_at" description:"更新时间"` } // AgentRechargeListRequest 代理充值记录列表请求 type AgentRechargeListRequest struct { Page int `json:"page" query:"page" validate:"omitempty,min=1" minimum:"1" description:"页码,默认1"` PageSize int `json:"page_size" query:"page_size" validate:"omitempty,min=1,max=100" minimum:"1" maximum:"100" description:"每页条数,默认20,最大100"` ShopID *uint `json:"shop_id" query:"shop_id" description:"按店铺ID过滤"` Status *int `json:"status" query:"status" description:"按状态过滤 (1:待支付, 2:已完成, 3:已取消)"` StartDate string `json:"start_date" query:"start_date" description:"创建时间起始日期(YYYY-MM-DD)"` EndDate string `json:"end_date" query:"end_date" description:"创建时间截止日期(YYYY-MM-DD)"` } // AgentRechargeListResponse 代理充值记录列表响应 type AgentRechargeListResponse struct { Total int64 `json:"total" description:"总记录数"` Page int `json:"page" description:"当前页码"` PageSize int `json:"page_size" description:"每页条数"` List []*AgentRechargeResponse `json:"list" description:"充值记录列表"` }