feat(basePay): 添加测试环境支持和新功能
- 为 transPreorder 和 relationClose 添加测试环境请求方法 - 更新所有模块导入路径，统一使用新的 common 包 - 重构多个结构体和服务命名以提高一致性 - 新增 labs 包整合基础支付相关功能模块 - 创建 SDK 入口文件便于统一管理和调用 - 在 consts 中增加 BASE_TEST_URL 常量定义 - 优化请求数据结构体字段注释和文档标签 - 移除冗余代码并调整部分函数签名以增强可读性
This commit is contained in:
maguodong
@@ -0,0 +1,35 @@
|
||||
package mergerefund
|
||||
|
||||
import (
|
||||
"github.com/black1552/lkl_sdk/common"
|
||||
"github.com/black1552/lkl_sdk/consts"
|
||||
"github.com/gogf/gf/v2/os/gtime"
|
||||
)
|
||||
|
||||
type MergeRefund struct {
|
||||
client *common.Client[ResponseMergeRefund]
|
||||
}
|
||||
|
||||
func NewMergeRefund(client *common.Client[ResponseMergeRefund]) *MergeRefund {
|
||||
return &MergeRefund{
|
||||
client: client,
|
||||
}
|
||||
}
|
||||
func (t *MergeRefund) MergeRefund(req *RequestDataMergeRefund) (*ResponseMergeRefund, error) {
|
||||
// 构建BaseModel请求
|
||||
baseReq := RequestMergeRefund{
|
||||
ReqTime: gtime.Now().Format("YmdHis"),
|
||||
Version: "3.0",
|
||||
ReqData: req,
|
||||
}
|
||||
return t.client.DoRequest(consts.BASE_URL+consts.LKL_UNIFIED_RETURN_MERGE_REFUND_URL, baseReq)
|
||||
}
|
||||
func (t *MergeRefund) MergeRefundTest(req *RequestDataMergeRefund) (*ResponseMergeRefund, error) {
|
||||
// 构建BaseModel请求
|
||||
baseReq := RequestMergeRefund{
|
||||
ReqTime: gtime.Now().Format("YmdHis"),
|
||||
Version: "3.0",
|
||||
ReqData: req,
|
||||
}
|
||||
return t.client.DoRequest(consts.BASE_TEST_URL+consts.LKL_UNIFIED_RETURN_MERGE_REFUND_URL, baseReq)
|
||||
}
|
||||
@@ -0,0 +1,42 @@
|
||||
package mergerefund
|
||||
|
||||
// RequestMergeRefund 统一退货基础请求结构体
|
||||
type RequestMergeRefund struct {
|
||||
ReqTime string `json:"req_time" dc:"ReqTime 请求时间 必填，格式yyyyMMddHHmmss"`
|
||||
Version string `json:"version" dc:"Version 版本号 必填，固定为\"3\""`
|
||||
ReqData *RequestDataMergeRefund `json:"req_data" dc:"ReqData 请求参数 必填，具体字段见对应的数据结构体"`
|
||||
}
|
||||
|
||||
// RequestDataMergeRefund 合单退货请求参数结构体
|
||||
type RequestDataMergeRefund struct {
|
||||
MerchantNo string `json:"merchant_no" dc:"MerchantNo 商户号 必填，拉卡拉分配的商户号"`
|
||||
TermNo string `json:"term_no" dc:"TermNo 终端号 必填，拉卡拉分配的终端号"`
|
||||
OutTradeNo string `json:"out_trade_no" dc:"OutTradeNo 商户请求流水号 必填，商户系统唯一"`
|
||||
RefundAmount string `json:"refund_amount" dc:"RefundAmount 退款金额 必填，单位分，整数数字型字符"`
|
||||
RefundReason string `json:"refund_reason,omitempty" dc:"RefundReason 退货原因 可选"`
|
||||
OriginLogNo string `json:"origin_log_no,omitempty" dc:"OriginLogNo 拉卡拉对账单流水号 可选，正交易返回的拉卡拉对账单流水号"`
|
||||
OriginOutTradeNo string `json:"origin_out_trade_no,omitempty" dc:"OriginOutTradeNo 原商户交易流水号 可选"`
|
||||
OriginTradeNo string `json:"origin_trade_no,omitempty" dc:"OriginTradeNo 原交易拉卡拉交易订单号 可选"`
|
||||
LocationInfo *LocationInfo `json:"location_info" dc:"LocationInfo 地址位置信息 必填"`
|
||||
NotifyURL string `json:"notify_url,omitempty" dc:"NotifyURL 后台通知地址 可选，交易结果通知地址"`
|
||||
RefundAccMode string `json:"refund_acc_mode,omitempty" dc:"RefundAccMode 退货账户模式 可选，00退货账户余额 05商户余额 06终端余额"`
|
||||
RefundSplitInfo []*RelateOutSplitInfo `json:"refund_split_info,omitempty" dc:"RefundSplitInfo 请参合单域 可选"`
|
||||
}
|
||||
|
||||
// LocationInfo 地址位置信息结构体
|
||||
type LocationInfo struct {
|
||||
RequestIP string `json:"request_ip" dc:"RequestIP 请求方IP地址 必填，格式如36.45.36.95"`
|
||||
Location string `json:"location,omitempty" dc:"Location 维度,经度 可选，商户终端的地理位置，格式：纬度,经度，+表示北纬、东经，-表示南纬、西经，精度最长支持小数点后9位"`
|
||||
BaseStation string `json:"base_station,omitempty" dc:"BaseStation 基站信息 可选，客户端设备的基站信息"`
|
||||
}
|
||||
|
||||
// RelateOutSplitInfo 请求合单域结构体
|
||||
type RelateOutSplitInfo struct {
|
||||
OutSubTradeNo string `json:"out_sub_trade_no" dc:"OutSubTradeNo 外部子退款交易流水号 必填，商户子交易退款流水号，商户号下唯一"`
|
||||
MerchantNo string `json:"merchant_no" dc:"MerchantNo 商户号 必填，拉卡拉分配的商户号"`
|
||||
TermNo string `json:"term_no" dc:"TermNo 终端号 必填，拉卡拉分配的业务终端号"`
|
||||
RefundAmount string `json:"refund_amount" dc:"RefundAmount 申请退款金额 必填，单位分，整数型字符"`
|
||||
OriginOutSubTradeNo string `json:"origin_out_sub_trade_no,omitempty" dc:"OriginOutSubTradeNo 原商户交易流水号 可选，下单时的商户子单请求流水号"`
|
||||
OriginSubTradeNo string `json:"origin_sub_trade_no,omitempty" dc:"OriginSubTradeNo 原拉卡拉子交易流水号 可选，下单成功时，返回的拉卡拉交易子流水"`
|
||||
OriginSubLogNo string `json:"origin_sub_log_no,omitempty" dc:"OriginSubLogNo 原对账单子流水号 可选，原交易的tradeNo的后14位，必须是66开头的"`
|
||||
}
|
||||
@@ -0,0 +1,53 @@
|
||||
package mergerefund
|
||||
|
||||
// ResponseMergeRefund 统一退货响应结构体
|
||||
type ResponseMergeRefund struct {
|
||||
Code string `json:"code" dc:"Code 响应码"`
|
||||
Msg string `json:"msg" dc:"Msg 响应描述"`
|
||||
RespTime string `json:"resp_time" dc:"RespTime 响应时间"`
|
||||
RespData *ResponseDataMergeRefund `json:"resp_data" dc:"RespData 响应数据"`
|
||||
}
|
||||
|
||||
func (r *ResponseMergeRefund) SuccessOrFail() bool {
|
||||
return r.Code == "000000"
|
||||
}
|
||||
|
||||
// ResponseDataMergeRefund 合单退货响应数据结构体
|
||||
type ResponseDataMergeRefund 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 原商户请求流水号 可选，如果请求中携带，则返回"`
|
||||
UpIssAddnData string `json:"up_iss_addn_data,omitempty" dc:"UpIssAddnData 单品营销附加数据 可选，扫码交易，参与单品营销优惠时返回"`
|
||||
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 返回描述信息 必填"`
|
||||
RefundSplitInfo []*RelateOutSplitRspInfo `json:"refund_split_info" dc:"RefundSplitInfo 响应合单域 必填"`
|
||||
}
|
||||
|
||||
// RelateOutSplitRspInfo 响应合单域结构体
|
||||
type RelateOutSplitRspInfo struct {
|
||||
OutSubTradeNo string `json:"out_sub_trade_no" dc:"OutSubTradeNo 外部子退款交易流水号 必填，请求中的商户子流水号"`
|
||||
MerchantNo string `json:"merchant_no" dc:"MerchantNo 商户号 必填，拉卡拉分配的商户号"`
|
||||
TermNo string `json:"term_no" dc:"TermNo 终端号 必填，拉卡拉分配的业务终端号"`
|
||||
TradeState string `json:"trade_state" dc:"TradeState 交易状态 必填，INIT-初始化；SUCCESS-交易成功；FAIL-交易失败；DEAL-交易处理中/未知；PROCESSING-交易已受理；TIMEOUT-超时未知；EXCEPTION-异常"`
|
||||
SubTradeNo string `json:"sub_trade_no" dc:"SubTradeNo 拉卡拉子交易流水号 必填"`
|
||||
SubLogNo string `json:"sub_log_no" dc:"SubLogNo 拉卡拉子对账单流水号 必填"`
|
||||
RefundAmount string `json:"refund_amount" dc:"RefundAmount 申请退款金额 必填，单位分，整数型字符"`
|
||||
PayerAmount string `json:"payer_amount" dc:"PayerAmount 实际退款金额 必填，单位分，整数型字符"`
|
||||
TotalAmount string `json:"total_amount" dc:"TotalAmount 交易金额 必填，单位分，整数型字符"`
|
||||
OriginSubLogNo string `json:"origin_sub_log_no,omitempty" dc:"OriginSubLogNo 原拉卡拉子对账单流水号 可选，如果请求中携带，则返回"`
|
||||
OriginSubTradeNo string `json:"origin_sub_trade_no,omitempty" dc:"OriginSubTradeNo 原拉卡拉子交易流水号 可选，如果请求中携带，则返回"`
|
||||
OriginOutSubTradeNo string `json:"origin_out_sub_trade_no,omitempty" dc:"OriginOutSubTradeNo 原商户子交易流水号 可选，如果请求中携带，则返回"`
|
||||
}
|
||||
Reference in New Issue
Block a user