refactor(model):优化分账相关模型结构体字段类型
- 将 ApplyBindReqData 中 Attachments 字段类型改为 []*ApplyBindAttachment- 新增 ApplyBindAttachment 结构体统一附件信息定义 - 将 ApplyLedgerMerReqData 中 Attachments 字段类型改为 []*ApplyBindAttachment- 将 ApplyLedgerReceiver 中 AttachList 字段类型改为 []*ApplyBindAttachment- 将 PreorderResponse 中 ReqData 字段指针化避免拷贝 - 将 ReqData 中 AccRespFields 字段指针化提升性能 - 将 QueryLedgerMerResponse 中 BindRelations 字段类型改为 []*BindRelation - 调整字段注释格式增强可读性- 统一结构体字段命名风格提高一致性menu v1.0.3
maguodong
parent
1e5214abfb
commit
0aa9bc80ec
|
|
@ -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 分账关系绑定响应结构体
|
||||
|
|
|
|||
|
|
@ -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 商户分账业务开通申请响应结构体
|
||||
|
|
|
|||
|
|
@ -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"`
|
||||
}
|
||||
|
|
|
|||
|
|
@ -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 支付通道返回的具体信息
|
||||
|
|
|
|||
|
|
@ -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"
|
||||
}
|
||||
}
|
||||
|
|
|
|||
Loading…
Reference in New Issue