引入账户相关常量和类型定义

- 新增附件类型(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常量定义，支持分账前后退款状态区分

README.md

@@ -19,7 +19,7 @@ lklsdk/
 
 ```bash
 # 将SDK引入到您的项目中
-go get -u github.com/black1552/lkl_sdk/lklsdk
+go get -u github.com/black1552/lkl_sdk
 ```
 
 ## 快速开始
@@ -33,22 +33,21 @@ import (
 	"github.com/gogf/gf/v2/os/gctx"
 )
 
-// 创建配置
-config := &lklsdk.Config{
-	AppID:        "your_app_id",        // 拉卡拉分配的AppID
-	TermNo:       "your_term_no",       // 终端号
-	MerchantNo:   "your_merchant_no",   // 商户号
-	SettleMerNo:  "your_settle_mer_no", // 结算商户号
-	SettleTermNo: "your_settle_term_no", // 结算终端号
-	AccountType:  "WECHAT",              // 账户类型，如WECHAT、ALIPAY等
-	TransType:    "71",                  // 交易类型
-	Version:      "3.0",                 // API版本
-	NotifyURL:    "your_notify_url",     // 回调URL
-	SerialNo:     "your_mch_api_key",    // 商户API密钥
-}
+// 创建配置JSON字符串
+cfgJson := `{
+	"public_key": "your_public_key",        // 公钥字符串
+	"private_key": "your_private_key",      // 私钥字符串
+	"app_id": "your_app_id",                // lakala应用ID
+	"serial_no": "your_serial_no",          // 序列号
+	"sub_app_id": "your_sub_app_id",        // 子应用ID 微信AppId
+	"version": "3.0",                       // lakala版本号
+	"account_type": "WECHAT",               // 账户类型
+	"trans_type": "71",                     // 交易类型
+	"notify_url": "your_notify_url"         // 回调地址
+}`
 
 // 初始化SDK（使用泛型指定响应类型）
-sdk := lklsdk.NewSDK[model.ResponseType](gctx.New(), config)
+sdk := lklsdk.NewSDK[model.ResponseType](gctx.New(), cfgJson)
 ```
 
 ## 功能模块
@@ -57,7 +56,7 @@ sdk := lklsdk.NewSDK[model.ResponseType](gctx.New(), config)
 
 ```go
 // 初始化特定响应类型的SDK
-sdk := lklsdk.NewSDK[model.MergePreorderResponse](gctx.New(), config)
+sdk := lklsdk.NewSDK[model.MergePreorderResponse](gctx.New(), cfgJson)
 
 // 准备拆单信息
 outSplitInfo := []*model.OutSplitInfo{
@@ -110,7 +109,7 @@ if !mergePreorderResp.SuccessOrFail() {
 
 ```go
 // 初始化特定响应类型的SDK
-sdk := lklsdk.NewSDK[model.ApplyLedgerMerResponse](gctx.New(), config)
+sdk := lklsdk.NewSDK[model.ApplyLedgerMerResponse](gctx.New(), cfgJson)
 
 // 构建请求参数
 applyLedgerReq := &model.ApplyLedgerMerReqData{
@@ -143,7 +142,7 @@ if !expectResp.SuccessOrFail() {
 
 ```go
 // 初始化特定响应类型的SDK
-sdk := lklsdk.NewSDK[model.TradeQueryResponse](gctx.New(), config)
+sdk := lklsdk.NewSDK[model.TradeQueryResponse](gctx.New(), cfgJson)
 
 // 构建请求参数
 tradeQueryReq := &model.TradeQueryReqData{
@@ -168,7 +167,7 @@ if !tradeQueryResp.SuccessOrFail() {
 
 ```go
 // 初始化特定响应类型的SDK
-sdk := lklsdk.NewSDK[model.OrderSplitLedgerResponse](gctx.New(), config)
+sdk := lklsdk.NewSDK[model.OrderSplitLedgerResponse](gctx.New(), cfgJson)
 
 // 准备分账接收方数据
 var recvDatas []*model.OrderSplitLedgerRecvDatas
@@ -199,11 +198,44 @@ if !splitLedgerResp.SuccessOrFail() {
 }
 ```
 
-### 5. 账户余额查询
+### 5. 退款
 
 ```go
 // 初始化特定响应类型的SDK
-sdk := lklsdk.NewSDK[model.BalanceQueryResponse](gctx.New(), config)
+sdk := lklsdk.NewSDK[model.RefundResponse](gctx.New(), cfgJson)
+
+// 构建请求参数
+refundReq := &model.RefundReqData{
+	MerchantNo: "your_merchant_no",  // 商户号
+	TermNo:     "your_term_no",      // 终端号
+	OutTradeNo: "original_out_trade_no", // 原商户交易流水号
+	OutRefundNo: "your_refund_out_trade_no", // 退款商户流水号
+	RefundAmount: "100",  // 退款金额，单位为分
+	TotalAmount: "100",   // 原交易总金额，单位为分
+	RefundReason: "退款原因", // 退款原因
+	NotifyUrl: "https://your-notify-url.com", // 回调地址
+}
+
+// 调用接口
+refundResp, err := sdk.Refound(refundReq)
+if err != nil {
+	log.Printf("退款失败: %v\n", err)
+}
+
+// 使用SuccessOrFail方法判断请求是否成功
+if !refundResp.SuccessOrFail() {
+	log.Printf("退款失败: %s\n", refundResp.Msg)
+}
+
+// 处理成功响应
+// 可以从refundResp.RespData中获取退款结果数据
+```
+
+### 6. 账户余额查询
+
+```go
+// 初始化特定响应类型的SDK
+sdk := lklsdk.NewSDK[model.BalanceQueryResponse](gctx.New(), cfgJson)
 
 // 构建请求参数
 balanceQueryReq := &model.BalanceQueryReqData{

consts/account.go

@@ -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)
+}

consts/field.go

@@ -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)
+}

lklsdk/client.go

@@ -16,22 +16,20 @@ import (
 
 	"github.com/black1552/base-common/utils"
 	"github.com/gogf/gf/v2/os/gfile"
+	"github.com/gogf/gf/v2/util/gconv"
 )
 
 // Config 拉卡拉SDK配置
 type Config struct {
-	AppID        string `json:"app_id"`
-	TermNo       string `json:"term_no"`
-	MerchantNo   string `json:"merchant_no"`
-	SettleMerNo  string `json:"settle_merchant_no"`
-	SettleTermNo string `json:"settle_term_no"`
-	AccountType  string `json:"account_type"`
-	TransType    string `json:"trans_type"`
-	Version      string `json:"version"`
-	NotifyURL    string `json:"notify_url"`
-	PublicKey    string `json:"public_key"`
-	PrivateKey   string `json:"private_key"`
-	SerialNo     string `json:"serial_no"`
+	PublicKey   string `json:"public_key" dc:"公钥字符串"`
+	PrivateKey  string `json:"private_key" dc:"私钥字符串"`
+	AppId       string `json:"app_id" dc:"lakala应用ID"`
+	SerialNo    string `json:"serial_no" dc:"序列号"`
+	SubAppId    string `json:"sub_app_id" dc:"子应用ID 微信AppId"`
+	Version     string `json:"version" dc:"lakala版本号"`
+	AccountType string `json:"account_type" dc:"账户类型"`
+	TransType   string `json:"trans_type" dc:"交易类型"`
+	NotifyUrl   string `json:"notify_url" dc:"回调地址"`
 }
 
 // Client 拉卡拉SDK客户端
@@ -42,7 +40,12 @@ type Client[T any] struct {
 }
 
 // NewClient 创建拉卡拉SDK客户端
-func NewClient[T any](ctx context.Context, config *Config) *Client[T] {
+func NewClient[T any](ctx context.Context, cfgJson string) *Client[T] {
+	var config *Config
+	err := gconv.Struct(cfgJson, &config)
+	if err != nil {
+		return nil
+	}
 	return &Client[T]{
 		config: config,
 		ctx:    ctx,
@@ -65,7 +68,7 @@ func (c *Client[T]) generateSign(request []byte) (string, error) {
 	timestamp := fmt.Sprintf("%d", time.Now().Unix())
 
 	// 构建待签名报文
-	signData := fmt.Sprintf("%s\n%s\n%s\n%s\n%s\n", c.config.AppID, c.config.SerialNo, timestamp, nonceStr, string(request))
+	signData := fmt.Sprintf("%s\n%s\n%s\n%s\n%s\n", c.config.AppId, c.config.SerialNo, timestamp, nonceStr, string(request))
 
 	// 计算签名
 	hashed := sha256.Sum256([]byte(signData))
@@ -82,7 +85,7 @@ func (c *Client[T]) generateSign(request []byte) (string, error) {
 
 	// 构建Authorization头
 	authorization := fmt.Sprintf("LKLAPI-SHA256withRSA appid=\"%s\",serial_no=\"%s\",timestamp=\"%s\",nonce_str=\"%s\",signature=\"%s\"",
-		c.config.AppID, c.config.SerialNo, timestamp, nonceStr, signatureBase64)
+		c.config.AppId, c.config.SerialNo, timestamp, nonceStr, signatureBase64)
 	return authorization, nil
 }
 

lklsdk/sdk.go

@@ -17,8 +17,8 @@ type SDK[T any] struct {
 }
 
 // NewSDK 创建拉卡拉SDK实例
-func NewSDK[T any](ctx context.Context, config *Config) *SDK[T] {
-	client := NewClient[T](ctx, config)
+func NewSDK[T any](ctx context.Context, cfgJson string) *SDK[T] {
+	client := NewClient[T](ctx, cfgJson)
 	return &SDK[T]{
 		Client:      client,
 		SplitLedger: NewSplitLedgerService(client),

lklsdk/trade.go

@@ -28,7 +28,7 @@ func (t *TradeService[T]) TradeQuery(req *model.TradeQueryReqData) (*T, error) {
 	baseReq := model.TradeQuery{
 		ReqTime:    time.Now().Format("20060102150405"),
 		Version:    "3.0",
-		OutOrgCode: t.client.config.AppID,
+		OutOrgCode: t.client.config.AppId,
 		ReqData:    req,
 	}
 

model/applyBind.go

@@ -1,5 +1,7 @@
 package model
 
+import "github.com/black1552/lkl_sdk/consts"
+
 // ApplyBindRequest 分账关系绑定请求结构体
 // 用于发起分账接收方与商户的关系绑定申请
 // 拉卡拉SDK接口文档：分账关系绑定接口
@@ -24,11 +26,13 @@ type ApplyBindReqData struct {
 	EntrustFileName string                 `json:"entrustFileName"`       // 合作协议附件名称，必传，长度32
 	EntrustFilePath string                 `json:"entrustFilePath"`       // 合作协议附件路径，必传，长度32，通过调用附件上传接口获取
 	RetUrl          string                 `json:"retUrl"`                // 回调通知地址，必传，长度128，审核通过后通知地址
-	Attachments     []struct {
-		AttachType      string `json:"attachType"`      // 附件类型编码，必传，长度32
+	Attachments     []*ApplyBindAttachment `json:"attachments,omitempty"` // 附加资料，可选，集合类型，其他附加资料文件信息
+}
+
+type ApplyBindAttachment struct {
+	AttachType      consts.AttType `json:"attachType"`      // 附件类型编码，必传，长度32
 	AttachName      string         `json:"attachName"`      // 附件名称，必传，长度32
 	AttachStorePath string         `json:"attachStorePath"` // 附件路径，必传，长度128，通过调用附件上传接口获取
-	} `json:"attachments,omitempty"` // 附加资料，可选，集合类型，其他附加资料文件信息
 }
 
 // ApplyBindResponse 分账关系绑定响应结构体

model/applyLedgerMer.go

@@ -1,5 +1,7 @@
 package model
 
+import "github.com/black1552/lkl_sdk/consts"
+
 // ApplyLedgerMerRequest 商户分账业务开通申请请求结构体
 type ApplyLedgerMerRequest struct {
 	ReqData *ApplyLedgerMerReqData `json:"reqData"` // 请求业务数据
@@ -19,18 +21,14 @@ type ApplyLedgerMerReqData struct {
 	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-金额分账
+	SplitRange           consts.SplitRange      `json:"splitRange"`            // 分账范围，必传，长度32，取值说明：ALL-全部交易分账(所有交易默认都分账)，MARK-标记交易分账(只有带标记交易才分账，其余交易正常结算)
+	SepFundSource        consts.SepFundSource   `json:"sepFundSource"`         // 分账依据，非必传，长度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-平台分润规则(分润规则必传)
+	SplitLaunchMode      consts.SplitLaunchMode `json:"splitLaunchMode"`       // 分账发起方式，非必传，长度32，取值说明：AUTO-自动触发分账，POINTTRUE-指定规则分账，MANUAL-手动分账
+	SettleType           consts.SplitSettleType `json:"settleType"`            // 结算类型，非必传，长度32，取值说明：01-主扫现结，02-复扫现结，03-交易自动结算
+	SplitRuleSource      consts.SplitRuleSource `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"` // 附加资料，可选，集合，其他需附加的文件信息
+	Attachments          []*ApplyBindAttachment `json:"attachments,omitempty"` // 附加资料，可选，集合，其他需附加的文件信息
 }
 
 // ApplyLedgerMerResponse 商户分账业务开通申请响应结构体

model/applyLedgerReceiver.go

@@ -1,5 +1,7 @@
 package model
 
+import "github.com/black1552/lkl_sdk/consts"
+
 // ApplyLedgerReceiverRequest 分账接收方创建请求结构体
 // 用于向拉卡拉接口发送分账接收方创建请求
 // 包含请求头信息和业务数据
@@ -43,7 +45,7 @@ type ApplyLedgerReceiverReqData struct {
 	// 收款账户名称，必传，长度32
 	AcctName string `json:"acctName"`
 	// 收款账户类型代码，必传，长度32，取值说明：57：对公，58：对私
-	AcctTypeCode string `json:"acctTypeCode"`
+	AcctTypeCode consts.AcctTypeCode `json:"acctTypeCode"`
 	// 收款账户证件类型，必传，长度32，取值说明：17身份证，18护照，19港澳居民来往内地通行证，20台湾居民来往内地通行证，身份证外类型先咨询后再使用
 	AcctCertificateType string `json:"acctCertificateType"`
 	// 收款账户证件号，必传，长度32
@@ -55,14 +57,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"`
 }

model/balanceQuery.go

@@ -1,5 +1,7 @@
 package model
 
+import "github.com/black1552/lkl_sdk/consts"
+
 // BalanceQueryRequest 余额查询请求结构体
 // 用于向拉卡拉接口发送余额查询请求
 // 包含请求头信息和业务数据
@@ -23,7 +25,7 @@ type BalanceQueryReqData struct {
 	// 账号，若该参数上送，则payType将无效，非必传，最大长度32
 	PayNo string `json:"pay_no"`
 	// 账号类型（01：收款账户，02：付款账户，03：分账商户账户，04：分账接收方账户，05：充值代付账户，06：结算代付账户）-未上送则默认01，非必传，最大长度32
-	PayType string `json:"pay_type"`
+	PayType consts.PayType `json:"pay_type"`
 	// 账户标志（01:一般账户;03:虚户）-未上送则默认01，非必传，最大长度32
 	MgtFlag string `json:"mgt_flag"`
 }

model/mergePreorder.go

@@ -1,6 +1,9 @@
 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 主扫合单交易请求结构体
 type MergePreorder struct {
@@ -15,8 +18,8 @@ type MergePreorderReqData struct {
 	TermNo            string             `json:"term_no"`             // 终端号，拉卡拉分配的业务终端号，String(32)，必填
 	OutTradeNo        string             `json:"out_trade_no"`        // 商户交易流水号，商户系统唯一，String(32)，必填
 	OutSplitInfo      []*OutSplitInfo    `json:"out_split_info"`      // 拆单信息，List，必填
-	AccountType  string       `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)，必填
+	AccountType       consts.AccountType `json:"account_type"`        // 钱包类型，微信：WECHAT 支付宝：ALIPAY 银联：UQRCODEPAY 京东钱包：JD，String(32)，必填
+	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)，必填
 	LocationInfo      *LocationInfo      `json:"location_info"`       // 地址位置信息，Object，风控要求必送，必填
 	BusiMode          string             `json:"busi_mode"`           // 业务模式，ACQ-收单 PAY-付款不填，默认为"ACQ-收单"，String(8)，选填

model/orderSplitLedger.go

@@ -1,5 +1,7 @@
 package model
 
+import "github.com/black1552/lkl_sdk/consts"
+
 // OrderSplitLedgerRequest 订单分账请求结构体
 // 用于发起订单分账操作，支持向多个接收方进行分账
 // 拉卡拉SDK接口文档：订单分账接口
@@ -20,7 +22,7 @@ type OrderSplitLedgerReqData struct {
 	OutSeparateNo string                       `json:"out_separate_no"`      // 商户分账指令流水号，必传，长度32，每个商户号下唯一，否则会校验失败
 	TotalAmt      string                       `json:"total_amt"`            // 分账总金额，必传，长度15，单位为分
 	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，分账、分账撤销或分账回退时，通过该地址通知商户最终处理结果，不传时不回调
 	RecvDatas     []*OrderSplitLedgerRecvDatas `json:"recv_datas,omitempty"` // 分账接收数据对象，条件必传，列表类型，分账接收方编号必须已创建
 }

model/preorder.go

@@ -1,6 +1,9 @@
 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 预下单请求结构体
 type Preorder struct {
@@ -14,10 +17,11 @@ type PreorderReqData struct {
 	MerchantNo   string             `json:"merchant_no"`  // 商户号，拉卡拉分配的商户号，String(32)
 	TermNo       string             `json:"term_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)
-	TransType    string `json:"trans_type"`   // 接入方式，41:NATIVE（ALIPAY, 云闪付支持, 京东白条分期）51:JSAPI（微信公众号支付, 支付宝服务窗、JS支付, 翼支付JS支付, 拉卡拉钱包支付, 京东白条分期）71:微信小程序支付61:APP支付（微信APP支付），String(2)
+	AccountType  consts.AccountType `json:"account_type"` // 钱包类型，微信：WECHAT 支付宝：ALIPAY 银联：UQRCODEPAY 翼支付：BESTPAY 苏宁易付宝：SUNING 拉卡拉支付账户：LKLACC 网联小钱包：NUCSPAY 京东钱包：JD，String(32)
+	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)
 	NotifyUrl    string             `json:"notify_url"`   // 商户通知地址，商户通知地址，如果上传，且 pay_order_no 不存在情况下，则按此地址通知商户，String(128)
+	SettleType   consts.SettleType  `json:"settle_type"`  // “0”或者空，常规结算方式，如需接拉卡拉分账通需传“1”，商户未开通分账之前切记不用上送此参数。
 	LocationInfo struct {
 		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)
@@ -37,7 +41,7 @@ func NewPreorder(param *PreorderReqData) *Preorder {
 type PreorderResponse struct {
 	Code     string   `json:"code"`      // 响应码，BBS00000表示成功
 	Msg      string   `json:"msg"`       // 响应信息，对响应码的文字描述
-	ReqData  ReqData `json:"resp_data"` // 响应业务数据
+	ReqData  *ReqData `json:"resp_data"` // 响应业务数据
 	RespTime string   `json:"resp_time"` // 响应时间
 }
 
@@ -49,8 +53,7 @@ type ReqData struct {
 	LogNo            string              `json:"log_no"`             // 拉卡拉对账单流水号
 	SettleMerchantNo string              `json:"settle_merchant_no"` // 结算商户号
 	SettleTermNo     string              `json:"settle_term_no"`     // 结算终端号
-	AccRespFields    WxPreorderResponse `json:"acc_resp_fields"`    // 支付通道返回的具体信息
-
+	AccRespFields    *WxPreorderResponse `json:"acc_resp_fields"`    // 支付通道返回的具体信息
 }
 
 // WxPreorderResponse 支付通道返回的具体信息

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 已绑定接收方信息结构体

model/refund.go

@@ -1,6 +1,9 @@
 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 退款请求结构体
 type Refund struct {
@@ -15,11 +18,12 @@ type RefundReqData struct {
 	TermNo        string               `json:"term_no"`         // 终端号，拉卡拉分配的业务终端号，String(32)，必填
 	OutTradeNo    string               `json:"out_trade_no"`    // 商户请求流水号，商户系统唯一，String(32)，必填
 	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 {
 		RequestIp string `json:"request_ip"` // 请求方IP地址，请求方的IP地址，存在必填，格式如36.45.36.95，String(64)，必填
 	} `json:"location_info"` // 地址位置信息，Object，必填
 	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)，选填
 	OriginOutTradeNo string              `json:"origin_out_trade_no"` // 原始交易商户流水号，String(32)，选填
 	OriginTradeNo    string              `json:"origin_trade_no"`     // 原交易拉卡拉交易订单号，String(32)，选填

model/separate.go

@@ -1,5 +1,7 @@
 package model
 
+import "github.com/black1552/lkl_sdk/consts"
+
 type SeparateRequest struct {
 	ReqData *SeparateReqData `json:"req_data"` // 请求数据
 	Version string           `json:"version"`  // 版本号
@@ -13,7 +15,7 @@ type SeparateReqData struct {
 	OutSeparateNo string               `json:"out_separate_no"` // 商户分账指令流水号
 	TotalAmt      string               `json:"total_amt"`       // 分账总金额 [单位：分]
 	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"`
 	NotifyUrl     string               `json:"notify_url"` // 回调地址 分账，分账撤销或分账回退时，是异步接口。通过该地址通知商户最终处理结果。不传时，不回调
 	RecvDatas     []*SeparateRecvDatas `json:"recv_datas"` // 分账接收数据对象 分账接收方编号必须已创建

model/uploadFile.go

@@ -1,5 +1,7 @@
 package model
 
+import "github.com/black1552/lkl_sdk/consts"
+
 type UploadFileRequest struct {
 	ReqData   *UploadFileReqData `json:"reqData"`
 	Ver       string             `json:"ver"`
@@ -10,7 +12,7 @@ type UploadFileRequest struct {
 type UploadFileReqData struct {
 	Version    string         `json:"version"`
 	OrderNo    string         `json:"orderNo"`
-	AttType    string `json:"attType"`
+	AttType    consts.AttType `json:"attType"`
 	AttExtName string         `json:"attExtName"`
 	AttContext string         `json:"attContext"`
 	OrgCode    string         `json:"orgCode"`

model/withdraw.go

@@ -1,5 +1,7 @@
 package model
 
+import "github.com/black1552/lkl_sdk/consts"
+
 // WithdrawRequest 提现请求结构体
 // 用于向拉卡拉接口发送提现请求
 // 包含请求头信息和业务数据
@@ -29,7 +31,7 @@ type WithdrawReqData struct {
 	// 账号（若该参数上送，则payType将无效），非必传，最大长度32
 	PayNo string `json:"pay_no"`
 	// 账号类型（01：收款账户，04：分账接收方账户）未上送则默认01，必传，最大长度32，分账接收方提现时需填04
-	PayType string `json:"pay_type"`
+	PayType consts.PayType `json:"pay_type"`
 	// 备注信息，非必传，最大长度64
 	Remark string `json:"remark"`
 	// 摘要，非必传，最大长度64