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

- 在 consts/url.go 中添加分账回退接口地址常量 LKL_SPLIT_LEDGER_FALLBACK_URL - 在 lklsdk/sdk.go 中新增 OrderSplitLedgerFallback 方法用于调用分账回退接口 - 在 lklsdk/split_ledger_more.go 中实现分账回退的具体请求逻辑 - 新建 model/orderSplitLedgerFallback.go 定义分账回退相关的请求与响应结构体 - 实现 OrderSplitLedgerFallbackResponse 的 SuccessOrFail 判断方法
feat(model): 更新余额查询响应结构体字段命名
2025-12-08 10:38:58 +08:00 · 2025-12-08 10:13:15 +08:00 · 2025-12-05 10:22:30 +08:00 · 2025-12-05 10:03:16 +08:00 · 2025-11-14 09:12:04 +08:00 · 2025-11-13 09:23:20 +08:00
8 changed files with 177 additions and 38 deletions
@@ -24,6 +24,8 @@ const (
 	LKL_ACCOUNT_BALANCE_QUERY_URL = "/v2/laep/industry/ewalletBalanceQuery"
 	// LKL_ACCOUNT_WITHDRAW_URL 拉卡拉账户提现
 	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 (
@@ -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)
@@ -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
+}
@@ -23,7 +23,7 @@ type ApplyLedgerMerReqData struct {
 	SplitEntrustFilePath string                 `json:"splitEntrustFilePath"`  // 分账授权委托书文件路径，必传，长度64，调用附件上传接口获取
 	SplitRange           consts.SplitRange      `json:"splitRange"`            // 分账范围，必传，长度32，取值说明：ALL-全部交易分账(所有交易默认都分账)，MARK-标记交易分账(只有带标记交易才分账，其余交易正常结算)
 	SepFundSource        consts.SepFundSource   `json:"sepFundSource"`         // 分账依据，非必传，长度32，取值说明：TRA-交易分账，BAR-金额分账
-	ElecContractId       string                 `json:"elecContractId"`        // 电子合同编号，非必传，长度32，收单已签约交易电子合同编号，供审核人员复核使用
+	EleContractNo        string                 `json:"eleContractNo"`         // 电子合同编号，非必传，长度32，收单已签约交易电子合同编号，供审核人员复核使用
 	SplitLaunchMode      consts.SplitLaunchMode `json:"splitLaunchMode"`       // 分账发起方式，非必传，长度32，取值说明：AUTO-自动触发分账，POINTTRUE-指定规则分账，MANUAL-手动分账
 	SettleType           consts.SplitSettleType `json:"settleType"`            // 结算类型，非必传，长度32，取值说明：01-主扫现结，02-复扫现结，03-交易自动结算
 	SplitRuleSource      consts.SplitRuleSource `json:"splitRuleSource"`       // 分账规则来源，条件必传，长度32，取值说明：MER-商户自定规则，PLATFORM-平台分润规则(分润规则必传)
@@ -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 判断余额查询请求是否成功
@@ -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"
+}
@@ -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"
+}
@@ -5,11 +5,11 @@ package model
 // 包含请求头信息和业务数据
 type QueryLedgerMerRequest struct {
 	// 请求业务数据
-	ReqData *QueryLedgerMerReqData `json:"req_data"`
+	ReqData *QueryLedgerMerReqData `json:"reqData"`
 	// 接口版本号
 	Version string `json:"version"`
 	// 请求时间，格式为yyyyMMddHHmmss
-	ReqTime string `json:"req_time"`
+	ReqTime string `json:"reqTime"`
 }

 // QueryLedgerMerReqData 分账商户查询请求业务数据结构体
@@ -19,13 +19,13 @@ type QueryLedgerMerReqData struct {
 	// 接口版本号，必传，长度8，取值说明：1.0
 	Version string `json:"version"`
 	// 订单编号（便于后续跟踪排查问题及核对报文），必传，长度32，取值说明：14位年月日（24小时制）分秒+8位的随机数（不重复）
-	OrderNo string `json:"order_no"`
+	OrderNo string `json:"orderNo"`
 	// 机构代码，必传，长度32
-	OrgCode string `json:"org_code"`
+	OrgCode string `json:"orgCode"`
 	// 拉卡拉内部商户号，可选，长度32，取值说明：拉卡拉内部商户号和银联商户号必须传一个，都送以内部商户号为准
-	MerInnerNo string `json:"mer_inner_no"`
+	MerInnerNo string `json:"merInnerNo"`
 	// 银联商户号，可选，长度32，取值说明：拉卡拉内部商户号和银联商户号必须传一个，都送以内部商户号为准
-	MerCupNo string `json:"mer_cup_no"`
+	MerCupNo string `json:"merCupNo"`
 }

 // QueryLedgerMerResponse 分账商户查询响应结构体
@@ -33,58 +33,58 @@ type QueryLedgerMerReqData struct {
 // 包含响应状态码、消息和业务数据
 type QueryLedgerMerResponse struct {
 	// 响应状态码，000000表示成功
-	Code string `json:"code"`
+	RetCode string `json:"retCode"`
 	// 响应消息
-	Msg string `json:"msg"`
+	RetMsg string `json:"retMsg"`
 	// 响应业务数据，当code为000000时返回
-	RespData *QueryLedgerMerRespData `json:"resp_data"`
+	RespData *QueryLedgerMerRespData `json:"respData"`
 }

 // QueryLedgerMerRespData 分账商户查询响应业务数据结构体
 // 包含分账商户查询返回的具体业务信息
 type QueryLedgerMerRespData struct {
 	// 分账商户机构号
-	OrgId string `json:"org_id"`
+	OrgId string `json:"orgId"`
 	// 分账商户机构名称
-	OrgName string `json:"org_name"`
+	OrgName string `json:"orgName"`
 	// 拉卡拉内部商户号
-	MerInnerNo string `json:"mer_inner_no"`
+	MerInnerNo string `json:"merInnerNo"`
 	// 银联商户号
-	MerCupNo string `json:"mer_cup_no"`
+	MerCupNo string `json:"merCupNo"`
 	// 最低分账比例（百分比，支持2位精度），取值说明：70或70.50
-	SplitLowestRatio string `json:"split_lowest_ratio"`
+	SplitLowestRatio float64 `json:"splitLowestRatio"`
 	// 商户分账状态，取值说明：VALID启用，INVALID禁用
-	SplitStatus string `json:"split_status"`
+	SplitStatus string `json:"splitStatus"`
 	// 分账范围，取值说明：ALL：全部交易分账(商户所有交易默认待分账)，MARK：标记交易分账(只有带分账标识交易待分账，其余交易正常结算)，默认：MARK
-	SplitRange string `json:"split_range"`
+	SplitRange string `json:"splitRange"`
 	// 分账依据，取值说明：TR或空：交易分账，BA：余额分账，默认：TR交易分账
-	SepFundSource string `json:"sep_fund_source"`
+	SepFundSource string `json:"sepFundSource"`
 	// 平台ID，取值说明：如果商户和绑定平台分账，返回平台ID
-	PlatformId string `json:"platform_id"`
+	PlatformId string `json:"platformId"`
 	// 分账发起方式，取值说明：AUTO：自动规则分账，POINTRULE：指定规则分账，MANUAL：手动规则分账
-	SplitLaunchMode string `json:"split_launch_mode"`
+	SplitLaunchMode string `json:"splitLaunchMode"`
 	// 分账规则来源，取值说明：MER：商户分账规则，PLATFORM：平台分账规则
-	SplitRuleSource string `json:"split_rule_source"`
+	SplitRuleSource string `json:"splitRuleSource"`
 	// 已绑定接收方列表
-	BindRelations []*BindRelation `json:"bind_relations"`
+	BindRelations []*BindRelation `json:"bindRelations"`
 }

 // BindRelation 已绑定接收方信息结构体
 // 用于表示分账商户已绑定的接收方信息
 type BindRelation struct {
 	// 拉卡拉内部商户号
-	MerInnerNo string `json:"mer_inner_no"`
+	MerInnerNo string `json:"merInnerNo"`
 	// 银联商户号
-	MerCupNo string `json:"mer_cup_no"`
+	MerCupNo string `json:"merCupNo"`
 	// 接收方编号
-	ReceiverNo string `json:"receiver_no"`
+	ReceiverNo string `json:"receiverNo"`
 	// 接收方编号名称
-	ReceiverName string `json:"receiver_name"`
+	ReceiverName string `json:"receiverName"`
 }

 // SuccessOrFail 判断分账商户查询请求是否成功
 // 成功条件：响应码为000000
 // 返回值：true表示成功，false表示失败
 func (resp *QueryLedgerMerResponse) SuccessOrFail() bool {
-	return resp.Code == "000000"
+	return resp.RetCode == "000000"
 }
Author	SHA1	Message	Date
gaoda	58068f06af	feat(lklsdk): 新增订单分账回退功能 - 在 consts/url.go 中添加分账回退接口地址常量 LKL_SPLIT_LEDGER_FALLBACK_URL - 在 lklsdk/sdk.go 中新增 OrderSplitLedgerFallback 方法用于调用分账回退接口 - 在 lklsdk/split_ledger_more.go 中实现分账回退的具体请求逻辑 - 新建 model/orderSplitLedgerFallback.go 定义分账回退相关的请求与响应结构体 - 实现 OrderSplitLedgerFallbackResponse 的 SuccessOrFail 判断方法	2025-12-08 10:38:58 +08:00
gaoda	9af7e32aff	feat(model): 更新余额查询响应结构体字段命名 - 将 BalanceQueryResponse 中的 code 字段标签改为 retCode - 将 BalanceQueryResponse 中的 msg 字段标签改为 retMsg - 将 BalanceQueryResponse 中的 resp_data 字段标签改为 respData - 将 BalanceQueryRespData 中的 pay_no 字段标签改为 payNo - 将 BalanceQueryRespData 中的 pay_type 字段标签改为 payType - 将 BalanceQueryRespData 中的 acct_st 字段标签改为 acctSt - 将 BalanceQueryRespData 中的 force_balance 字段标签改为 forceBalance - 将 BalanceQueryRespData 中的 his_balance 字段标签改为 hisBalance - 将 BalanceQueryRespData 中的 re_balance 字段标签改为 reBalance - 将 BalanceQueryRespData 中的 cu_balance 字段标签改为 cuBalance	2025-12-08 10:13:15 +08:00
gaoda	4a46686a68	feat(lklsdk): 新增订单分账结果查询功能 - 在SDK中增加OrderSplitLedgerResultQuery方法 - 重命名SplitLedgerResultQuery为OrderSplitLedgerResultQuery - 更新相关请求和响应结构体名称以匹配新功能 - 调整模型文件名以反映新的功能用途 - 确保接口版本和请求时间字段正确设置 - 维持原有的分账状态和明细数据处理逻辑	2025-12-05 10:22:30 +08:00
gaoda	a7dca57d23	feat(split): 新增分账结果查询接口 - 在 consts/url.go 中新增分账结果查询 URL 常量 - 实现 SplitLedgerService 的 SplitLedgerResultQuery 方法 - 新增 model/splitLedgerResult.go 文件定义相关请求和响应结构体 - 支持通过 separate_no 或 out_separate_no 查询分账结果 - 返回详细的分账状态、金额及明细信息	2025-12-05 10:03:16 +08:00
gaoda	5d502d371a	feat(model): 修改分账最低比例字段类型 - 将 SplitLowestRatio 字段从 string 类型改为 float64 类型 - 提高数值处理的准确性和效率- 支持更精确的分账比例计算- 保持与其他数值字段类型的统一性 - 更新相关数据序列化逻辑以适应新类型- 确保前后端数据传输兼容性	2025-11-14 09:12:04 +08:00
gaoda	6edab2db55	refactor(model): 修改QueryLedgerMerResponse字段名以提高一致性 - 将Code字段重命名为RetCode - 将Msg字段重命名为RetMsg - 更新SuccessOrFail方法中对RetCode的引用 - 保持与其它响应模型结构的一致性- 确保JSON序列化标签同步更新 - 维持原有的业务逻辑判断规则	2025-11-13 09:23:20 +08:00
gaoda	468950e555	feat(model): 更新分账商户查询接口字段命名 - 将 req_data 字段重命名为 reqData - 将 req_time 字段重命名为 reqTime - 将 order_no 字段重命名为 orderNo - 将 org_code 字段重命名为 orgCode - 将 mer_inner_no 字段重命名为 merInnerNo - 将 mer_cup_no 字段重命名为 merCupNo - 将 resp_data 字段重命名为 respData- 将 org_id 字段重命名为 orgId- 将 org_name 字段重命名为 orgName - 将 split_lowest_ratio 字段重命名为 splitLowestRatio- 将 split_status 字段重命名为 splitStatus- 将 split_range 字段重命名为 splitRange- 将 sep_fund_source 字段重命名为 sepFundSource- 将 platform_id 字段重命名为 platformId- 将 split_launch_mode 字段重命名为 splitLaunchMode - 将 split_rule_source 字段重命名为 splitRuleSource - 将 bind_relations 字段重命名为 bindRelations - 将 receiver_no 字段重命名为 receiverNo- 将 receiver_name 字段重命名为 receiverName	2025-11-13 09:10:07 +08:00
gaoda	2f9a46a6d9	fix(model): 修改电子合同编号字段名 - 将 ElecContractId 字段重命名为 EleContractNo - 保持字段注释和长度限制不变 - 确保与其他相关模块的兼容性	2025-11-12 16:57:47 +08:00