black1552/lkl_sdk
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases 1 Wiki Activity

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

Browse Source 
- 为 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
Download Patch File Download Diff File Expand all files Collapse all files
unifiedreturn/refund/api.go
+40
View File
@@ -0,0 +1,40 @@
package refund
import (
"github.com/black1552/lkl_sdk/common"
"github.com/black1552/lkl_sdk/consts"
"github.com/gogf/gf/v2/os/gtime"
)
// Refund 统一退货API结构体
type Refund struct {
client *common.Client[ResponseRefund]
}
// NewRefund 创建统一退货API实例
func NewRefund(client *common.Client[ResponseRefund]) *Refund {
return &Refund{
client: client,
}
}
// Refund 发起统一退货请求
// request: 统一退货请求参数
// 返回统一退货响应结果和错误信息
func (api *Refund) Refund(req *RequestDataRefund) (*ResponseRefund, error) {
// 构建请求参数
url := consts.BASE_URL + consts.LKL_UNIFIED_RETURN_REFUND_URL
// 构建BaseModel请求
baseReq := RequestRefund{
ReqTime: gtime.Now().Format("YmdHis"),
Version: "3.0",
ReqData: req,
}
// 发送请求
respBody, err := api.client.DoRequest(url, baseReq)
if err != nil {
return nil, err
}
return respBody, nil
}
unifiedreturn/refund/reponse.go
+37
View File
@@ -0,0 +1,37 @@
package refund
// ResponseRefund 统一退货响应结构体
// 参考文档：https://o.lakala.com/#/home/document/detail?id=892
type ResponseRefund struct {
Code string `json:"code" dc:"Code 返回业务代码 必填，通讯成功返回码：000000；交易未知：RFD11105/RFD11112；其他返回码可视为失败"`
Msg string `json:"msg" dc:"Msg 返回业务代码描述 必填，如\"成功\""`
RespTime string `json:"resp_time" dc:"RespTime 响应时间 必填，格式yyyyMMddHHmmss"`
RespData *ResponseDataRefund `json:"resp_data" dc:"RespData 响应数据 必填，具体字段根据接口返回"`
}
func (r *ResponseRefund) SuccessOrFail() bool {
return r.Code == "000000"
}
// ResponseDataRefund 统一退货响应数据结构体
type ResponseDataRefund struct {
TradeState string `json:"trade_state" dc:"TradeState 交易状态 必填，INIT-初始化；SUCCESS-交易成功；FAIL-交易失败；DEAL-交易处理中/未知；PROCESSING-交易已受理；TIMEOUT-超时未知；EXCEPTION-异常"`
RefundType string `json:"refund_type" dc:"RefundType 退货模式 必填"`
MerchantNo string `json:"merchant_no" dc:"MerchantNo 商户号 必填，拉卡拉分配的商户号"`
OutTradeNo string `json:"out_trade_no" dc:"OutTradeNo 商户请求流水号 必填，请求中的商户请求流水号"`
TradeNo string `json:"trade_no" dc:"TradeNo 拉卡拉交易流水号 必填"`
LogNo string `json:"log_no" dc:"LogNo 拉卡拉对账单流水号 必填，tradeNo的后14位"`
AccTradeNo string `json:"acc_trade_no,omitempty" dc:"AccTradeNo 账户端交易订单号 可选"`
AccountType string `json:"account_type,omitempty" dc:"AccountType 钱包类型 可选，微信：WECHAT；支付宝：ALIPAY；银联：UQRCODEPAY；翼支付:BESTPAY；苏宁易付宝:SUNING"`
TotalAmount string `json:"total_amount" dc:"TotalAmount 交易金额 必填，单位分，整数数字型字符串"`
RefundAmount string `json:"refund_amount" dc:"RefundAmount 申请退款金额 必填，单位分，整数数字型字符串"`
PayerAmount string `json:"payer_amount" dc:"PayerAmount 实际退款金额 必填，单位分，整数数字型字符串"`
TradeTime string `json:"trade_time,omitempty" dc:"TradeTime 退款时间 可选，实际退款时间。yyyyMMddHHmmss"`
OriginLogNo string `json:"origin_log_no,omitempty" dc:"OriginLogNo 原拉卡拉对账单流水号 可选，如果请求中携带，则返回"`
OriginTradeNo string `json:"origin_trade_no,omitempty" dc:"OriginTradeNo 原拉卡拉交易流水号 可选，如果请求中携带，则返回"`
OriginOutTradeNo string `json:"origin_out_trade_no,omitempty" dc:"OriginOutTradeNo 原商户请求流水号 可选，如果请求中携带，则返回"`
UpIssAddData string `json:"up_iss_add_data,omitempty" dc:"UpIssAddData 单品营销附加数据 可选，扫码交易，参与单品营销优惠时返回"`
UpCouponInfo string `json:"up_coupon_info,omitempty" dc:"UpCouponInfo 银联优惠信息 可选，扫码交易，参与单品营销优惠时返回"`
TradeInfo string `json:"trade_info,omitempty" dc:"TradeInfo 出资方信息 可选，扫码交易"`
ChannelRetDesc string `json:"channel_ret_desc" dc:"ChannelRetDesc 返回描述信息 必填"`
}
unifiedreturn/refund/request.go
+34
View File
@@ -0,0 +1,34 @@
package refund
// RequestRefund 统一退货基础请求结构体
// 参考文档：https://o.lakala.com/#/home/document/detail?id=894
type RequestRefund struct {
ReqTime string `json:"req_time"`
Version string `json:"version"`
ReqData *RequestDataRefund `json:"req_data"`
}
// RequestDataRefund 统一退货请求数据结构体
// 注意：origin_out_trade_no、origin_log_no、origin_trade_no至少一个必填（调用收银台下单接口拉起交易后发起退款时至少要传两个）
// 优先级顺序：origin_trade_no > origin_log_no > origin_out_trade_no
type RequestDataRefund struct {
MerchantNo string `json:"merchant_no"` // merchant_no: 商户号 (必填，拉卡拉分配的商户号，String(15))
TermNo string `json:"term_no"` // term_no: 终端号 (必填，拉卡拉分配的终端号，String(8))
OutTradeNo string `json:"out_trade_no"` // out_trade_no: 商户请求流水号 (必填，商户系统唯一，String(32))
RefundAmount string `json:"refund_amount"` // refund_amount: 退款金额 (必填，单位分，整数数字型字符，String(12))
RefundReason string `json:"refund_reason,omitempty"` // refund_reason: 退货原因 (可选，String(32))
OriginLogNo string `json:"origin_log_no,omitempty"` // origin_log_no: 拉卡拉对账单流水号 (可选，正交易返回的拉卡拉对账单流水号，String(14))
OriginOutTradeNo string `json:"origin_out_trade_no,omitempty"` // origin_out_trade_no: 原商户交易流水号 (可选，String(32))
OriginTradeNo string `json:"origin_trade_no,omitempty"` // origin_trade_no: 原交易拉卡拉交易订单号 (可选，String(32))
LocationInfo *LocationInfo `json:"location_info"` // location_info: 地址位置信息 (必填)
RefundAccMode string `json:"refund_acc_mode,omitempty"` // refund_acc_mode: 退货账户模式 (可选，00退货账户余额 05商户余额 06终端余额 30终点账户，String(2))
NotifyURL string `json:"notify_url,omitempty"` // notify_url: 后台通知地址 (可选，交易结果通知地址，String(128))
RefundAmtSts string `json:"refund_amt_sts,omitempty"` // refund_amt_sts: 退货资金状态 (可选，00 分账前，01 分账后；分账交易部分退货的情况，需要前端上送交易的分账状态，String(2))
}
// LocationInfo 地址位置信息结构体
type LocationInfo struct {
RequestIP string `json:"request_ip"` // request_ip: 请求IP (必填)
Location string `json:"location"` // location: 位置信息 (必填，如经纬度等)
BaseStation string `json:"base_station,omitempty"` // base_station: 基站信息 (可选)
}