feat(basePay): 添加测试环境支持和新功能

- 为 transPreorder 和 relationClose 添加测试环境请求方法
- 更新所有模块导入路径,统一使用新的 common 包
- 重构多个结构体和服务命名以提高一致性
- 新增 labs 包整合基础支付相关功能模块
- 创建 SDK 入口文件便于统一管理和调用
- 在 consts 中增加 BASE_TEST_URL 常量定义
- 优化请求数据结构体字段注释和文档标签
- 移除冗余代码并调整部分函数签名以增强可读性
This commit is contained in:
maguodong
2025-10-21 14:34:42 +08:00
parent 7b9657a9e8
commit 54917f8985
50 changed files with 158 additions and 83 deletions
+39
View File
@@ -0,0 +1,39 @@
package transmicropay
import (
"github.com/black1552/lkl_sdk/common"
"github.com/black1552/lkl_sdk/consts"
"github.com/gogf/gf/v2/os/gtime"
)
// API 聚合被扫API结构体
type TransMicropayServer struct {
Client *common.Client[TransMicropayResponse]
}
// NewAPI 创建聚合被扫API实例
func NewTransMicropayServer(client *common.Client[TransMicropayResponse]) *TransMicropayServer {
return &TransMicropayServer{
Client: client,
}
}
// TransMicropay 执行聚合被扫请求
// - merchantNo: 商户号
// - termNo: 终端号
// - outTradeNo: 商户交易流水号
// - authCode: 支付授权码
// - totalAmount: 金额
// - locationInfo: 地址位置信息
// - 其他可选参数通过TransMicropayRequestData的其他字段设置
func (a *TransMicropayServer) TransMicropay(reqData *TransMicropayRequestData) (*TransMicropayResponse, error) {
// 构建请求结构体
request := &TransMicropayRequest{
ReqTime: gtime.Now().Format("YmdHis"),
Version: "3.0",
ReqData: reqData,
}
// 发送请求 - 使用consts中定义的聚合被扫URL
return a.Client.DoRequest(consts.BASE_URL+consts.LKL_BASE_URL_TRANS_MICROPAY_URL, request)
}
+56
View File
@@ -0,0 +1,56 @@
package transmicropay
// LocationInfo 地址位置信息结构体
type LocationInfo struct {
RequestIP string `json:"request_ip"` // 请求方IP地址 (必填)
BaseStation string `json:"base_station,omitempty"` // 基站信息 (可选)
Location string `json:"location,omitempty"` // 纬度,经度 (银联二维码交易必填)
}
// GoodsInfo 商品信息结构体
type GoodsInfo struct {
GoodsId string `json:"goods_id,omitempty"` // 商品ID (可选)
GoodsName string `json:"goods_name,omitempty"` // 商品名称 (可选)
Price string `json:"price,omitempty"` // 商品单价 (可选)
Quantity string `json:"quantity,omitempty"` // 商品数量 (可选)
CategoryId string `json:"category_id,omitempty"` // 商品类目ID (可选)
Body string `json:"body,omitempty"` // 商品描述 (可选)
}
// AccBusiFields 账户端业务信息域结构体
type AccBusiFields struct {
ExtendParams string `json:"extend_params,omitempty"` // 业务扩展参数 (可选)
GoodsDetail string `json:"goods_detail,omitempty"` // 商品详情 (可选)
StoreId string `json:"store_id,omitempty"` // 商户门店编号 (可选)
AlipayStoreId string `json:"alipay_store_id,omitempty"` // 支付宝店铺编号 (不再使用)
TimeoutExpress string `json:"timeout_express,omitempty"` // 交易有效时间 (可选)
DisablePayChannels string `json:"disable_pay_channels,omitempty"` // 支付宝禁用支付渠道 (可选)
BusinessParams string `json:"business_params,omitempty"` // 商户传入业务信息 (可选)
MinAge string `json:"min_age,omitempty"` // 允许的最小买家年龄 (可选)
PromoParams string `json:"promo_params,omitempty"` // 优惠明细 (可选)
}
// TransMicropayRequestData 聚合被扫请求数据结构体
type TransMicropayRequestData struct {
MerchantNo string `json:"merchant_no"` // 商户号 (必填)
TermNo string `json:"term_no"` // 终端号 (必填)
OutTradeNo string `json:"out_trade_no"` // 商户交易流水号 (必填)
AuthCode string `json:"auth_code"` // 支付授权码 (必填)
TotalAmount string `json:"total_amount"` // 金额 (必填)
LocationInfo *LocationInfo `json:"location_info"` // 地址位置信息 (必填)
BusiMode string `json:"busi_mode,omitempty"` // 业务模式 (可选)
Subject string `json:"subject,omitempty"` // 订单标题 (可选,微信支付必送)
PayOrderNo string `json:"pay_order_no,omitempty"` // 支付业务订单号 (可选)
NotifyURL string `json:"notify_url,omitempty"` // 商户通知地址 (可选)
SettleType string `json:"settle_type,omitempty"` // 结算类型 (可选)
Remark string `json:"remark,omitempty"` // 备注 (可选)
ScanType string `json:"scan_type,omitempty"` // 扫码类型 (可选)
AccBusiFields *AccBusiFields `json:"acc_busi_fields,omitempty"` // 账户端业务信息域 (可选)
}
// TransMicropayRequest 聚合被扫请求结构体
type TransMicropayRequest struct {
ReqTime string `json:"req_time"`
Version string `json:"version"`
ReqData *TransMicropayRequestData `json:"req_data"`
}
+31
View File
@@ -0,0 +1,31 @@
package transmicropay
// TransMicropayResponseData 聚合被扫响应数据结构体
type TransMicropayResponseData struct {
MerchantNo string `json:"merchant_no"` // 商户号
TermNo string `json:"term_no"` // 终端号
OutTradeNo string `json:"out_trade_no"` // 商户交易流水号
TradeNo string `json:"trade_no"` // 拉卡拉交易流水号
LogNo string `json:"log_no"` // 拉卡拉对账单流水号
TotalAmount string `json:"total_amount"` // 交易总金额
TradeTime string `json:"trade_time"` // 交易时间
PayStatus string `json:"pay_status"` // 支付状态
OrderDesc string `json:"order_desc,omitempty"` // 订单描述
PayAmount string `json:"pay_amount,omitempty"` // 实际支付金额
PayChannel string `json:"pay_channel,omitempty"` // 支付渠道
ChannelTradeNo string `json:"channel_trade_no,omitempty"` // 渠道交易号
AuthCode string `json:"auth_code,omitempty"` // 支付授权码
}
// TransMicropayResponse 聚合被扫响应结构体
type TransMicropayResponse struct {
RespTime string `json:"resp_time"`
Code string `json:"code"`
Msg string `json:"msg"`
RespData *TransMicropayResponseData `json:"resp_data,omitempty"`
}
// SuccessOrFail 判断响应是否成功
func (r *TransMicropayResponse) SuccessOrFail() bool {
return r.Code == "BBS00000"
}