From 0aa9bc80ecd5218bf8cfa2d696172fb706355126 Mon Sep 17 00:00:00 2001 From: maguodong Date: Thu, 9 Oct 2025 17:56:31 +0800 Subject: [PATCH] =?UTF-8?q?refactor(model):=E4=BC=98=E5=8C=96=E5=88=86?= =?UTF-8?q?=E8=B4=A6=E7=9B=B8=E5=85=B3=E6=A8=A1=E5=9E=8B=E7=BB=93=E6=9E=84?= =?UTF-8?q?=E4=BD=93=E5=AD=97=E6=AE=B5=E7=B1=BB=E5=9E=8B?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 将 ApplyBindReqData 中 Attachments 字段类型改为 []*ApplyBindAttachment- 新增 ApplyBindAttachment 结构体统一附件信息定义 - 将 ApplyLedgerMerReqData 中 Attachments 字段类型改为 []*ApplyBindAttachment- 将 ApplyLedgerReceiver 中 AttachList 字段类型改为 []*ApplyBindAttachment- 将 PreorderResponse 中 ReqData 字段指针化避免拷贝 - 将 ReqData 中 AccRespFields 字段指针化提升性能 - 将 QueryLedgerMerResponse 中 BindRelations 字段类型改为 []*BindRelation - 调整字段注释格式增强可读性- 统一结构体字段命名风格提高一致性 --- model/applyBind.go | 30 +++++++++++++++------------- model/applyLedgerMer.go | 38 ++++++++++++++++-------------------- model/applyLedgerReceiver.go | 9 +-------- model/preorder.go | 23 +++++++++++----------- model/queryLedgerMer.go | 4 ++-- 5 files changed, 47 insertions(+), 57 deletions(-) diff --git a/model/applyBind.go b/model/applyBind.go index ccc5e55..668e5ca 100644 --- a/model/applyBind.go +++ b/model/applyBind.go @@ -15,20 +15,22 @@ type ApplyBindRequest struct { // 包含分账关系绑定所需的详细业务参数 type ApplyBindReqData struct { - Version string `json:"version"` // 接口版本号，必传，长度8，取值说明：1.0 - OrderNo string `json:"orderNo"` // 订单编号，必传，长度32，用于后续跟踪排查问题及核对报文，格式为14位年月日(24小时制)分秒+8位随机数（不重复） - OrgCode string `json:"orgCode"` // 分账接收方所属机构代码，必传，长度32 - MerInnerNo string `json:"merInnerNo"` // 分账商户内部商户号，必传，长度32，与MerCupNo选传其一，不能都为空 - MerCupNo string `json:"merCupNo"` // 分账商户银联商户号，必传，长度32，与MerInnerNo选传其一，不能都为空 - ReceiverNo string `json:"receiverNo"` // 分账接收方编号，必传，长度32 - EntrustFileName string `json:"entrustFileName"` // 合作协议附件名称，必传，长度32 - EntrustFilePath string `json:"entrustFilePath"` // 合作协议附件路径，必传，长度32，通过调用附件上传接口获取 - RetUrl string `json:"retUrl"` // 回调通知地址，必传，长度128，审核通过后通知地址 - Attachments []struct { - AttachType string `json:"attachType"` // 附件类型编码，必传，长度32 - AttachName string `json:"attachName"` // 附件名称，必传，长度32 - AttachStorePath string `json:"attachStorePath"` // 附件路径，必传，长度128，通过调用附件上传接口获取 - } `json:"attachments,omitempty"` // 附加资料，可选，集合类型，其他附加资料文件信息 + Version string `json:"version"` // 接口版本号，必传，长度8，取值说明：1.0 + OrderNo string `json:"orderNo"` // 订单编号，必传，长度32，用于后续跟踪排查问题及核对报文，格式为14位年月日(24小时制)分秒+8位随机数（不重复） + OrgCode string `json:"orgCode"` // 分账接收方所属机构代码，必传，长度32 + MerInnerNo string `json:"merInnerNo"` // 分账商户内部商户号，必传，长度32，与MerCupNo选传其一，不能都为空 + MerCupNo string `json:"merCupNo"` // 分账商户银联商户号，必传，长度32，与MerInnerNo选传其一，不能都为空 + ReceiverNo string `json:"receiverNo"` // 分账接收方编号，必传，长度32 + EntrustFileName string `json:"entrustFileName"` // 合作协议附件名称，必传，长度32 + EntrustFilePath string `json:"entrustFilePath"` // 合作协议附件路径，必传，长度32，通过调用附件上传接口获取 + RetUrl string `json:"retUrl"` // 回调通知地址，必传，长度128，审核通过后通知地址 + Attachments []*ApplyBindAttachment `json:"attachments,omitempty"` // 附加资料，可选，集合类型，其他附加资料文件信息 +} + +type ApplyBindAttachment struct { + AttachType string `json:"attachType"` // 附件类型编码，必传，长度32 + AttachName string `json:"attachName"` // 附件名称，必传，长度32 + AttachStorePath string `json:"attachStorePath"` // 附件路径，必传，长度128，通过调用附件上传接口获取 } // ApplyBindResponse 分账关系绑定响应结构体 diff --git a/model/applyLedgerMer.go b/model/applyLedgerMer.go index 03a3f2b..619270a 100644 --- a/model/applyLedgerMer.go +++ b/model/applyLedgerMer.go @@ -10,27 +10,23 @@ type ApplyLedgerMerRequest struct { // ApplyLedgerMerReqData 商户分账业务开通申请请求业务数据结构体 type ApplyLedgerMerReqData struct { - Version string `json:"version"` // 版本号，必传，长度8，取值说明：1.0 - OrderNo string `json:"orderNo"` // 订单编号，必传，长度32，用于后续处理查询及回调通知消息标识，2014年月日时分秒毫秒组成 - OrgCode string `json:"orgCode"` // 机构代码，必传，长度12 - MerInnerNo string `json:"merInnerNo"` // 拉卡拉内部商户号，可选，长度32，拉卡拉内部商户号和银联商户号必须传一个，默认以内部商户号为准 - MerCupNo string `json:"merCupNo"` // 银联商户号，可选，长度32，拉卡拉内部商户号和银联商户号必须传一个，默认以内部商户号为准 - ContactMobile string `json:"contactMobile"` // 联系手机号，必传，长度32 - SplitLowestRatio float64 `json:"splitLowestRatio"` // 最低分账比例，必传，长度12，百分比，支持2位精度，取值范围：70-70.50 - SplitEntrustFileName string `json:"splitEntrustFileName"` // 分账授权委托书文件名称，必传，长度64，文件格式：pdf - SplitEntrustFilePath string `json:"splitEntrustFilePath"` // 分账授权委托书文件路径，必传，长度64，调用附件上传接口获取 - SplitRange string `json:"splitRange"` // 分账范围，必传，长度32，取值说明：ALL-全部交易分账(所有交易默认都分账)，MARK-标记交易分账(只有带标记交易才分账，其余交易正常结算) - SplitFundSource string `json:"splitFundSource"` // 分账依据，非必传，长度32，取值说明：TRA-交易分账，BAR-金额分账 - ElecContractId string `json:"elecContractId"` // 电子合同编号，非必传，长度32，收单已签约交易电子合同编号，供审核人员复核使用 - SplitLaunchMode string `json:"splitLaunchMode"` // 分账发起方式，非必传，长度32，取值说明：AUTO-自动触发分账，POINTTRUE-指定规则分账，MANUAL-手动分账 - SettleType string `json:"settleType"` // 结算类型，非必传，长度32，取值说明：01-主扫现结，02-复扫现结，03-交易自动结算 - SplitRuleSource string `json:"splitRuleSource"` // 分账规则来源，条件必传，长度32，取值说明：MER-商户自定规则，PLATFORM-平台分润规则(分润规则必传) - RetUrl string `json:"retUrl"` // 回调通知地址，必传，长度128，分账申请结果以异步消息或同步返回的方式通知，如需无线路由处理，也可以通过第三方商户信息查询接口确定结算结果 - Attachments []struct { - AttachType string `json:"attachType"` // 附件类型编码，必传，长度32 - AttachName string `json:"attachName"` // 附件名称，必传，长度32 - AttachStorePath string `json:"attachStorePath"` // 附件路径，必传，长度128，调用附件上传接口获取 - } `json:"attachments,omitempty"` // 附加资料，可选，集合，其他需附加的文件信息 + Version string `json:"version"` // 版本号，必传，长度8，取值说明：1.0 + OrderNo string `json:"orderNo"` // 订单编号，必传，长度32，用于后续处理查询及回调通知消息标识，2014年月日时分秒毫秒组成 + OrgCode string `json:"orgCode"` // 机构代码，必传，长度12 + MerInnerNo string `json:"merInnerNo"` // 拉卡拉内部商户号，可选，长度32，拉卡拉内部商户号和银联商户号必须传一个，默认以内部商户号为准 + MerCupNo string `json:"merCupNo"` // 银联商户号，可选，长度32，拉卡拉内部商户号和银联商户号必须传一个，默认以内部商户号为准 + ContactMobile string `json:"contactMobile"` // 联系手机号，必传，长度32 + SplitLowestRatio float64 `json:"splitLowestRatio"` // 最低分账比例，必传，长度12，百分比，支持2位精度，取值范围：70-70.50 + SplitEntrustFileName string `json:"splitEntrustFileName"` // 分账授权委托书文件名称，必传，长度64，文件格式：pdf + SplitEntrustFilePath string `json:"splitEntrustFilePath"` // 分账授权委托书文件路径，必传，长度64，调用附件上传接口获取 + SplitRange string `json:"splitRange"` // 分账范围，必传，长度32，取值说明：ALL-全部交易分账(所有交易默认都分账)，MARK-标记交易分账(只有带标记交易才分账，其余交易正常结算) + SplitFundSource string `json:"splitFundSource"` // 分账依据，非必传，长度32，取值说明：TRA-交易分账，BAR-金额分账 + ElecContractId string `json:"elecContractId"` // 电子合同编号，非必传，长度32，收单已签约交易电子合同编号，供审核人员复核使用 + SplitLaunchMode string `json:"splitLaunchMode"` // 分账发起方式，非必传，长度32，取值说明：AUTO-自动触发分账，POINTTRUE-指定规则分账，MANUAL-手动分账 + SettleType string `json:"settleType"` // 结算类型，非必传，长度32，取值说明：01-主扫现结，02-复扫现结，03-交易自动结算 + SplitRuleSource string `json:"splitRuleSource"` // 分账规则来源，条件必传，长度32，取值说明：MER-商户自定规则，PLATFORM-平台分润规则(分润规则必传) + RetUrl string `json:"retUrl"` // 回调通知地址，必传，长度128，分账申请结果以异步消息或同步返回的方式通知，如需无线路由处理，也可以通过第三方商户信息查询接口确定结算结果 + Attachments []*ApplyBindAttachment `json:"attachments,omitempty"` // 附加资料，可选，集合，其他需附加的文件信息 } // ApplyLedgerMerResponse 商户分账业务开通申请响应结构体 diff --git a/model/applyLedgerReceiver.go b/model/applyLedgerReceiver.go index 900ec52..631e156 100644 --- a/model/applyLedgerReceiver.go +++ b/model/applyLedgerReceiver.go @@ -55,14 +55,7 @@ type ApplyLedgerReceiverReqData struct { // 收款账户清算行行号，必传，长度32，取值说明：参照FBI.N信息查询，仅支持对私结算账户 AcctClearBankCode string `json:"acctClearBankCode"` // 接收方附件资料，可选，集合 - AttachList []struct { - // 附件名称，可选，长度32 - AttachName string `json:"attachName"` - // 附件路径，可选，长度32，取值说明：（调用进件附件上传接口获取到附件路径） - AttachStorePath string `json:"attachStorePath"` - // 附件类型编码，可选，长度32 - AttachType string `json:"attachType"` - } `json:"attachList"` + AttachList []*ApplyBindAttachment `json:"attachList"` // 提款类型，可选，长度32，取值说明：01：主动提款，03：交易自动结算，不填默认01 SettleType string `json:"settleType"` } diff --git a/model/preorder.go b/model/preorder.go index 41ea4ac..8151601 100644 --- a/model/preorder.go +++ b/model/preorder.go @@ -35,22 +35,21 @@ func NewPreorder(param *PreorderReqData) *Preorder { // PreorderResponse 预下单响应结构体 type PreorderResponse struct { - Code string `json:"code"` // 响应码，BBS00000表示成功 - Msg string `json:"msg"` // 响应信息，对响应码的文字描述 - ReqData ReqData `json:"resp_data"` // 响应业务数据 - RespTime string `json:"resp_time"` // 响应时间 + Code string `json:"code"` // 响应码，BBS00000表示成功 + Msg string `json:"msg"` // 响应信息，对响应码的文字描述 + ReqData *ReqData `json:"resp_data"` // 响应业务数据 + RespTime string `json:"resp_time"` // 响应时间 } // ReqData 响应业务数据 type ReqData struct { - MerchantNo string `json:"merchant_no"` // 商户号 - OutTradeNo string `json:"out_trade_no"` // 外部订单号（商户订单号） - TradeNo string `json:"trade_no"` // 交易号，拉卡拉生成的订单号 - LogNo string `json:"log_no"` // 拉卡拉对账单流水号 - SettleMerchantNo string `json:"settle_merchant_no"` // 结算商户号 - SettleTermNo string `json:"settle_term_no"` // 结算终端号 - AccRespFields WxPreorderResponse `json:"acc_resp_fields"` // 支付通道返回的具体信息 - + MerchantNo string `json:"merchant_no"` // 商户号 + OutTradeNo string `json:"out_trade_no"` // 外部订单号（商户订单号） + TradeNo string `json:"trade_no"` // 交易号，拉卡拉生成的订单号 + LogNo string `json:"log_no"` // 拉卡拉对账单流水号 + SettleMerchantNo string `json:"settle_merchant_no"` // 结算商户号 + SettleTermNo string `json:"settle_term_no"` // 结算终端号 + AccRespFields *WxPreorderResponse `json:"acc_resp_fields"` // 支付通道返回的具体信息 } // WxPreorderResponse 支付通道返回的具体信息 diff --git a/model/queryLedgerMer.go b/model/queryLedgerMer.go index a1b388d..cc67217 100644 --- a/model/queryLedgerMer.go +++ b/model/queryLedgerMer.go @@ -66,7 +66,7 @@ type QueryLedgerMerRespData struct { // 分账规则来源，取值说明：MER：商户分账规则，PLATFORM：平台分账规则 SplitRuleSource string `json:"split_rule_source"` // 已绑定接收方列表 - BindRelations []BindRelation `json:"bind_relations"` + BindRelations []*BindRelation `json:"bind_relations"` } // BindRelation 已绑定接收方信息结构体 @@ -87,4 +87,4 @@ type BindRelation struct { // 返回值：true表示成功，false表示失败 func (resp *QueryLedgerMerResponse) SuccessOrFail() bool { return resp.Code == "000000" -} \ No newline at end of file +}