Compare commits

..
2 Commits
Author SHA1 Message Date
maguodong 5824ed7eef 引入账户相关常量和类型定义
- 新增附件类型(AttType)常量定义,包括身份证、银行卡、营业执照等16种类型
- 新增分账范围(SplitRange)常量,支持全部交易分账和标记交易分账
- 新增分账资金来源(SepFundSource)常量,区分交易分账和余额分账
- 新增分账发起模式(SplitLaunchMode)常量,支持自动、规则指定和手动分账
- 新增分账结算类型(SplitSettleType)常量,支持主扫现结和交易自动结算
- 新增分账规则来源(SplitRuleSource)常量,区分商户规则和平台规则
- 新增账户类型码(AcctTypeCode)常量,支持对公和对私账户- 新增账户证件类型(AcctCertificateType)常量,支持身份证、护照等多种证件
- 新增分账计算类型(CalType)常量,支持固定金额和比例分账
- 新增支付类型(PayType)常量,支持收款、付款、分账等6种账户类型
- 修改ApplyBindAttachment.AttachType类型为consts.AttType
- 修改ApplyLedgerMerRequest.SplitRange类型为consts.SplitRange
- 修改ApplyLedgerMerRequest.SepFundSource类型为consts.SepFundSource- 修改ApplyLedgerMerRequest.SplitLaunchMode类型为consts.SplitLaunchMode
- 修改ApplyLedgerMerRequest.SettleType类型为consts.SplitSettleType- 修改ApplyLedgerMerRequest.SplitRuleSource类型为consts.SplitRuleSource- 修改ApplyLedgerReceiverRequest.AcctTypeCode类型为consts.AcctTypeCode
- 修改BalanceQueryRequest.PayType类型为consts.PayType
- 修改MergePreorderReqData.AccountType类型为consts.AccountType
- 修改MergePreorderReqData.TransType类型为consts.TransType
- 修改PreorderReqData.AccountType类型为consts.AccountType
- 修改PreorderReqData.TransType类型为consts.TransType
- 修改PreorderReqData.SettleType类型为consts.SettleType
- 修改RefundReqData.RefundAccMode类型为consts.RefundAccMode
- 修改RefundReqData.RefundAmtSts类型为consts.RefundAmtSts
- 新增AccountType常量定义,支持微信、支付宝、银联等10种账户类型
- 新增TransType常量定义,支持NATIVE、JSAPI、小程序等4种接入方式
- 新增SettleType常量定义,支持常规结算和分账通结算- 新增RefundAccMode常量定义,支持4种退款账户模式
- 新增RefundAmtSts常量定义,支持分账前后退款状态区分
2025-10-10 14:47:25 +08:00
maguodong 0aa9bc80ec refactor(model):优化分账相关模型结构体字段类型
- 将 ApplyBindReqData 中 Attachments 字段类型改为 []*ApplyBindAttachment- 新增 ApplyBindAttachment 结构体统一附件信息定义
- 将 ApplyLedgerMerReqData 中 Attachments 字段类型改为 []*ApplyBindAttachment- 将 ApplyLedgerReceiver 中 AttachList 字段类型改为 []*ApplyBindAttachment- 将 PreorderResponse 中 ReqData 字段指针化避免拷贝
- 将 ReqData 中 AccRespFields 字段指针化提升性能
- 将 QueryLedgerMerResponse 中 BindRelations 字段类型改为 []*BindRelation
- 调整字段注释格式增强可读性- 统一结构体字段命名风格提高一致性
2025-10-09 17:56:31 +08:00
14 changed files with 383 additions and 165 deletions
+134
View File
@@ -0,0 +1,134 @@
package consts
type AttType string
const (
ATT_TYPE_FR_ID_CARD_FRONT AttType = "FR_ID_CARD_FRONT" // 法人身份证正面
ATT_TYPE_FR_ID_CARD_BEHIND AttType = "FR_ID_CARD_BEHIND" // 法人身份证反面
ATT_TYPE_ID_CARD_FRONT AttType = "ID_CARD_FRONT" // 结算人身份证正面
ATT_TYPE_ID_CARD_BEHIND AttType = "ID_CARD_BEHIND" // 结算人身份证反面
ATT_TYPE_BANK_CARD AttType = "BANK_CARD" // 银行卡
ATT_TYPE_BUSINESS_LICENCE AttType = "BUSINESS_LICENCE" // 营业执照
ATT_TYPE_MERCHANT_PHOTO AttType = "MERCHANT_PHOTO" // 商户门头照片
ATT_TYPE_SHOPINNER AttType = "SHOPINNER" // 商铺内部照片
ATT_TYPE_XY AttType = "XY" // 线下纸质协议
ATT_TYPE_NETWORK_XY AttType = "NETWORK_XY" // 电子协议
ATT_TYPE_HT AttType = "HT" // 租赁合同
ATT_TYPE_COOPERATION_QUALIFICATION_PROOF AttType = "COOPERATION_QUALIFICATION_PROOF" // 合作资质证明
ATT_TYPE_FOOD_QUALIFICATION_PROOF AttType = "FOOD_QUALIFICATION_PROOF" // 食品经营相关资质
ATT_TYPE_NO_LEGAL_PERSON_SETT_AUTH_LETTER AttType = "NO_LEGAL_PERSON_SETT_AUTH_LETTER" // 非法人结算授权书
ATT_TYPE_SPLIT_ENTRUST_FILE AttType = "SPLIT_ENTRUST_FILE" // 结算授权委托书
ATT_TYPE_RENTAL_AGREEMENT AttType = "RENTAL_AGREEMENT" // 集市方与场地方间的租赁协议
ATT_TYPE_SPLIT_COOPERATION_FILE AttType = "SPLIT_COOPERATION_FILE" // 集市方与摊主间的合作协议
ATT_TYPE_OTHERS AttType = "OTHERS" // 其他
)
func (at AttType) Ptr() string {
return string(at)
}
type SplitRange string
const (
SPLIT_RANGE_ALL SplitRange = "ALL" // 全部交易分账
SPLIT_RANGE_MARK SplitRange = "MARK" // 标记交易分账
)
func (sr SplitRange) Ptr() string {
return string(sr)
}
type SepFundSource string
const (
SEP_FUND_SOURCE_TR SepFundSource = "TR" // 交易分账
SEP_FUND_SOURCE_BA SepFundSource = "BR" // 余额分账
)
func (sf SepFundSource) Ptr() string {
return string(sf)
}
type SplitLaunchMode string
const (
SPLIT_LAUNCH_MODE_AUTO SplitLaunchMode = "AUTO" // 自动触发分账
SPLIT_LAUNCH_MODE_POINTRULE SplitLaunchMode = "POINTRULE" // 指定规则分账
SPLIT_LAUNCH_MODE_MANUAL SplitLaunchMode = "MANUAL" // 手动分账
)
func (slm SplitLaunchMode) Ptr() string {
return string(slm)
}
type SplitSettleType string
const (
SPLIT_SETTLE_TYPE_01 SplitSettleType = "01" // 主扫现结
SPLIT_SETTLE_TYPE_03 SplitSettleType = "03" // 交易自动结算
)
func (sst SplitSettleType) Ptr() string {
return string(sst)
}
type SplitRuleSource string
const (
SPLIT_RULE_SOURCE_MER SplitRuleSource = "MER" // 商户分账规则
SPLIT_RULE_SOURCE_PLATFORM SplitRuleSource = "PLATFORM" // 平台分账规则
)
func (srs SplitRuleSource) Ptr() string {
return string(srs)
}
type AcctTypeCode string
const (
ACCT_TYPE_CODE_57 AcctTypeCode = "57" // 对公
ACCT_TYPE_CODE_58 AcctTypeCode = "58" // 对私
)
func (act AcctTypeCode) Ptr() string {
return string(act)
}
type AcctCertificateType string
const (
ACCT_CERTIFICATE_TYPE_ID_CARD AcctCertificateType = "17" // 身份证
ACCT_CERTIFICATE_TYPE_PASSPORT AcctCertificateType = "18" // 护照
ACCT_CERTIFICATE_TYPE_HONGKONG_MACAO AcctCertificateType = "19" // 港澳居民来往内地通行证
ACCT_CERTIFICATE_TYPE_TRAVEL AcctCertificateType = "20" // 台湾居民来往内地通行证
)
func (act AcctCertificateType) Ptr() string {
return string(act)
}
type CalType string
const (
CAL_TYPE_0 CalType = "0" // 按固定金额分账
CAL_TYPE_1 CalType = "1" // 按比例分账
)
func (ct CalType) Ptr() string {
return string(ct)
}
type PayType string
const (
PAY_TYPE_01 PayType = "01" // 收款账户
PAY_TYPE_02 PayType = "02" // 付款账户
PAY_TYPE_03 PayType = "03" // 分账商户账户
PAY_TYPE_04 PayType = "04" // 分账接收方账户
PAY_TYPE_05 PayType = "05" // 充值代付账户
PAY_TYPE_06 PayType = "06" // 结算代付账户
)
func (pt PayType) Ptr() string {
return string(pt)
}
+67
View File
@@ -0,0 +1,67 @@
package consts
type AccountType string
const (
ACCOUNT_TYPE_WECHAT AccountType = "WECHAT" // 微信
ACCOUNT_TYPE_ALIPAY AccountType = "ALIPAY" // 支付宝
ACCOUNT_TYPE_UQRCODEPAY AccountType = "UQRCODEPAY" // 银联
ACCOUNT_TYPE_BASTPAY AccountType = "BASTPAY" // 翼支付
ACCOUNT_TYPE_SUNING AccountType = "SUNING" // 苏宁
ACCOUNT_TYPE_LKLACC AccountType = "LKLACC" // 拉卡拉支付账户
ACCOUNT_TYPE_NUCSPAY AccountType = "NUCSPAY" // 网联小钱包
ACCOUNT_TYPE_JD AccountType = "JD"
)
func (at AccountType) Ptr() string {
return string(at)
}
type TransType string
const (
TRANS_TYPE_NATIVE TransType = "41" // NATIVE(ALIPAY, 云闪付支持, 京东白条分期)
TRANS_TYPE_JSAPI TransType = "51" // JSAPI(微信公众号支付, 支付宝服务窗、JS支付, 翼支付JS支付, 拉卡拉钱包支付, 京东白条分期)
TRANS_TYPE_WECHATPAY TransType = "71" // 微信小程序支付
TRANS_TYPE_APP TransType = "61" // APP支付(微信APP支付),String(2)
)
func (tt TransType) Ptr() string {
return string(tt)
}
type SettleType string
const (
SETTLE_TYPE_NORMAL SettleType = "0" // 常规结算
SETTLE_TYPE_SPECIAL SettleType = "1" // 拉卡拉分账通结算
)
func (st SettleType) Ptr() string {
return string(st)
}
type RefundAccMode string
// 00退货账户余额 05商户余额 06终端余额 30终点账户
const (
REFUND_ACC_MODE_USER_BALANCE RefundAccMode = "00" // 退货账户余额
REFUND_ACC_MODE_MERCHANT_BALANCE RefundAccMode = "05" // 商户余额
REFUND_ACC_MODE_TERMINAL_BALANCE RefundAccMode = "06" // 终端余额
REFUND_ACC_MODE_ACCOUNT RefundAccMode = "30" // 终点账户
)
func (rat RefundAccMode) Ptr() string {
return string(rat)
}
type RefundAmtSts string
const (
REFUND_AMT_STS_NORMAL RefundAmtSts = "00" // 分账前
REFUND_AMT_STS_SPLIT RefundAmtSts = "01" // 分账后
)
func (ras RefundAmtSts) Ptr() string {
return string(ras)
}
+7 -3
View File
@@ -1,5 +1,7 @@
package model package model
import "github.com/black1552/lkl_sdk/consts"
// ApplyBindRequest 分账关系绑定请求结构体 // ApplyBindRequest 分账关系绑定请求结构体
// 用于发起分账接收方与商户的关系绑定申请 // 用于发起分账接收方与商户的关系绑定申请
// 拉卡拉SDK接口文档:分账关系绑定接口 // 拉卡拉SDK接口文档:分账关系绑定接口
@@ -24,11 +26,13 @@ type ApplyBindReqData struct {
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 }
type ApplyBindAttachment struct {
AttachType consts.AttType `json:"attachType"` // 附件类型编码,必传,长度32
AttachName string `json:"attachName"` // 附件名称,必传,长度32 AttachName string `json:"attachName"` // 附件名称,必传,长度32
AttachStorePath string `json:"attachStorePath"` // 附件路径,必传,长度128,通过调用附件上传接口获取 AttachStorePath string `json:"attachStorePath"` // 附件路径,必传,长度128,通过调用附件上传接口获取
} `json:"attachments,omitempty"` // 附加资料,可选,集合类型,其他附加资料文件信息
} }
// ApplyBindResponse 分账关系绑定响应结构体 // ApplyBindResponse 分账关系绑定响应结构体
+8 -10
View File
@@ -1,5 +1,7 @@
package model package model
import "github.com/black1552/lkl_sdk/consts"
// ApplyLedgerMerRequest 商户分账业务开通申请请求结构体 // ApplyLedgerMerRequest 商户分账业务开通申请请求结构体
type ApplyLedgerMerRequest struct { type ApplyLedgerMerRequest struct {
ReqData *ApplyLedgerMerReqData `json:"reqData"` // 请求业务数据 ReqData *ApplyLedgerMerReqData `json:"reqData"` // 请求业务数据
@@ -19,18 +21,14 @@ type ApplyLedgerMerReqData struct {
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 consts.SplitRange `json:"splitRange"` // 分账范围,必传,长度32,取值说明:ALL-全部交易分账(所有交易默认都分账),MARK-标记交易分账(只有带标记交易才分账,其余交易正常结算)
SplitFundSource string `json:"splitFundSource"` // 分账依据,非必传,长度32,取值说明:TRA-交易分账,BAR-金额分账 SepFundSource consts.SepFundSource `json:"sepFundSource"` // 分账依据,非必传,长度32,取值说明:TRA-交易分账,BAR-金额分账
ElecContractId string `json:"elecContractId"` // 电子合同编号,非必传,长度32,收单已签约交易电子合同编号,供审核人员复核使用 ElecContractId string `json:"elecContractId"` // 电子合同编号,非必传,长度32,收单已签约交易电子合同编号,供审核人员复核使用
SplitLaunchMode string `json:"splitLaunchMode"` // 分账发起方式,非必传,长度32,取值说明:AUTO-自动触发分账,POINTTRUE-指定规则分账,MANUAL-手动分账 SplitLaunchMode consts.SplitLaunchMode `json:"splitLaunchMode"` // 分账发起方式,非必传,长度32,取值说明:AUTO-自动触发分账,POINTTRUE-指定规则分账,MANUAL-手动分账
SettleType string `json:"settleType"` // 结算类型,非必传,长度32,取值说明:01-主扫现结,02-复扫现结,03-交易自动结算 SettleType consts.SplitSettleType `json:"settleType"` // 结算类型,非必传,长度32,取值说明:01-主扫现结,02-复扫现结,03-交易自动结算
SplitRuleSource string `json:"splitRuleSource"` // 分账规则来源,条件必传,长度32,取值说明:MER-商户自定规则,PLATFORM-平台分润规则(分润规则必传) SplitRuleSource consts.SplitRuleSource `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 商户分账业务开通申请响应结构体
+4 -9
View File
@@ -1,5 +1,7 @@
package model package model
import "github.com/black1552/lkl_sdk/consts"
// ApplyLedgerReceiverRequest 分账接收方创建请求结构体 // ApplyLedgerReceiverRequest 分账接收方创建请求结构体
// 用于向拉卡拉接口发送分账接收方创建请求 // 用于向拉卡拉接口发送分账接收方创建请求
// 包含请求头信息和业务数据 // 包含请求头信息和业务数据
@@ -43,7 +45,7 @@ type ApplyLedgerReceiverReqData struct {
// 收款账户名称,必传,长度32 // 收款账户名称,必传,长度32
AcctName string `json:"acctName"` AcctName string `json:"acctName"`
// 收款账户类型代码,必传,长度32,取值说明:57:对公,58:对私 // 收款账户类型代码,必传,长度32,取值说明:57:对公,58:对私
AcctTypeCode string `json:"acctTypeCode"` AcctTypeCode consts.AcctTypeCode `json:"acctTypeCode"`
// 收款账户证件类型,必传,长度32,取值说明:17身份证,18护照,19港澳居民来往内地通行证,20台湾居民来往内地通行证,身份证外类型先咨询后再使用 // 收款账户证件类型,必传,长度32,取值说明:17身份证,18护照,19港澳居民来往内地通行证,20台湾居民来往内地通行证,身份证外类型先咨询后再使用
AcctCertificateType string `json:"acctCertificateType"` AcctCertificateType string `json:"acctCertificateType"`
// 收款账户证件号,必传,长度32 // 收款账户证件号,必传,长度32
@@ -55,14 +57,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"`
} }
+3 -1
View File
@@ -1,5 +1,7 @@
package model package model
import "github.com/black1552/lkl_sdk/consts"
// BalanceQueryRequest 余额查询请求结构体 // BalanceQueryRequest 余额查询请求结构体
// 用于向拉卡拉接口发送余额查询请求 // 用于向拉卡拉接口发送余额查询请求
// 包含请求头信息和业务数据 // 包含请求头信息和业务数据
@@ -23,7 +25,7 @@ type BalanceQueryReqData struct {
// 账号,若该参数上送,则payType将无效,非必传,最大长度32 // 账号,若该参数上送,则payType将无效,非必传,最大长度32
PayNo string `json:"pay_no"` PayNo string `json:"pay_no"`
// 账号类型(01:收款账户,02:付款账户,03:分账商户账户,04:分账接收方账户,05:充值代付账户,06:结算代付账户)-未上送则默认01,非必传,最大长度32 // 账号类型(01:收款账户,02:付款账户,03:分账商户账户,04:分账接收方账户,05:充值代付账户,06:结算代付账户)-未上送则默认01,非必传,最大长度32
PayType string `json:"pay_type"` PayType consts.PayType `json:"pay_type"`
// 账户标志(01:一般账户;03:虚户)-未上送则默认01,非必传,最大长度32 // 账户标志(01:一般账户;03:虚户)-未上送则默认01,非必传,最大长度32
MgtFlag string `json:"mgt_flag"` MgtFlag string `json:"mgt_flag"`
} }
+6 -3
View File
@@ -1,6 +1,9 @@
package model package model
import "github.com/gogf/gf/v2/os/gtime" import (
"github.com/black1552/lkl_sdk/consts"
"github.com/gogf/gf/v2/os/gtime"
)
// MergePreorder 主扫合单交易请求结构体 // MergePreorder 主扫合单交易请求结构体
type MergePreorder struct { type MergePreorder struct {
@@ -15,8 +18,8 @@ type MergePreorderReqData struct {
TermNo string `json:"term_no"` // 终端号,拉卡拉分配的业务终端号,String(32),必填 TermNo string `json:"term_no"` // 终端号,拉卡拉分配的业务终端号,String(32),必填
OutTradeNo string `json:"out_trade_no"` // 商户交易流水号,商户系统唯一,String(32),必填 OutTradeNo string `json:"out_trade_no"` // 商户交易流水号,商户系统唯一,String(32),必填
OutSplitInfo []*OutSplitInfo `json:"out_split_info"` // 拆单信息,List,必填 OutSplitInfo []*OutSplitInfo `json:"out_split_info"` // 拆单信息,List,必填
AccountType string `json:"account_type"` // 钱包类型,微信:WECHAT 支付宝:ALIPAY 银联:UQRCODEPAY 京东钱包:JD,String(32),必填 AccountType consts.AccountType `json:"account_type"` // 钱包类型,微信:WECHAT 支付宝:ALIPAY 银联:UQRCODEPAY 京东钱包:JD,String(32),必填
TransType string `json:"trans_type"` // 接入方式,41:NATIVE(扫码支付)(仅ALIPAY支持) 51:JSAPI(微信公众号支付,支付宝服务窗支付,银联JS支付,支付宝JS支付、拉卡拉钱包支付)71:微信小程序支付 81:支付宝H5支付(需特殊商户账户端支持),String(2),必填 TransType consts.TransType `json:"trans_type"` // 接入方式,41:NATIVE(扫码支付)(仅ALIPAY支持) 51:JSAPI(微信公众号支付,支付宝服务窗支付,银联JS支付,支付宝JS支付、拉卡拉钱包支付)71:微信小程序支付 81:支付宝H5支付(需特殊商户账户端支持),String(2),必填
TotalAmount string `json:"total_amount"` // 金额,单位分,整数型字符,String(12),必填 TotalAmount string `json:"total_amount"` // 金额,单位分,整数型字符,String(12),必填
LocationInfo *LocationInfo `json:"location_info"` // 地址位置信息,Object,风控要求必送,必填 LocationInfo *LocationInfo `json:"location_info"` // 地址位置信息,Object,风控要求必送,必填
BusiMode string `json:"busi_mode"` // 业务模式,ACQ-收单 PAY-付款不填,默认为"ACQ-收单",String(8),选填 BusiMode string `json:"busi_mode"` // 业务模式,ACQ-收单 PAY-付款不填,默认为"ACQ-收单",String(8),选填
+3 -1
View File
@@ -1,5 +1,7 @@
package model package model
import "github.com/black1552/lkl_sdk/consts"
// OrderSplitLedgerRequest 订单分账请求结构体 // OrderSplitLedgerRequest 订单分账请求结构体
// 用于发起订单分账操作,支持向多个接收方进行分账 // 用于发起订单分账操作,支持向多个接收方进行分账
// 拉卡拉SDK接口文档:订单分账接口 // 拉卡拉SDK接口文档:订单分账接口
@@ -20,7 +22,7 @@ type OrderSplitLedgerReqData struct {
OutSeparateNo string `json:"out_separate_no"` // 商户分账指令流水号,必传,长度32,每个商户号下唯一,否则会校验失败 OutSeparateNo string `json:"out_separate_no"` // 商户分账指令流水号,必传,长度32,每个商户号下唯一,否则会校验失败
TotalAmt string `json:"total_amt"` // 分账总金额,必传,长度15,单位为分 TotalAmt string `json:"total_amt"` // 分账总金额,必传,长度15,单位为分
LklOrgNo string `json:"lkl_org_no"` // 拉卡拉机构编号,条件必传,长度16 LklOrgNo string `json:"lkl_org_no"` // 拉卡拉机构编号,条件必传,长度16
CalType string `json:"cal_type"` // 分账计算类型,条件必传,长度2,取值说明:0-按照指定金额,1-按照指定比例,默认0 CalType consts.CalType `json:"cal_type"` // 分账计算类型,条件必传,长度2,取值说明:0-按照指定金额,1-按照指定比例,默认0
NotifyUrl string `json:"notify_url"` // 回调地址,条件必传,长度128,分账、分账撤销或分账回退时,通过该地址通知商户最终处理结果,不传时不回调 NotifyUrl string `json:"notify_url"` // 回调地址,条件必传,长度128,分账、分账撤销或分账回退时,通过该地址通知商户最终处理结果,不传时不回调
RecvDatas []*OrderSplitLedgerRecvDatas `json:"recv_datas,omitempty"` // 分账接收数据对象,条件必传,列表类型,分账接收方编号必须已创建 RecvDatas []*OrderSplitLedgerRecvDatas `json:"recv_datas,omitempty"` // 分账接收数据对象,条件必传,列表类型,分账接收方编号必须已创建
} }
+9 -6
View File
@@ -1,6 +1,9 @@
package model package model
import "github.com/gogf/gf/v2/os/gtime" import (
"github.com/black1552/lkl_sdk/consts"
"github.com/gogf/gf/v2/os/gtime"
)
// Preorder 预下单请求结构体 // Preorder 预下单请求结构体
type Preorder struct { type Preorder struct {
@@ -14,10 +17,11 @@ type PreorderReqData struct {
MerchantNo string `json:"merchant_no"` // 商户号,拉卡拉分配的商户号,String(32) MerchantNo string `json:"merchant_no"` // 商户号,拉卡拉分配的商户号,String(32)
TermNo string `json:"term_no"` // 终端号,拉卡拉分配的业务终端号,String(32) TermNo string `json:"term_no"` // 终端号,拉卡拉分配的业务终端号,String(32)
OutTradeNo string `json:"out_trade_no"` // 商户交易流水号,商户系统唯一,对应数据库表中外请求流水号,String(32) OutTradeNo string `json:"out_trade_no"` // 商户交易流水号,商户系统唯一,对应数据库表中外请求流水号,String(32)
AccountType string `json:"account_type"` // 钱包类型,微信:WECHAT 支付宝:ALIPAY 银联:UQRCODEPAY 翼支付:BESTPAY 苏宁易付宝:SUNING 拉卡拉支付账户:LKLACC 网联小钱包:NUCSPAY 京东钱包:JD,String(32) AccountType consts.AccountType `json:"account_type"` // 钱包类型,微信:WECHAT 支付宝:ALIPAY 银联:UQRCODEPAY 翼支付:BESTPAY 苏宁易付宝:SUNING 拉卡拉支付账户:LKLACC 网联小钱包:NUCSPAY 京东钱包:JD,String(32)
TransType string `json:"trans_type"` // 接入方式,41:NATIVE(ALIPAY, 云闪付支持, 京东白条分期)51:JSAPI(微信公众号支付, 支付宝服务窗、JS支付, 翼支付JS支付, 拉卡拉钱包支付, 京东白条分期)71:微信小程序支付61:APP支付(微信APP支付),String(2) TransType consts.TransType `json:"trans_type"` // 接入方式,41:NATIVE(ALIPAY, 云闪付支持, 京东白条分期)51:JSAPI(微信公众号支付, 支付宝服务窗、JS支付, 翼支付JS支付, 拉卡拉钱包支付, 京东白条分期)71:微信小程序支付61:APP支付(微信APP支付),String(2)
TotalAmount string `json:"total_amount"` // 金额,单位分,整数型字符,String(12) TotalAmount string `json:"total_amount"` // 金额,单位分,整数型字符,String(12)
NotifyUrl string `json:"notify_url"` // 商户通知地址,商户通知地址,如果上传,且 pay_order_no 不存在情况下,则按此地址通知商户,String(128) NotifyUrl string `json:"notify_url"` // 商户通知地址,商户通知地址,如果上传,且 pay_order_no 不存在情况下,则按此地址通知商户,String(128)
SettleType consts.SettleType `json:"settle_type"` // “0”或者空,常规结算方式,如需接拉卡拉分账通需传“1”,商户未开通分账之前切记不用上送此参数。
LocationInfo struct { LocationInfo struct {
RequestIp string `json:"request_ip"` // 请求方IP地址,存在必填,格式如36.45.36.95,String(64) RequestIp string `json:"request_ip"` // 请求方IP地址,存在必填,格式如36.45.36.95,String(64)
Location string `json:"location"` // 纬度,经度,商户终端的地理位置,银联二维码交易必填,整体格式:纬度,经度,+表示北纬、东经,-表示南纬、西经。经度格式:1位正负号+3位整数+1位小数点+5位小数;纬度格式:1位正负号+2位整数+1位小数点+6位小数;举例:+31.221345,+121.12345,String(32) Location string `json:"location"` // 纬度,经度,商户终端的地理位置,银联二维码交易必填,整体格式:纬度,经度,+表示北纬、东经,-表示南纬、西经。经度格式:1位正负号+3位整数+1位小数点+5位小数;纬度格式:1位正负号+2位整数+1位小数点+6位小数;举例:+31.221345,+121.12345,String(32)
@@ -37,7 +41,7 @@ func NewPreorder(param *PreorderReqData) *Preorder {
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"` // 响应时间
} }
@@ -49,8 +53,7 @@ type ReqData struct {
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 支付通道返回的具体信息
+1 -1
View File
@@ -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 已绑定接收方信息结构体
+6 -2
View File
@@ -1,6 +1,9 @@
package model package model
import "github.com/gogf/gf/v2/os/gtime" import (
"github.com/black1552/lkl_sdk/consts"
"github.com/gogf/gf/v2/os/gtime"
)
// Refund 退款请求结构体 // Refund 退款请求结构体
type Refund struct { type Refund struct {
@@ -15,11 +18,12 @@ type RefundReqData struct {
TermNo string `json:"term_no"` // 终端号,拉卡拉分配的业务终端号,String(32),必填 TermNo string `json:"term_no"` // 终端号,拉卡拉分配的业务终端号,String(32),必填
OutTradeNo string `json:"out_trade_no"` // 商户请求流水号,商户系统唯一,String(32),必填 OutTradeNo string `json:"out_trade_no"` // 商户请求流水号,商户系统唯一,String(32),必填
RefundAmount string `json:"refund_amount"` // 退款金额,单位分,整数型字符,String(12),必填 RefundAmount string `json:"refund_amount"` // 退款金额,单位分,整数型字符,String(12),必填
RefundAccMode string `json:"refund_acc_mode"` // 退款账户模式,String(2),必填,00-调用户余额 65-调商户余额 66-调终端余额 30-调账户 RefundAccMode consts.RefundAccMode `json:"refund_acc_mode"` // 退款账户模式,String(2),必填,00-调用户余额 65-调商户余额 66-调终端余额 30-调账户
LocationInfo struct { LocationInfo struct {
RequestIp string `json:"request_ip"` // 请求方IP地址,请求方的IP地址,存在必填,格式如36.45.36.95,String(64),必填 RequestIp string `json:"request_ip"` // 请求方IP地址,请求方的IP地址,存在必填,格式如36.45.36.95,String(64),必填
} `json:"location_info"` // 地址位置信息,Object,必填 } `json:"location_info"` // 地址位置信息,Object,必填
NotifyUrl string `json:"notify_url"` // 后台通知地址,交易结果通知地址,String(128),选填 NotifyUrl string `json:"notify_url"` // 后台通知地址,交易结果通知地址,String(128),选填
RefundAmtSts consts.RefundAmtSts `json:"refund_amt_sts"` // 退货资金状态 String(2) 00-为默认,01-为分账;分账交易退款必须填写
OriginLogNo string `json:"origin_log_no"` // 拉卡拉对账单流水号,正常退款的拉卡拉对账单流水号,String(14),选填 OriginLogNo string `json:"origin_log_no"` // 拉卡拉对账单流水号,正常退款的拉卡拉对账单流水号,String(14),选填
OriginOutTradeNo string `json:"origin_out_trade_no"` // 原始交易商户流水号,String(32),选填 OriginOutTradeNo string `json:"origin_out_trade_no"` // 原始交易商户流水号,String(32),选填
OriginTradeNo string `json:"origin_trade_no"` // 原交易拉卡拉交易订单号,String(32),选填 OriginTradeNo string `json:"origin_trade_no"` // 原交易拉卡拉交易订单号,String(32),选填
+3 -1
View File
@@ -1,5 +1,7 @@
package model package model
import "github.com/black1552/lkl_sdk/consts"
type SeparateRequest struct { type SeparateRequest struct {
ReqData *SeparateReqData `json:"req_data"` // 请求数据 ReqData *SeparateReqData `json:"req_data"` // 请求数据
Version string `json:"version"` // 版本号 Version string `json:"version"` // 版本号
@@ -13,7 +15,7 @@ type SeparateReqData struct {
OutSeparateNo string `json:"out_separate_no"` // 商户分账指令流水号 OutSeparateNo string `json:"out_separate_no"` // 商户分账指令流水号
TotalAmt string `json:"total_amt"` // 分账总金额 [单位:分] TotalAmt string `json:"total_amt"` // 分账总金额 [单位:分]
LklOrgNo string `json:"lkl_org_no"` // 拉卡拉机构编号 非必填 LklOrgNo string `json:"lkl_org_no"` // 拉卡拉机构编号 非必填
CalType string `json:"cal_type"` // 分账计算类型 0- 按照指定金额,1- 按照指定比例。默认 0 非必填 CalType consts.CalType `json:"cal_type"` // 分账计算类型 0- 按照指定金额,1- 按照指定比例。默认 0 非必填
SeparateType string `json:"separate_type"` SeparateType string `json:"separate_type"`
NotifyUrl string `json:"notify_url"` // 回调地址 分账,分账撤销或分账回退时,是异步接口。通过该地址通知商户最终处理结果。不传时,不回调 NotifyUrl string `json:"notify_url"` // 回调地址 分账,分账撤销或分账回退时,是异步接口。通过该地址通知商户最终处理结果。不传时,不回调
RecvDatas []*SeparateRecvDatas `json:"recv_datas"` // 分账接收数据对象 分账接收方编号必须已创建 RecvDatas []*SeparateRecvDatas `json:"recv_datas"` // 分账接收数据对象 分账接收方编号必须已创建
+3 -1
View File
@@ -1,5 +1,7 @@
package model package model
import "github.com/black1552/lkl_sdk/consts"
type UploadFileRequest struct { type UploadFileRequest struct {
ReqData *UploadFileReqData `json:"reqData"` ReqData *UploadFileReqData `json:"reqData"`
Ver string `json:"ver"` Ver string `json:"ver"`
@@ -10,7 +12,7 @@ type UploadFileRequest struct {
type UploadFileReqData struct { type UploadFileReqData struct {
Version string `json:"version"` Version string `json:"version"`
OrderNo string `json:"orderNo"` OrderNo string `json:"orderNo"`
AttType string `json:"attType"` AttType consts.AttType `json:"attType"`
AttExtName string `json:"attExtName"` AttExtName string `json:"attExtName"`
AttContext string `json:"attContext"` AttContext string `json:"attContext"`
OrgCode string `json:"orgCode"` OrgCode string `json:"orgCode"`
+3 -1
View File
@@ -1,5 +1,7 @@
package model package model
import "github.com/black1552/lkl_sdk/consts"
// WithdrawRequest 提现请求结构体 // WithdrawRequest 提现请求结构体
// 用于向拉卡拉接口发送提现请求 // 用于向拉卡拉接口发送提现请求
// 包含请求头信息和业务数据 // 包含请求头信息和业务数据
@@ -29,7 +31,7 @@ type WithdrawReqData struct {
// 账号(若该参数上送,则payType将无效),非必传,最大长度32 // 账号(若该参数上送,则payType将无效),非必传,最大长度32
PayNo string `json:"pay_no"` PayNo string `json:"pay_no"`
// 账号类型(01:收款账户,04:分账接收方账户)未上送则默认01,必传,最大长度32,分账接收方提现时需填04 // 账号类型(01:收款账户,04:分账接收方账户)未上送则默认01,必传,最大长度32,分账接收方提现时需填04
PayType string `json:"pay_type"` PayType consts.PayType `json:"pay_type"`
// 备注信息,非必传,最大长度64 // 备注信息,非必传,最大长度64
Remark string `json:"remark"` Remark string `json:"remark"`
// 摘要,非必传,最大长度64 // 摘要,非必传,最大长度64