feat: 实现客户端核心业务接口（client-core-business-api）
新增客户端资产、钱包、订单、实名、设备管理等核心业务 Handler 与 DTO： - 客户端资产信息查询、套餐列表、套餐历史、资产刷新 - 客户端钱包详情、流水、充值校验、充值订单、充值记录 - 客户端订单创建、列表、详情 - 客户端实名认证链接获取 - 客户端设备卡列表、重启、恢复出厂、WiFi配置、切卡 - 客户端订单服务（含微信/支付宝支付流程） - 强充自动代购异步任务处理 - 数据库迁移 000084：充值记录增加自动代购状态字段
This commit is contained in:
86
internal/model/dto/client_asset_dto.go
Normal file
86
internal/model/dto/client_asset_dto.go
Normal file
@@ -0,0 +1,86 @@
|
||||
package dto
|
||||
|
||||
// ========================================
|
||||
// B1 资产信息
|
||||
// ========================================
|
||||
|
||||
// AssetInfoRequest B1 资产信息请求
|
||||
type AssetInfoRequest struct {
|
||||
Identifier string `json:"identifier" query:"identifier" validate:"required,min=1,max=50" required:"true" minLength:"1" maxLength:"50" description:"资产标识符（SN/IMEI/虚拟号/ICCID/MSISDN）"`
|
||||
}
|
||||
|
||||
// AssetInfoResponse B1 资产信息响应
|
||||
type AssetInfoResponse struct {
|
||||
AssetType string `json:"asset_type" description:"资产类型 (card:卡, device:设备)"`
|
||||
AssetID uint `json:"asset_id" description:"资产ID"`
|
||||
Identifier string `json:"identifier" description:"资产标识符"`
|
||||
VirtualNo string `json:"virtual_no" description:"虚拟号"`
|
||||
Status int `json:"status" description:"状态 (0:禁用, 1:启用)"`
|
||||
RealNameStatus int `json:"real_name_status" description:"实名状态 (0:未实名, 1:已实名)"`
|
||||
CarrierName string `json:"carrier_name" description:"运营商名称"`
|
||||
Generation string `json:"generation" description:"制式"`
|
||||
WalletBalance int64 `json:"wallet_balance" description:"钱包余额（分）"`
|
||||
}
|
||||
|
||||
// ========================================
|
||||
// B2 资产可购套餐列表
|
||||
// ========================================
|
||||
|
||||
// AssetPackageListRequest B2 资产可购套餐列表请求
|
||||
type AssetPackageListRequest struct {
|
||||
Identifier string `json:"identifier" query:"identifier" validate:"required,min=1,max=50" required:"true" minLength:"1" maxLength:"50" description:"资产标识符（SN/IMEI/虚拟号/ICCID/MSISDN）"`
|
||||
}
|
||||
|
||||
// ClientPackageItem B2 客户端套餐项
|
||||
type ClientPackageItem struct {
|
||||
PackageID uint `json:"package_id" description:"套餐ID"`
|
||||
PackageName string `json:"package_name" description:"套餐名称"`
|
||||
PackageType string `json:"package_type" description:"套餐类型 (formal:正式套餐, addon:加油包)"`
|
||||
RetailPrice int64 `json:"retail_price" description:"零售价（分）"`
|
||||
CostPrice int64 `json:"cost_price" description:"成本价（分）"`
|
||||
ValidityDays int `json:"validity_days" description:"有效天数"`
|
||||
IsAddon bool `json:"is_addon" description:"是否加油包"`
|
||||
DataAllowance int64 `json:"data_allowance" description:"流量额度"`
|
||||
DataUnit string `json:"data_unit" description:"流量单位"`
|
||||
Description string `json:"description" description:"套餐说明"`
|
||||
}
|
||||
|
||||
// AssetPackageListResponse B2 资产可购套餐列表响应
|
||||
type AssetPackageListResponse struct {
|
||||
Packages []ClientPackageItem `json:"packages" description:"套餐列表"`
|
||||
}
|
||||
|
||||
// ========================================
|
||||
// B3 资产套餐历史
|
||||
// ========================================
|
||||
|
||||
// AssetPackageHistoryRequest B3 资产套餐历史请求
|
||||
type AssetPackageHistoryRequest struct {
|
||||
Identifier string `json:"identifier" query:"identifier" validate:"required,min=1,max=50" required:"true" minLength:"1" maxLength:"50" description:"资产标识符（SN/IMEI/虚拟号/ICCID/MSISDN）"`
|
||||
Page int `json:"page" query:"page" validate:"required,min=1" required:"true" minimum:"1" description:"页码"`
|
||||
PageSize int `json:"page_size" query:"page_size" validate:"required,min=1,max=100" required:"true" minimum:"1" maximum:"100" description:"每页数量"`
|
||||
}
|
||||
|
||||
// AssetPackageHistoryResponse B3 资产套餐历史响应
|
||||
type AssetPackageHistoryResponse struct {
|
||||
List []AssetPackageResponse `json:"list" description:"套餐历史列表"`
|
||||
Total int64 `json:"total" description:"总数"`
|
||||
Page int `json:"page" description:"页码"`
|
||||
PageSize int `json:"page_size" description:"每页数量"`
|
||||
}
|
||||
|
||||
// ========================================
|
||||
// B4 资产刷新
|
||||
// ========================================
|
||||
|
||||
// AssetRefreshRequest B4 资产刷新请求
|
||||
type AssetRefreshRequest struct {
|
||||
Identifier string `json:"identifier" validate:"required,min=1,max=50" required:"true" minLength:"1" maxLength:"50" description:"资产标识符（SN/IMEI/虚拟号/ICCID/MSISDN）"`
|
||||
}
|
||||
|
||||
// AssetRefreshResponse B4 资产刷新响应
|
||||
type AssetRefreshResponse struct {
|
||||
RefreshType string `json:"refresh_type" description:"刷新类型 (card:卡, device:设备)"`
|
||||
Accepted bool `json:"accepted" description:"是否已受理"`
|
||||
CooldownSeconds int `json:"cooldown_seconds" description:"冷却秒数"`
|
||||
}
|
||||
113
internal/model/dto/client_order_dto.go
Normal file
113
internal/model/dto/client_order_dto.go
Normal file
@@ -0,0 +1,113 @@
|
||||
package dto
|
||||
|
||||
// ========================================
|
||||
// D1 客户端创建订单
|
||||
// ========================================
|
||||
|
||||
// ClientCreateOrderRequest D1 客户端创建订单请求
|
||||
type ClientCreateOrderRequest struct {
|
||||
Identifier string `json:"identifier" validate:"required,min=1,max=50" required:"true" minLength:"1" maxLength:"50" description:"资产标识符（SN/IMEI/虚拟号/ICCID/MSISDN）"`
|
||||
PackageIDs []uint `json:"package_ids" validate:"required,min=1,dive,gt=0" required:"true" description:"套餐ID列表"`
|
||||
AppType string `json:"app_type" validate:"required,oneof=official_account miniapp" required:"true" description:"应用类型 (official_account:公众号, miniapp:小程序)"`
|
||||
}
|
||||
|
||||
// ClientCreateOrderResponse D1 客户端创建订单响应
|
||||
type ClientCreateOrderResponse struct {
|
||||
OrderType string `json:"order_type" description:"订单类型 (package:套餐订单, recharge:充值订单)"`
|
||||
Order *ClientOrderInfo `json:"order,omitempty" description:"套餐订单信息"`
|
||||
Recharge *ClientRechargeInfo `json:"recharge,omitempty" description:"充值订单信息"`
|
||||
PayConfig *ClientPayConfig `json:"pay_config" description:"支付配置"`
|
||||
LinkedPackageInfo *LinkedPackageInfo `json:"linked_package_info,omitempty" description:"关联套餐信息"`
|
||||
}
|
||||
|
||||
// ClientOrderInfo D1 套餐订单信息
|
||||
type ClientOrderInfo struct {
|
||||
OrderID uint `json:"order_id" description:"订单ID"`
|
||||
OrderNo string `json:"order_no" description:"订单号"`
|
||||
TotalAmount int64 `json:"total_amount" description:"订单总金额（分）"`
|
||||
PaymentStatus int `json:"payment_status" description:"支付状态 (0:待支付, 1:已支付, 2:已取消)"`
|
||||
CreatedAt string `json:"created_at" description:"创建时间"`
|
||||
}
|
||||
|
||||
// ClientRechargeInfo D1 充值订单信息
|
||||
type ClientRechargeInfo struct {
|
||||
RechargeID uint `json:"recharge_id" description:"充值ID"`
|
||||
RechargeNo string `json:"recharge_no" description:"充值单号"`
|
||||
Amount int64 `json:"amount" description:"充值金额（分）"`
|
||||
Status int `json:"status" description:"状态 (0:待支付, 1:已支付, 2:已关闭)"`
|
||||
AutoPurchaseStatus string `json:"auto_purchase_status" description:"自动购包状态"`
|
||||
}
|
||||
|
||||
// ClientPayConfig D1 支付配置
|
||||
type ClientPayConfig struct {
|
||||
AppID string `json:"app_id" description:"应用ID"`
|
||||
Timestamp string `json:"timestamp" description:"时间戳"`
|
||||
NonceStr string `json:"nonce_str" description:"随机字符串"`
|
||||
PackageVal string `json:"package" description:"预支付参数"`
|
||||
SignType string `json:"sign_type" description:"签名类型"`
|
||||
PaySign string `json:"pay_sign" description:"支付签名"`
|
||||
}
|
||||
|
||||
// LinkedPackageInfo D1 关联套餐信息
|
||||
type LinkedPackageInfo struct {
|
||||
PackageNames []string `json:"package_names" description:"套餐名称列表"`
|
||||
TotalPackageAmount int64 `json:"total_package_amount" description:"套餐总金额（分）"`
|
||||
ForceRechargeAmount int64 `json:"force_recharge_amount" description:"强制充值金额（分）"`
|
||||
WalletCredit int64 `json:"wallet_credit" description:"钱包抵扣金额（分）"`
|
||||
}
|
||||
|
||||
// ========================================
|
||||
// D2 客户端订单列表
|
||||
// ========================================
|
||||
|
||||
// ClientOrderListRequest D2 客户端订单列表请求
|
||||
type ClientOrderListRequest struct {
|
||||
Identifier string `json:"identifier" query:"identifier" validate:"required,min=1,max=50" required:"true" minLength:"1" maxLength:"50" description:"资产标识符（SN/IMEI/虚拟号/ICCID/MSISDN）"`
|
||||
PaymentStatus *int `json:"payment_status" query:"payment_status" validate:"omitempty,min=0,max=2" minimum:"0" maximum:"2" description:"支付状态 (0:待支付, 1:已支付, 2:已取消)"`
|
||||
Page int `json:"page" query:"page" validate:"required,min=1" required:"true" minimum:"1" description:"页码"`
|
||||
PageSize int `json:"page_size" query:"page_size" validate:"required,min=1,max=100" required:"true" minimum:"1" maximum:"100" description:"每页数量"`
|
||||
}
|
||||
|
||||
// ClientOrderListItem D2 客户端订单列表项
|
||||
type ClientOrderListItem struct {
|
||||
OrderID uint `json:"order_id" description:"订单ID"`
|
||||
OrderNo string `json:"order_no" description:"订单号"`
|
||||
TotalAmount int64 `json:"total_amount" description:"订单总金额（分）"`
|
||||
PaymentStatus int `json:"payment_status" description:"支付状态 (0:待支付, 1:已支付, 2:已取消)"`
|
||||
CreatedAt string `json:"created_at" description:"创建时间"`
|
||||
PackageNames []string `json:"package_names" description:"套餐名称列表"`
|
||||
}
|
||||
|
||||
// ClientOrderListResponse D2 客户端订单列表响应
|
||||
type ClientOrderListResponse struct {
|
||||
List []ClientOrderListItem `json:"list" description:"订单列表"`
|
||||
Total int64 `json:"total" description:"总数"`
|
||||
Page int `json:"page" description:"页码"`
|
||||
PageSize int `json:"page_size" description:"每页数量"`
|
||||
}
|
||||
|
||||
// ========================================
|
||||
// D3 客户端订单详情
|
||||
// ========================================
|
||||
|
||||
// ClientOrderDetailResponse D3 客户端订单详情响应
|
||||
type ClientOrderDetailResponse struct {
|
||||
OrderID uint `json:"order_id" description:"订单ID"`
|
||||
OrderNo string `json:"order_no" description:"订单号"`
|
||||
TotalAmount int64 `json:"total_amount" description:"订单总金额（分）"`
|
||||
PaymentStatus int `json:"payment_status" description:"支付状态 (0:待支付, 1:已支付, 2:已取消)"`
|
||||
PaymentMethod string `json:"payment_method" description:"支付方式"`
|
||||
CreatedAt string `json:"created_at" description:"创建时间"`
|
||||
PaidAt *string `json:"paid_at,omitempty" description:"支付时间"`
|
||||
CompletedAt *string `json:"completed_at,omitempty" description:"完成时间"`
|
||||
Packages []ClientOrderPackageItem `json:"packages" description:"订单套餐列表"`
|
||||
}
|
||||
|
||||
// ClientOrderPackageItem D3 订单套餐项
|
||||
type ClientOrderPackageItem struct {
|
||||
PackageID uint `json:"package_id" description:"套餐ID"`
|
||||
PackageName string `json:"package_name" description:"套餐名称"`
|
||||
PackageType string `json:"package_type" description:"套餐类型 (formal:正式套餐, addon:加油包)"`
|
||||
Price int64 `json:"price" description:"单价（分）"`
|
||||
Quantity int `json:"quantity" description:"数量"`
|
||||
}
|
||||
104
internal/model/dto/client_realname_device_dto.go
Normal file
104
internal/model/dto/client_realname_device_dto.go
Normal file
@@ -0,0 +1,104 @@
|
||||
package dto
|
||||
|
||||
// ========================================
|
||||
// E1 实名链接获取
|
||||
// ========================================
|
||||
|
||||
// RealnimeLinkRequest E1 实名链接请求
|
||||
type RealnimeLinkRequest struct {
|
||||
Identifier string `json:"identifier" query:"identifier" validate:"required,min=1,max=50" required:"true" minLength:"1" maxLength:"50" description:"资产标识符（SN/IMEI/虚拟号/ICCID/MSISDN）"`
|
||||
ICCID string `json:"iccid" query:"iccid" validate:"omitempty,max=30" maxLength:"30" description:"物联网卡ICCID"`
|
||||
}
|
||||
|
||||
// RealnimeLinkResponse E1 实名链接响应
|
||||
type RealnimeLinkResponse struct {
|
||||
RealnameMode string `json:"realname_mode" description:"实名模式 (none:无需实名, template:模板实名, gateway:网关实名)"`
|
||||
RealnameURL string `json:"realname_url" description:"实名链接"`
|
||||
CardInfo CardInfoBrief `json:"card_info" description:"卡片简要信息"`
|
||||
ExpireAt *string `json:"expire_at,omitempty" description:"过期时间"`
|
||||
}
|
||||
|
||||
// CardInfoBrief E1 卡片简要信息
|
||||
type CardInfoBrief struct {
|
||||
ICCID string `json:"iccid" description:"物联网卡ICCID"`
|
||||
MSISDN string `json:"msisdn" description:"手机号"`
|
||||
VirtualNo string `json:"virtual_no" description:"虚拟号"`
|
||||
}
|
||||
|
||||
// ========================================
|
||||
// F1 设备卡列表
|
||||
// ========================================
|
||||
|
||||
// DeviceCardListRequest F1 设备卡列表请求
|
||||
type DeviceCardListRequest struct {
|
||||
Identifier string `json:"identifier" query:"identifier" validate:"required,min=1,max=50" required:"true" minLength:"1" maxLength:"50" description:"资产标识符（SN/IMEI/虚拟号/ICCID/MSISDN）"`
|
||||
}
|
||||
|
||||
// DeviceCardItem F1 设备卡项
|
||||
type DeviceCardItem struct {
|
||||
CardID uint `json:"card_id" description:"卡ID"`
|
||||
ICCID string `json:"iccid" description:"物联网卡ICCID"`
|
||||
MSISDN string `json:"msisdn" description:"手机号"`
|
||||
CarrierName string `json:"carrier_name" description:"运营商名称"`
|
||||
NetworkStatus string `json:"network_status" description:"网络状态"`
|
||||
RealNameStatus int `json:"real_name_status" description:"实名状态 (0:未实名, 1:已实名)"`
|
||||
SlotPosition int `json:"slot_position" description:"插槽位置"`
|
||||
IsActive bool `json:"is_active" description:"是否当前激活卡"`
|
||||
}
|
||||
|
||||
// DeviceCardListResponse F1 设备卡列表响应
|
||||
type DeviceCardListResponse struct {
|
||||
Cards []DeviceCardItem `json:"cards" description:"设备卡列表"`
|
||||
}
|
||||
|
||||
// ========================================
|
||||
// F2 设备重启
|
||||
// ========================================
|
||||
|
||||
// DeviceRebootRequest F2 设备重启请求
|
||||
type DeviceRebootRequest struct {
|
||||
Identifier string `json:"identifier" validate:"required,min=1,max=50" required:"true" minLength:"1" maxLength:"50" description:"资产标识符（SN/IMEI/虚拟号/ICCID/MSISDN）"`
|
||||
}
|
||||
|
||||
// DeviceOperationResponse F2/F3/F4 设备操作响应
|
||||
type DeviceOperationResponse struct {
|
||||
Accepted bool `json:"accepted" description:"是否已受理"`
|
||||
RequestID string `json:"request_id,omitempty" description:"请求ID"`
|
||||
}
|
||||
|
||||
// ========================================
|
||||
// F3 恢复出厂设置
|
||||
// ========================================
|
||||
|
||||
// DeviceFactoryResetRequest F3 恢复出厂设置请求
|
||||
type DeviceFactoryResetRequest struct {
|
||||
Identifier string `json:"identifier" validate:"required,min=1,max=50" required:"true" minLength:"1" maxLength:"50" description:"资产标识符（SN/IMEI/虚拟号/ICCID/MSISDN）"`
|
||||
}
|
||||
|
||||
// ========================================
|
||||
// F4 设备WiFi配置
|
||||
// ========================================
|
||||
|
||||
// DeviceWifiRequest F4 设备WiFi配置请求
|
||||
type DeviceWifiRequest struct {
|
||||
Identifier string `json:"identifier" validate:"required,min=1,max=50" required:"true" minLength:"1" maxLength:"50" description:"资产标识符（SN/IMEI/虚拟号/ICCID/MSISDN）"`
|
||||
SSID string `json:"ssid" validate:"required,min=1,max=32" required:"true" minLength:"1" maxLength:"32" description:"WiFi名称"`
|
||||
Password string `json:"password" validate:"required,min=1,max=64" required:"true" minLength:"1" maxLength:"64" description:"WiFi密码"`
|
||||
Enabled bool `json:"enabled" validate:"required" required:"true" description:"是否启用WiFi"`
|
||||
}
|
||||
|
||||
// ========================================
|
||||
// F5 设备切卡
|
||||
// ========================================
|
||||
|
||||
// DeviceSwitchCardRequest F5 设备切卡请求
|
||||
type DeviceSwitchCardRequest struct {
|
||||
Identifier string `json:"identifier" validate:"required,min=1,max=50" required:"true" minLength:"1" maxLength:"50" description:"资产标识符（SN/IMEI/虚拟号/ICCID/MSISDN）"`
|
||||
TargetICCID string `json:"target_iccid" validate:"required,min=1,max=30" required:"true" minLength:"1" maxLength:"30" description:"目标ICCID"`
|
||||
}
|
||||
|
||||
// DeviceSwitchCardResponse F5 设备切卡响应
|
||||
type DeviceSwitchCardResponse struct {
|
||||
Accepted bool `json:"accepted" description:"是否已受理"`
|
||||
TargetICCID string `json:"target_iccid" description:"目标ICCID"`
|
||||
}
|
||||
138
internal/model/dto/client_wallet_dto.go
Normal file
138
internal/model/dto/client_wallet_dto.go
Normal file
@@ -0,0 +1,138 @@
|
||||
package dto
|
||||
|
||||
// ========================================
|
||||
// C1 钱包详情
|
||||
// ========================================
|
||||
|
||||
// WalletDetailRequest C1 钱包详情请求
|
||||
type WalletDetailRequest struct {
|
||||
Identifier string `json:"identifier" query:"identifier" validate:"required,min=1,max=50" required:"true" minLength:"1" maxLength:"50" description:"资产标识符（SN/IMEI/虚拟号/ICCID/MSISDN）"`
|
||||
}
|
||||
|
||||
// WalletDetailResponse C1 钱包详情响应
|
||||
type WalletDetailResponse struct {
|
||||
WalletID uint `json:"wallet_id" description:"钱包ID"`
|
||||
ResourceType string `json:"resource_type" description:"资源类型 (iot_card:物联网卡, device:设备)"`
|
||||
ResourceID uint `json:"resource_id" description:"资源ID"`
|
||||
Balance int64 `json:"balance" description:"可用余额（分）"`
|
||||
FrozenBalance int64 `json:"frozen_balance" description:"冻结余额（分）"`
|
||||
UpdatedAt string `json:"updated_at" description:"更新时间"`
|
||||
}
|
||||
|
||||
// ========================================
|
||||
// C2 钱包流水列表
|
||||
// ========================================
|
||||
|
||||
// WalletTransactionListRequest C2 钱包流水列表请求
|
||||
type WalletTransactionListRequest struct {
|
||||
Identifier string `json:"identifier" query:"identifier" validate:"required,min=1,max=50" required:"true" minLength:"1" maxLength:"50" description:"资产标识符（SN/IMEI/虚拟号/ICCID/MSISDN）"`
|
||||
TransactionType string `json:"transaction_type" query:"transaction_type" validate:"omitempty,max=50" maxLength:"50" description:"流水类型"`
|
||||
StartTime string `json:"start_time" query:"start_time" validate:"omitempty,max=32" maxLength:"32" description:"开始时间"`
|
||||
EndTime string `json:"end_time" query:"end_time" validate:"omitempty,max=32" maxLength:"32" description:"结束时间"`
|
||||
Page int `json:"page" query:"page" validate:"required,min=1" required:"true" minimum:"1" description:"页码"`
|
||||
PageSize int `json:"page_size" query:"page_size" validate:"required,min=1,max=100" required:"true" minimum:"1" maximum:"100" description:"每页数量"`
|
||||
}
|
||||
|
||||
// WalletTransactionItem C2 钱包流水项
|
||||
type WalletTransactionItem struct {
|
||||
TransactionID uint `json:"transaction_id" description:"流水ID"`
|
||||
Type string `json:"type" description:"流水类型"`
|
||||
Amount int64 `json:"amount" description:"变动金额（分）"`
|
||||
BalanceAfter int64 `json:"balance_after" description:"变动后余额（分）"`
|
||||
CreatedAt string `json:"created_at" description:"创建时间"`
|
||||
Remark string `json:"remark" description:"备注"`
|
||||
}
|
||||
|
||||
// WalletTransactionListResponse C2 钱包流水列表响应
|
||||
type WalletTransactionListResponse struct {
|
||||
List []WalletTransactionItem `json:"list" description:"流水列表"`
|
||||
Total int64 `json:"total" description:"总数"`
|
||||
Page int `json:"page" description:"页码"`
|
||||
PageSize int `json:"page_size" description:"每页数量"`
|
||||
}
|
||||
|
||||
// ========================================
|
||||
// C3 充值前校验
|
||||
// ========================================
|
||||
|
||||
// ClientRechargeCheckRequest C3 充值前校验请求
|
||||
type ClientRechargeCheckRequest struct {
|
||||
Identifier string `json:"identifier" query:"identifier" validate:"required,min=1,max=50" required:"true" minLength:"1" maxLength:"50" description:"资产标识符（SN/IMEI/虚拟号/ICCID/MSISDN）"`
|
||||
}
|
||||
|
||||
// ClientRechargeCheckResponse C3 充值前校验响应
|
||||
type ClientRechargeCheckResponse struct {
|
||||
NeedForceRecharge bool `json:"need_force_recharge" description:"是否需要强制充值"`
|
||||
ForceRechargeAmount int64 `json:"force_recharge_amount" description:"强制充值金额（分）"`
|
||||
TriggerType string `json:"trigger_type" description:"触发类型"`
|
||||
MinAmount int64 `json:"min_amount" description:"最小充值金额（分）"`
|
||||
MaxAmount int64 `json:"max_amount" description:"最大充值金额（分）"`
|
||||
Message string `json:"message" description:"提示信息"`
|
||||
}
|
||||
|
||||
// ========================================
|
||||
// C4 创建充值订单
|
||||
// ========================================
|
||||
|
||||
// ClientCreateRechargeRequest C4 创建充值订单请求
|
||||
type ClientCreateRechargeRequest struct {
|
||||
Identifier string `json:"identifier" validate:"required,min=1,max=50" required:"true" minLength:"1" maxLength:"50" description:"资产标识符（SN/IMEI/虚拟号/ICCID/MSISDN）"`
|
||||
Amount int64 `json:"amount" validate:"required,min=100,max=10000000" required:"true" minimum:"100" maximum:"10000000" description:"充值金额（分）"`
|
||||
PaymentMethod string `json:"payment_method" validate:"required,oneof=wechat" required:"true" description:"支付方式 (wechat:微信支付)"`
|
||||
AppType string `json:"app_type" validate:"required,oneof=official_account miniapp" required:"true" description:"应用类型 (official_account:公众号, miniapp:小程序)"`
|
||||
}
|
||||
|
||||
// ClientRechargeResponse C4 创建充值订单响应
|
||||
type ClientRechargeResponse struct {
|
||||
Recharge ClientRechargeResult `json:"recharge" description:"充值信息"`
|
||||
PayConfig ClientRechargePayConfig `json:"pay_config" description:"支付配置"`
|
||||
}
|
||||
|
||||
// ClientRechargeResult C4 充值信息
|
||||
type ClientRechargeResult struct {
|
||||
RechargeID uint `json:"recharge_id" description:"充值ID"`
|
||||
RechargeNo string `json:"recharge_no" description:"充值单号"`
|
||||
Amount int64 `json:"amount" description:"充值金额（分）"`
|
||||
Status int `json:"status" description:"状态 (0:待支付, 1:已支付, 2:已关闭)"`
|
||||
}
|
||||
|
||||
// ClientRechargePayConfig C4 支付配置
|
||||
type ClientRechargePayConfig struct {
|
||||
AppID string `json:"app_id" description:"应用ID"`
|
||||
Timestamp string `json:"timestamp" description:"时间戳"`
|
||||
NonceStr string `json:"nonce_str" description:"随机字符串"`
|
||||
PackageVal string `json:"package" description:"预支付参数"`
|
||||
SignType string `json:"sign_type" description:"签名类型"`
|
||||
PaySign string `json:"pay_sign" description:"支付签名"`
|
||||
}
|
||||
|
||||
// ========================================
|
||||
// C5 充值记录列表
|
||||
// ========================================
|
||||
|
||||
// ClientRechargeListRequest C5 充值记录列表请求
|
||||
type ClientRechargeListRequest struct {
|
||||
Identifier string `json:"identifier" query:"identifier" validate:"required,min=1,max=50" required:"true" minLength:"1" maxLength:"50" description:"资产标识符（SN/IMEI/虚拟号/ICCID/MSISDN）"`
|
||||
Status *int `json:"status" query:"status" validate:"omitempty,min=0,max=2" minimum:"0" maximum:"2" description:"充值状态 (0:待支付, 1:已支付, 2:已关闭)"`
|
||||
Page int `json:"page" query:"page" validate:"required,min=1" required:"true" minimum:"1" description:"页码"`
|
||||
PageSize int `json:"page_size" query:"page_size" validate:"required,min=1,max=100" required:"true" minimum:"1" maximum:"100" description:"每页数量"`
|
||||
}
|
||||
|
||||
// ClientRechargeListItem C5 充值记录项
|
||||
type ClientRechargeListItem struct {
|
||||
RechargeID uint `json:"recharge_id" description:"充值ID"`
|
||||
RechargeNo string `json:"recharge_no" description:"充值单号"`
|
||||
Amount int64 `json:"amount" description:"充值金额（分）"`
|
||||
Status int `json:"status" description:"状态 (0:待支付, 1:已支付, 2:已关闭)"`
|
||||
PaymentMethod string `json:"payment_method" description:"支付方式"`
|
||||
CreatedAt string `json:"created_at" description:"创建时间"`
|
||||
AutoPurchaseStatus string `json:"auto_purchase_status" description:"自动购包状态"`
|
||||
}
|
||||
|
||||
// ClientRechargeListResponse C5 充值记录列表响应
|
||||
type ClientRechargeListResponse struct {
|
||||
List []ClientRechargeListItem `json:"list" description:"充值记录列表"`
|
||||
Total int64 `json:"total" description:"总数"`
|
||||
Page int `json:"page" description:"页码"`
|
||||
PageSize int `json:"page_size" description:"每页数量"`
|
||||
}
|
||||
Reference in New Issue
Block a user