feat(lklsdk): 新增订单分账结果查询功能

- 在SDK中增加OrderSplitLedgerResultQuery方法
- 重命名SplitLedgerResultQuery为OrderSplitLedgerResultQuery
- 更新相关请求和响应结构体名称以匹配新功能
- 调整模型文件名以反映新的功能用途
- 确保接口版本和请求时间字段正确设置
- 维持原有的分账状态和明细数据处理逻辑
main v1.0.26
gaoda 2025-12-05 10:22:30 +08:00
parent a7dca57d23
commit 4a46686a68
4 changed files with 56 additions and 51 deletions

View File

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

View File

@ -138,12 +138,12 @@ func (s *SplitLedgerService[T]) OrderSplitLedgerTest(req *model.OrderSplitLedger
return respBody, nil return respBody, nil
} }
func (s *SplitLedgerService[T]) SplitLedgerResultQuery(req *model.SplitLedgerResultQueryReqData) (*T, error) { func (s *SplitLedgerService[T]) OrderSplitLedgerResultQuery(req *model.OrderSplitLedgerResultQueryReqData) (*T, error) {
// 构建请求参数 // 构建请求参数
url := consts.BASE_URL + consts.LKL_SPLIT_LEDGER_RESULT_QUERY_URL url := consts.BASE_URL + consts.LKL_SPLIT_LEDGER_RESULT_QUERY_URL
// 构建BaseModel请求 // 构建BaseModel请求
baseReq := model.SplitLedgerResultQueryRequest{ baseReq := model.OrderSplitLedgerResultQueryRequest{
ReqTime: time.Now().Format("20060102150405"), ReqTime: time.Now().Format("20060102150405"),
Version: "3.0", Version: "3.0",
ReqData: req, ReqData: req,

View File

@ -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"
}

View File

@ -1,49 +0,0 @@
package model
type SplitLedgerResultQueryRequest struct {
ReqData *SplitLedgerResultQueryReqData `json:"req_data"` // 请求业务数据
Version string `json:"version"` // 接口版本号
ReqTime string `json:"req_time"` // 请求时间格式为yyyyMMddHHmmss
}
type SplitLedgerResultQueryReqData 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 SplitLedgerResultQueryResponse 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 []*SplitLedgerResultQueryRespDetailDatas `json:"detail_datas"` // 明细数据
}
}
type SplitLedgerResultQueryRespDetailDatas 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 *SplitLedgerResultQueryResponse) SuccessOrFail() bool {
return s.Code == "SACS0000"
}