Compare commits

..
3 Commits
Author SHA1 Message Date
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
4 changed files with 74 additions and 5 deletions
+2 -1
View File
@@ -23,7 +23,8 @@ 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"
)
const (
+19
View File
@@ -137,3 +137,22 @@ func (s *SplitLedgerService[T]) OrderSplitLedgerTest(req *model.OrderSplitLedger
}
return respBody, nil
}
func (s *SplitLedgerService[T]) SplitLedgerResultQuery(req *model.SplitLedgerResultQueryReqData) (*T, error) {
// 构建请求参数
url := consts.BASE_URL + consts.LKL_SPLIT_LEDGER_RESULT_QUERY_URL
// 构建BaseModel请求
baseReq := model.SplitLedgerResultQueryRequest{
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
}
+4 -4
View File
@@ -33,9 +33,9 @@ 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:"respData"`
}
@@ -52,7 +52,7 @@ type QueryLedgerMerRespData struct {
// 银联商户号
MerCupNo string `json:"merCupNo"`
// 最低分账比例(百分比,支持2位精度),取值说明:70或70.50
SplitLowestRatio string `json:"splitLowestRatio"`
SplitLowestRatio float64 `json:"splitLowestRatio"`
// 商户分账状态,取值说明:VALID启用,INVALID禁用
SplitStatus string `json:"splitStatus"`
// 分账范围,取值说明:ALL:全部交易分账(商户所有交易默认待分账),MARK:标记交易分账(只有带分账标识交易待分账,其余交易正常结算),默认:MARK
@@ -86,5 +86,5 @@ type BindRelation struct {
// 成功条件:响应码为000000
// 返回值:true表示成功,false表示失败
func (resp *QueryLedgerMerResponse) SuccessOrFail() bool {
return resp.Code == "000000"
return resp.RetCode == "000000"
}
+49
View File
@@ -0,0 +1,49 @@
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"
}