feat(lklsdk): 新增订单分账回退功能

- 在 consts/url.go 中添加分账回退接口地址常量 LKL_SPLIT_LEDGER_FALLBACK_URL
- 在 lklsdk/sdk.go 中新增 OrderSplitLedgerFallback 方法用于调用分账回退接口
- 在 lklsdk/split_ledger_more.go 中实现分账回退的具体请求逻辑
- 新建 model/orderSplitLedgerFallback.go 定义分账回退相关的请求与响应结构体
- 实现 OrderSplitLedgerFallbackResponse 的 SuccessOrFail 判断方法

consts/url.go

@@ -23,7 +23,9 @@ const (
 	// LKL_ACCOUNT_BALANCE_QUERY_URL 拉卡拉账户余额查询
 	LKL_ACCOUNT_BALANCE_QUERY_URL = "/v2/laep/industry/ewalletBalanceQuery"
 	// LKL_ACCOUNT_WITHDRAW_URL 拉卡拉账户提现
-	LKL_ACCOUNT_WITHDRAW_URL = "/v2/laep/industry/ewalletWithdrawD1"
+	LKL_ACCOUNT_WITHDRAW_URL          = "/v2/laep/industry/ewalletWithdrawD1"
+	LKL_SPLIT_LEDGER_RESULT_QUERY_URL = "/v3/sacs/query_plus"
+	LKL_SPLIT_LEDGER_FALLBACK_URL     = "/v3/sacs/fallback"
 )
 
 const (

lklsdk/sdk.go

@@ -153,6 +153,16 @@ func (s *SDK[T]) OrderSplitLedgerTest(req *model.OrderSplitLedgerReqData) (*T, e
 	return s.SplitLedger.OrderSplitLedgerTest(req)
 }
 
+// OrderSplitLedgerResultQuery 订单分账结果查询
+func (s *SDK[T]) OrderSplitLedgerResultQuery(req *model.OrderSplitLedgerResultQueryReqData) (*T, error) {
+	return s.SplitLedger.OrderSplitLedgerResultQuery(req)
+}
+
+// OrderSplitLedgerFallback 订单分账回退
+func (s *SDK[T]) OrderSplitLedgerFallback(req *model.OrderSplitLedgerFallbackReqData) (*T, error) {
+	return s.SplitLedger.OrderSplitLedgerFallback(req)
+}
+
 // TradeQuery 交易查询
 func (s *SDK[T]) TradeQuery(req *model.TradeQueryReqData) (*T, error) {
 	return s.Trade.TradeQuery(req)

lklsdk/split_ledger_more.go

@@ -137,3 +137,41 @@ func (s *SplitLedgerService[T]) OrderSplitLedgerTest(req *model.OrderSplitLedger
 	}
 	return respBody, nil
 }
+
+func (s *SplitLedgerService[T]) OrderSplitLedgerResultQuery(req *model.OrderSplitLedgerResultQueryReqData) (*T, error) {
+	// 构建请求参数
+	url := consts.BASE_URL + consts.LKL_SPLIT_LEDGER_RESULT_QUERY_URL
+
+	// 构建BaseModel请求
+	baseReq := model.OrderSplitLedgerResultQueryRequest{
+		ReqTime: time.Now().Format("20060102150405"),
+		Version: "3.0",
+		ReqData: req,
+	}
+
+	// 发送请求
+	respBody, err := s.client.DoRequest(url, baseReq)
+	if err != nil {
+		return nil, err
+	}
+	return respBody, nil
+}
+
+func (s *SplitLedgerService[T]) OrderSplitLedgerFallback(req *model.OrderSplitLedgerFallbackReqData) (*T, error) {
+	// 构建请求参数
+	url := consts.BASE_URL + consts.LKL_SPLIT_LEDGER_FALLBACK_URL
+
+	// 构建BaseModel请求
+	baseReq := model.OrderSplitLedgerFallbackRequest{
+		ReqTime: time.Now().Format("20060102150405"),
+		Version: "3.0",
+		ReqData: req,
+	}
+
+	// 发送请求
+	respBody, err := s.client.DoRequest(url, baseReq)
+	if err != nil {
+		return nil, err
+	}
+	return respBody, nil
+}

model/balanceQuery.go

@@ -35,30 +35,30 @@ type BalanceQueryReqData struct {
 // 包含响应状态码、消息和业务数据
 type BalanceQueryResponse struct {
 	// 响应状态码，000000
-	Code string `json:"code"`
+	Code string `json:"retCode"`
 	// 响应消息
-	Msg string `json:"msg"`
+	Msg string `json:"retMsg"`
 	// 响应业务数据，当code为SACS0000时返回
-	RespData *BalanceQueryRespData `json:"resp_data"`
+	RespData *BalanceQueryRespData `json:"respData"`
 }
 
 // BalanceQueryRespData 余额查询响应业务数据结构体
 // 包含余额查询返回的具体账户信息
 type BalanceQueryRespData struct {
 	// 账号，必传
-	PayNo string `json:"pay_no"`
+	PayNo string `json:"payNo"`
 	// 账户类型，必传
-	PayType string `json:"pay_type"`
+	PayType string `json:"payType"`
 	// 账户状态，必传，取值说明：CLOSE销户，NORMAL正常，FREEZE冻结，STOPAY止付
-	AcctSt string `json:"acct_st"`
+	AcctSt string `json:"acctSt"`
 	// 预付余额（单位元），必传
-	ForceBalance string `json:"force_balance"`
+	ForceBalance string `json:"forceBalance"`
 	// 上日余额（单位元）-该字段已废弃使用，必传
-	HisBalance string `json:"his_balance"`
+	HisBalance string `json:"hisBalance"`
 	// 实时余额（单位元），必传
-	ReBalance string `json:"re_balance"`
+	ReBalance string `json:"reBalance"`
 	// 当前可用余额（单位元），必传
-	CuBalance string `json:"cu_balance"`
+	CuBalance string `json:"cuBalance"`
 }
 
 // SuccessOrFail 判断余额查询请求是否成功

model/orderSplitLedgerFallback.go

@@ -0,0 +1,40 @@
+package model
+
+type OrderSplitLedgerFallbackRequest struct {
+	ReqData *OrderSplitLedgerFallbackReqData `json:"req_data"` // 请求业务数据
+	Version string                           `json:"version"`  // 接口版本号
+	ReqTime string                           `json:"req_time"` // 请求时间，格式为yyyyMMddHHmmss
+}
+
+type OrderSplitLedgerFallbackReqData struct {
+	MerchantNo          string                             `json:"merchant_no"`            // 商户号，必传，长度32
+	OriginSeparateNo    string                             `json:"origin_separate_no"`     // 原分账单号，必传，长度32
+	OutSeparateNo       string                             `json:"out_separate_no"`        // 外部分账单号，必传，长度32
+	OriginOutSeparateNo string                             `json:"origin_out_separate_no"` // 原外部分账单号，必传，长度32
+	FallbackReason      string                             `json:"fallback_reason"`        // 回退原因，必传，长度255
+	TotalAmt            string                             `json:"total_amt"`              // 总金额，必传，长度15
+	OriginRecvDatas     []*OrderSplitLedgerOriginRecvDatas `json:"origin_recv_datas"`      // 原分账接收数据，必传，数组长度1-100
+}
+
+type OrderSplitLedgerOriginRecvDatas struct {
+	RecvNo string `json:"recv_no"` // 原分账接收号，必传，长度32
+	Amt    string `json:"amt"`     // 原分账接收金额，必传，长度15
+}
+
+type OrderSplitLedgerFallbackResponse struct {
+	Msg      string `json:"msg"`       // 消息
+	RespTime string `json:"resp_time"` // 响应时间
+	Code     string `json:"code"`      // 响应码 SACS0000表示成功
+	RespData struct {
+		OutSeparateNo       string `json:"out_separate_no"`        // 外部分账单号，必传，长度32
+		TotalAmt            string `json:"total_amt"`              // 总金额，必传，长度15
+		OriginOutSeparateNo string `json:"origin_out_separate_no"` // 原外部分账单号，必传，长度32
+		OriginSeparateNo    string `json:"origin_separate_no"`     // 原分账单号，必传，长度32
+		Status              string `json:"status"`                 // 状态，必传，长度1
+		SeparateNo          string `json:"separate_no"`            // 分账单号，必传，长度32
+	}
+}
+
+func (s *OrderSplitLedgerFallbackResponse) SuccessOrFail() bool {
+	return s.Code == "SACS0000"
+}

model/orderSplitLedgerResultQuery.go

@@ -0,0 +1,49 @@
+package model
+
+type OrderSplitLedgerResultQueryRequest struct {
+	ReqData *OrderSplitLedgerResultQueryReqData `json:"req_data"` // 请求业务数据
+	Version string                              `json:"version"`  // 接口版本号
+	ReqTime string                              `json:"req_time"` // 请求时间，格式为yyyyMMddHHmmss
+}
+
+type OrderSplitLedgerResultQueryReqData struct {
+	MerchantNo    string `json:"merchant_no"`     // 商户号，必传，长度32
+	SeparateNo    string `json:"separate_no"`     // 分账核心系统返回的分账流水号，入参中的separate_no,out_separate_no至少二选一，优先级: separate_no> out_separate_no
+	OutSeparateNo string `json:"out_separate_no"` // 商户分账指令流水号，入入参中的separate_no,out_separate_no至少二选一，优先级: separate_no> out_separate_no
+}
+
+type OrderSplitLedgerResultQueryResponse struct {
+	Msg      string `json:"msg"`       // 消息
+	RespTime string `json:"resp_time"` // 响应时间
+	Code     string `json:"code"`      // 响应码 SACS0000表示成功
+	RespData struct {
+		SeparateNo        string                                        `json:"separate_no"`         // 分账指令流水号
+		OutSeparateNo     string                                        `json:"out_separate_no"`     // 商户分账指令流水号
+		CmdType           string                                        `json:"cmd_type"`            // 指令类型 SEPARATE：分账 CANCEL：分账撤销 FALLBACK：分账回退
+		LogNo             string                                        `json:"log_no"`              // 拉卡拉对账单流水号
+		LogDate           string                                        `json:"log_date"`            // 交易日期  posp日期，yyyyMMdd，查清结算用
+		CalType           string                                        `json:"cal_type"`            // 分账计算类型 0 按照指定金额。1 按照指定比例，默认 0 （cmd_type为SEPARATE分账指令类型才有值）
+		SeparateDate      string                                        `json:"separate_date"`       // 分账日期
+		FinishDate        string                                        `json:"finish_date"`         // 完成日期
+		TotalAmt          string                                        `json:"total_amt"`           // 发生总金额，单位为分
+		Status            string                                        `json:"status"`              // 分账状态，ACCEPTED:已受理, PROCESSING:处理中, FAIL:失败, SUCCESS:成功, （如果分账指令后有反向操作指令，则原分账指令会变更成以下的状态之一：） CANCELING:撤销中, CANCELED:撤销成功, CANCEL_FAIL:撤销失败, FALLBACKING:回退中, FALLBACK_END:回退结束
+		FinalStatus       string                                        `json:"final_status"`        // 处理状态 ACCEPTED:已受理, PROCESSING:处理中, FAIL:失败, SUCCESS:成功
+		FrontRuleId       string                                        `json:"front_rule_id"`       // 分账前置规则ID
+		ActualSeparateAmt string                                        `json:"actual_separate_amt"` // 实分金额
+		TotalFeeAmt       string                                        `json:"total_fee_amt"`       // 手续费金额
+		AccResultDesc     string                                        `json:"acc_result_desc"`     // 账户处理错误描述
+		DetailDatas       []*OrderSplitLedgerResultQueryRespDetailDatas `json:"detail_datas"`        // 明细数据
+	}
+}
+
+type OrderSplitLedgerResultQueryRespDetailDatas struct {
+	RecvMerchantNo string `json:"recv_merchant_no"` // 接收方商户号
+	RecvNo         string `json:"recv_no"`          // 接收方编号
+	Amt            string `json:"amt"`              // 分账金额
+	ActualAmt      string `json:"actual_amt"`       // 实分金额
+	FeeAmt         string `json:"fee_amt"`          // 手续费金额
+}
+
+func (s *OrderSplitLedgerResultQueryResponse) SuccessOrFail() bool {
+	return s.Code == "SACS0000"
+}