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 {
|
type ApplyBindReqData struct {
|
||||||
Version string `json:"version"` // 接口版本号，必传，长度8，取值说明：1.0
|
Version string `json:"version"` // 接口版本号，必传，长度8，取值说明：1.0
|
||||||
OrderNo string `json:"orderNo"` // 订单编号，必传，长度32，用于后续跟踪排查问题及核对报文，格式为14位年月日(24小时制)分秒+8位随机数（不重复）
|
OrderNo string `json:"orderNo"` // 订单编号，必传，长度32，用于后续跟踪排查问题及核对报文，格式为14位年月日(24小时制)分秒+8位随机数（不重复）
|
||||||
OrgCode string `json:"orgCode"` // 分账接收方所属机构代码，必传，长度32
|
OrgCode string `json:"orgCode"` // 分账接收方所属机构代码，必传，长度32
|
||||||
MerInnerNo string `json:"merInnerNo"` // 分账商户内部商户号，必传，长度32，与MerCupNo选传其一，不能都为空
|
MerInnerNo string `json:"merInnerNo"` // 分账商户内部商户号，必传，长度32，与MerCupNo选传其一，不能都为空
|
||||||
MerCupNo string `json:"merCupNo"` // 分账商户银联商户号，必传，长度32，与MerInnerNo选传其一，不能都为空
|
MerCupNo string `json:"merCupNo"` // 分账商户银联商户号，必传，长度32，与MerInnerNo选传其一，不能都为空
|
||||||
ReceiverNo string `json:"receiverNo"` // 分账接收方编号，必传，长度32
|
ReceiverNo string `json:"receiverNo"` // 分账接收方编号，必传，长度32
|
||||||
EntrustFileName string `json:"entrustFileName"` // 合作协议附件名称，必传，长度32
|
EntrustFileName string `json:"entrustFileName"` // 合作协议附件名称，必传，长度32
|
||||||
EntrustFilePath string `json:"entrustFilePath"` // 合作协议附件路径，必传，长度32，通过调用附件上传接口获取
|
EntrustFilePath string `json:"entrustFilePath"` // 合作协议附件路径，必传，长度32，通过调用附件上传接口获取
|
||||||
RetUrl string `json:"retUrl"` // 回调通知地址，必传，长度128，审核通过后通知地址
|
RetUrl string `json:"retUrl"` // 回调通知地址，必传，长度128，审核通过后通知地址
|
||||||
Attachments []struct {
|
Attachments []*ApplyBindAttachment `json:"attachments,omitempty"` // 附加资料，可选，集合类型，其他附加资料文件信息
|
||||||
AttachType string `json:"attachType"` // 附件类型编码，必传，长度32
|
}
|
||||||
AttachName string `json:"attachName"` // 附件名称，必传，长度32
|
|
||||||
AttachStorePath string `json:"attachStorePath"` // 附件路径，必传，长度128，通过调用附件上传接口获取
|
type ApplyBindAttachment struct {
|
||||||
} `json:"attachments,omitempty"` // 附加资料，可选，集合类型，其他附加资料文件信息
|
AttachType string `json:"attachType"` // 附件类型编码，必传，长度32
|
||||||
|
AttachName string `json:"attachName"` // 附件名称，必传，长度32
|
||||||
|
AttachStorePath string `json:"attachStorePath"` // 附件路径，必传，长度128，通过调用附件上传接口获取
|
||||||
}
|
}
|
||||||
|
|
||||||
// ApplyBindResponse 分账关系绑定响应结构体
|
// ApplyBindResponse 分账关系绑定响应结构体
|
||||||
|
|
|
||||||
|
|
@ -10,27 +10,23 @@ type ApplyLedgerMerRequest struct {
|
||||||
|
|
||||||
// ApplyLedgerMerReqData 商户分账业务开通申请请求业务数据结构体
|
// ApplyLedgerMerReqData 商户分账业务开通申请请求业务数据结构体
|
||||||
type ApplyLedgerMerReqData struct {
|
type ApplyLedgerMerReqData struct {
|
||||||
Version string `json:"version"` // 版本号，必传，长度8，取值说明：1.0
|
Version string `json:"version"` // 版本号，必传，长度8，取值说明：1.0
|
||||||
OrderNo string `json:"orderNo"` // 订单编号，必传，长度32，用于后续处理查询及回调通知消息标识，2014年月日时分秒毫秒组成
|
OrderNo string `json:"orderNo"` // 订单编号，必传，长度32，用于后续处理查询及回调通知消息标识，2014年月日时分秒毫秒组成
|
||||||
OrgCode string `json:"orgCode"` // 机构代码，必传，长度12
|
OrgCode string `json:"orgCode"` // 机构代码，必传，长度12
|
||||||
MerInnerNo string `json:"merInnerNo"` // 拉卡拉内部商户号，可选，长度32，拉卡拉内部商户号和银联商户号必须传一个，默认以内部商户号为准
|
MerInnerNo string `json:"merInnerNo"` // 拉卡拉内部商户号，可选，长度32，拉卡拉内部商户号和银联商户号必须传一个，默认以内部商户号为准
|
||||||
MerCupNo string `json:"merCupNo"` // 银联商户号，可选，长度32，拉卡拉内部商户号和银联商户号必须传一个，默认以内部商户号为准
|
MerCupNo string `json:"merCupNo"` // 银联商户号，可选，长度32，拉卡拉内部商户号和银联商户号必须传一个，默认以内部商户号为准
|
||||||
ContactMobile string `json:"contactMobile"` // 联系手机号，必传，长度32
|
ContactMobile string `json:"contactMobile"` // 联系手机号，必传，长度32
|
||||||
SplitLowestRatio float64 `json:"splitLowestRatio"` // 最低分账比例，必传，长度12，百分比，支持2位精度，取值范围：70-70.50
|
SplitLowestRatio float64 `json:"splitLowestRatio"` // 最低分账比例，必传，长度12，百分比，支持2位精度，取值范围：70-70.50
|
||||||
SplitEntrustFileName string `json:"splitEntrustFileName"` // 分账授权委托书文件名称，必传，长度64，文件格式：pdf
|
SplitEntrustFileName string `json:"splitEntrustFileName"` // 分账授权委托书文件名称，必传，长度64，文件格式：pdf
|
||||||
SplitEntrustFilePath string `json:"splitEntrustFilePath"` // 分账授权委托书文件路径，必传，长度64，调用附件上传接口获取
|
SplitEntrustFilePath string `json:"splitEntrustFilePath"` // 分账授权委托书文件路径，必传，长度64，调用附件上传接口获取
|
||||||
SplitRange string `json:"splitRange"` // 分账范围，必传，长度32，取值说明：ALL-全部交易分账(所有交易默认都分账)，MARK-标记交易分账(只有带标记交易才分账，其余交易正常结算)
|
SplitRange string `json:"splitRange"` // 分账范围，必传，长度32，取值说明：ALL-全部交易分账(所有交易默认都分账)，MARK-标记交易分账(只有带标记交易才分账，其余交易正常结算)
|
||||||
SplitFundSource string `json:"splitFundSource"` // 分账依据，非必传，长度32，取值说明：TRA-交易分账，BAR-金额分账
|
SplitFundSource string `json:"splitFundSource"` // 分账依据，非必传，长度32，取值说明：TRA-交易分账，BAR-金额分账
|
||||||
ElecContractId string `json:"elecContractId"` // 电子合同编号，非必传，长度32，收单已签约交易电子合同编号，供审核人员复核使用
|
ElecContractId string `json:"elecContractId"` // 电子合同编号，非必传，长度32，收单已签约交易电子合同编号，供审核人员复核使用
|
||||||
SplitLaunchMode string `json:"splitLaunchMode"` // 分账发起方式，非必传，长度32，取值说明：AUTO-自动触发分账，POINTTRUE-指定规则分账，MANUAL-手动分账
|
SplitLaunchMode string `json:"splitLaunchMode"` // 分账发起方式，非必传，长度32，取值说明：AUTO-自动触发分账，POINTTRUE-指定规则分账，MANUAL-手动分账
|
||||||
SettleType string `json:"settleType"` // 结算类型，非必传，长度32，取值说明：01-主扫现结，02-复扫现结，03-交易自动结算
|
SettleType string `json:"settleType"` // 结算类型，非必传，长度32，取值说明：01-主扫现结，02-复扫现结，03-交易自动结算
|
||||||
SplitRuleSource string `json:"splitRuleSource"` // 分账规则来源，条件必传，长度32，取值说明：MER-商户自定规则，PLATFORM-平台分润规则(分润规则必传)
|
SplitRuleSource string `json:"splitRuleSource"` // 分账规则来源，条件必传，长度32，取值说明：MER-商户自定规则，PLATFORM-平台分润规则(分润规则必传)
|
||||||
RetUrl string `json:"retUrl"` // 回调通知地址，必传，长度128，分账申请结果以异步消息或同步返回的方式通知，如需无线路由处理，也可以通过第三方商户信息查询接口确定结算结果
|
RetUrl string `json:"retUrl"` // 回调通知地址，必传，长度128，分账申请结果以异步消息或同步返回的方式通知，如需无线路由处理，也可以通过第三方商户信息查询接口确定结算结果
|
||||||
Attachments []struct {
|
Attachments []*ApplyBindAttachment `json:"attachments,omitempty"` // 附加资料，可选，集合，其他需附加的文件信息
|
||||||
AttachType string `json:"attachType"` // 附件类型编码，必传，长度32
|
|
||||||
AttachName string `json:"attachName"` // 附件名称，必传，长度32
|
|
||||||
AttachStorePath string `json:"attachStorePath"` // 附件路径，必传，长度128，调用附件上传接口获取
|
|
||||||
} `json:"attachments,omitempty"` // 附加资料，可选，集合，其他需附加的文件信息
|
|
||||||
}
|
}
|
||||||
|
|
||||||
// ApplyLedgerMerResponse 商户分账业务开通申请响应结构体
|
// ApplyLedgerMerResponse 商户分账业务开通申请响应结构体
|
||||||
|
|
|
||||||
|
|
@ -55,14 +55,7 @@ type ApplyLedgerReceiverReqData struct {
|
||||||
// 收款账户清算行行号，必传，长度32，取值说明：参照FBI.N信息查询，仅支持对私结算账户
|
// 收款账户清算行行号，必传，长度32，取值说明：参照FBI.N信息查询，仅支持对私结算账户
|
||||||
AcctClearBankCode string `json:"acctClearBankCode"`
|
AcctClearBankCode string `json:"acctClearBankCode"`
|
||||||
// 接收方附件资料，可选，集合
|
// 接收方附件资料，可选，集合
|
||||||
AttachList []struct {
|
AttachList []*ApplyBindAttachment `json:"attachList"`
|
||||||
// 附件名称，可选，长度32
|
|
||||||
AttachName string `json:"attachName"`
|
|
||||||
// 附件路径，可选，长度32，取值说明：（调用进件附件上传接口获取到附件路径）
|
|
||||||
AttachStorePath string `json:"attachStorePath"`
|
|
||||||
// 附件类型编码，可选，长度32
|
|
||||||
AttachType string `json:"attachType"`
|
|
||||||
} `json:"attachList"`
|
|
||||||
// 提款类型，可选，长度32，取值说明：01：主动提款，03：交易自动结算，不填默认01
|
// 提款类型，可选，长度32，取值说明：01：主动提款，03：交易自动结算，不填默认01
|
||||||
SettleType string `json:"settleType"`
|
SettleType string `json:"settleType"`
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -35,22 +35,21 @@ func NewPreorder(param *PreorderReqData) *Preorder {
|
||||||
|
|
||||||
// PreorderResponse 预下单响应结构体
|
// PreorderResponse 预下单响应结构体
|
||||||
type PreorderResponse struct {
|
type PreorderResponse struct {
|
||||||
Code string `json:"code"` // 响应码，BBS00000表示成功
|
Code string `json:"code"` // 响应码，BBS00000表示成功
|
||||||
Msg string `json:"msg"` // 响应信息，对响应码的文字描述
|
Msg string `json:"msg"` // 响应信息，对响应码的文字描述
|
||||||
ReqData ReqData `json:"resp_data"` // 响应业务数据
|
ReqData *ReqData `json:"resp_data"` // 响应业务数据
|
||||||
RespTime string `json:"resp_time"` // 响应时间
|
RespTime string `json:"resp_time"` // 响应时间
|
||||||
}
|
}
|
||||||
|
|
||||||
// ReqData 响应业务数据
|
// ReqData 响应业务数据
|
||||||
type ReqData struct {
|
type ReqData struct {
|
||||||
MerchantNo string `json:"merchant_no"` // 商户号
|
MerchantNo string `json:"merchant_no"` // 商户号
|
||||||
OutTradeNo string `json:"out_trade_no"` // 外部订单号（商户订单号）
|
OutTradeNo string `json:"out_trade_no"` // 外部订单号（商户订单号）
|
||||||
TradeNo string `json:"trade_no"` // 交易号，拉卡拉生成的订单号
|
TradeNo string `json:"trade_no"` // 交易号，拉卡拉生成的订单号
|
||||||
LogNo string `json:"log_no"` // 拉卡拉对账单流水号
|
LogNo string `json:"log_no"` // 拉卡拉对账单流水号
|
||||||
SettleMerchantNo string `json:"settle_merchant_no"` // 结算商户号
|
SettleMerchantNo string `json:"settle_merchant_no"` // 结算商户号
|
||||||
SettleTermNo string `json:"settle_term_no"` // 结算终端号
|
SettleTermNo string `json:"settle_term_no"` // 结算终端号
|
||||||
AccRespFields WxPreorderResponse `json:"acc_resp_fields"` // 支付通道返回的具体信息
|
AccRespFields *WxPreorderResponse `json:"acc_resp_fields"` // 支付通道返回的具体信息
|
||||||
|
|
||||||
}
|
}
|
||||||
|
|
||||||
// WxPreorderResponse 支付通道返回的具体信息
|
// WxPreorderResponse 支付通道返回的具体信息
|
||||||
|
|
|
||||||
|
|
@ -66,7 +66,7 @@ type QueryLedgerMerRespData struct {
|
||||||
// 分账规则来源，取值说明：MER：商户分账规则，PLATFORM：平台分账规则
|
// 分账规则来源，取值说明：MER：商户分账规则，PLATFORM：平台分账规则
|
||||||
SplitRuleSource string `json:"split_rule_source"`
|
SplitRuleSource string `json:"split_rule_source"`
|
||||||
// 已绑定接收方列表
|
// 已绑定接收方列表
|
||||||
BindRelations []BindRelation `json:"bind_relations"`
|
BindRelations []*BindRelation `json:"bind_relations"`
|
||||||
}
|
}
|
||||||
|
|
||||||
// BindRelation 已绑定接收方信息结构体
|
// BindRelation 已绑定接收方信息结构体
|
||||||
|
|
@ -87,4 +87,4 @@ type BindRelation struct {
|
||||||
// 返回值：true表示成功，false表示失败
|
// 返回值：true表示成功，false表示失败
|
||||||
func (resp *QueryLedgerMerResponse) SuccessOrFail() bool {
|
func (resp *QueryLedgerMerResponse) SuccessOrFail() bool {
|
||||||
return resp.Code == "000000"
|
return resp.Code == "000000"
|
||||||
}
|
}
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue