feat(merchant): 新增微信实名认证结果查询功能

- 在 consts/url.go 中新增微信实名认证结果查询接口地址常量
- 在 lklsdk/merchant.go 中实现 WechatRealNameQuery 方法，用于发送实名认证查询请求
- 在 lklsdk/sdk.go 中暴露 WechatRealNameQuery 接口方法，方便外部调用
- 新增 model/wechatRealNameQuery.go 文件，定义微信实名认证查询相关的请求与响应结构体
- 实现 SuccessOrFail 方法判断微信实名认证查询是否成功

consts/url.go

@@ -25,6 +25,7 @@ const (
 	// LKL_ACCOUNT_WITHDRAW_URL 拉卡拉账户提现
 	LKL_ACCOUNT_WITHDRAW_URL          = "/v2/laep/industry/ewalletWithdrawD1"
 	LKL_SPLIT_LEDGER_RESULT_QUERY_URL = "/v3/sacs/query_plus"
+	LKL_SPLIT_LEDGER_FALLBACK_URL     = "/v3/sacs/fallback"
 )
 
 const (
@@ -57,6 +58,8 @@ const (
 	LKL_EC_APPLY_MANUAL = "/v3/mms/open_api/ec/apply_manual"
 	// LKL_EC_QMA_STATUS 拉卡拉商户电子合同人工复核结果查询
 	LKL_EC_QMA_STATUS = "/v3/mms/open_api/ec/qma_status"
+	// LKL_WECHAT_REAL_NAME_QUERY 拉卡拉微信实名认证结果查询
+	LKL_WECHAT_REAL_NAME_QUERY = "/v2/mms/openApi/wechatRealNameQuery"
 )
 
 // unifiedReturn  统一退货API地址

lklsdk/merchant.go

@@ -205,3 +205,26 @@ func (t *MerService[T]) ReconsiderSubmitTest(req *model.ReConfSubmitRequestData)
 	}
 	return respBody, nil
 }
+
+func (t *MerService[T]) WechatRealNameQuery(req *model.WechatRealNameQueryReqData) (*T, error) {
+	// 构建请求参数
+	url := consts.BASE_URL + consts.LKL_WECHAT_REAL_NAME_QUERY
+	md5, err := gmd5.Encrypt(gconv.String(time.Now().Unix()))
+	if err != nil {
+		return nil, fmt.Errorf("创建ReqId失败")
+	}
+	// 构建BaseModel请求
+	baseReq := model.WechatRealNameQueryRequest{
+		ReqData:   req,
+		ReqId:     md5,
+		Timestamp: time.Now().Unix(),
+		Ver:       "1.0",
+	}
+
+	// 发送请求
+	respBody, err := t.client.DoRequest(url, baseReq)
+	if err != nil {
+		return nil, err
+	}
+	return respBody, nil
+}

lklsdk/sdk.go

@@ -158,6 +158,11 @@ func (s *SDK[T]) OrderSplitLedgerResultQuery(req *model.OrderSplitLedgerResultQu
 	return s.SplitLedger.OrderSplitLedgerResultQuery(req)
 }
 
+// OrderSplitLedgerFallback 订单分账回退
+func (s *SDK[T]) OrderSplitLedgerFallback(req *model.OrderSplitLedgerFallbackReqData) (*T, error) {
+	return s.SplitLedger.OrderSplitLedgerFallback(req)
+}
+
 // TradeQuery 交易查询
 func (s *SDK[T]) TradeQuery(req *model.TradeQueryReqData) (*T, error) {
 	return s.Trade.TradeQuery(req)
@@ -242,3 +247,7 @@ func (s *SDK[T]) ECQmaStatus(req *ecQmaStatus.ECQmaStatusRequestData) (*ecQmaSta
 func (s *SDK[T]) ECQmaStatusTest(req *ecQmaStatus.ECQmaStatusRequestData) (*ecQmaStatus.ECQmaStatusResponse, error) {
 	return s.ECPeQmaStatus.ECQmaStatusTest(req)
 }
+
+func (s *SDK[T]) WechatRealNameQuery(req *model.WechatRealNameQueryReqData) (*T, error) {
+	return s.Merchant.WechatRealNameQuery(req)
+}

lklsdk/split_ledger_more.go

@@ -156,3 +156,22 @@ func (s *SplitLedgerService[T]) OrderSplitLedgerResultQuery(req *model.OrderSpli
 	}
 	return respBody, nil
 }
+
+func (s *SplitLedgerService[T]) OrderSplitLedgerFallback(req *model.OrderSplitLedgerFallbackReqData) (*T, error) {
+	// 构建请求参数
+	url := consts.BASE_URL + consts.LKL_SPLIT_LEDGER_FALLBACK_URL
+
+	// 构建BaseModel请求
+	baseReq := model.OrderSplitLedgerFallbackRequest{
+		ReqTime: time.Now().Format("20060102150405"),
+		Version: "3.0",
+		ReqData: req,
+	}
+
+	// 发送请求
+	respBody, err := s.client.DoRequest(url, baseReq)
+	if err != nil {
+		return nil, err
+	}
+	return respBody, nil
+}

model/balanceQuery.go

@@ -35,30 +35,30 @@ type BalanceQueryReqData struct {
 // 包含响应状态码、消息和业务数据
 type BalanceQueryResponse struct {
 	// 响应状态码，000000
-	Code string `json:"code"`
+	Code string `json:"retCode"`
 	// 响应消息
-	Msg string `json:"msg"`
+	Msg string `json:"retMsg"`
 	// 响应业务数据，当code为SACS0000时返回
-	RespData *BalanceQueryRespData `json:"resp_data"`
+	RespData *BalanceQueryRespData `json:"respData"`
 }
 
 // BalanceQueryRespData 余额查询响应业务数据结构体
 // 包含余额查询返回的具体账户信息
 type BalanceQueryRespData struct {
 	// 账号，必传
-	PayNo string `json:"pay_no"`
+	PayNo string `json:"payNo"`
 	// 账户类型，必传
-	PayType string `json:"pay_type"`
+	PayType string `json:"payType"`
 	// 账户状态，必传，取值说明：CLOSE销户，NORMAL正常，FREEZE冻结，STOPAY止付
-	AcctSt string `json:"acct_st"`
+	AcctSt string `json:"acctSt"`
 	// 预付余额（单位元），必传
-	ForceBalance string `json:"force_balance"`
+	ForceBalance string `json:"forceBalance"`
 	// 上日余额（单位元）-该字段已废弃使用，必传
-	HisBalance string `json:"his_balance"`
+	HisBalance string `json:"hisBalance"`
 	// 实时余额（单位元），必传
-	ReBalance string `json:"re_balance"`
+	ReBalance string `json:"reBalance"`
 	// 当前可用余额（单位元），必传
-	CuBalance string `json:"cu_balance"`
+	CuBalance string `json:"cuBalance"`
 }
 
 // SuccessOrFail 判断余额查询请求是否成功

model/orderSplitLedgerFallback.go

@@ -0,0 +1,40 @@
+package model
+
+type OrderSplitLedgerFallbackRequest struct {
+	ReqData *OrderSplitLedgerFallbackReqData `json:"req_data"` // 请求业务数据
+	Version string                           `json:"version"`  // 接口版本号
+	ReqTime string                           `json:"req_time"` // 请求时间，格式为yyyyMMddHHmmss
+}
+
+type OrderSplitLedgerFallbackReqData struct {
+	MerchantNo          string                             `json:"merchant_no"`            // 商户号，必传，长度32
+	OriginSeparateNo    string                             `json:"origin_separate_no"`     // 原分账单号，必传，长度32
+	OutSeparateNo       string                             `json:"out_separate_no"`        // 外部分账单号，必传，长度32
+	OriginOutSeparateNo string                             `json:"origin_out_separate_no"` // 原外部分账单号，必传，长度32
+	FallbackReason      string                             `json:"fallback_reason"`        // 回退原因，必传，长度255
+	TotalAmt            string                             `json:"total_amt"`              // 总金额，必传，长度15
+	OriginRecvDatas     []*OrderSplitLedgerOriginRecvDatas `json:"origin_recv_datas"`      // 原分账接收数据，必传，数组长度1-100
+}
+
+type OrderSplitLedgerOriginRecvDatas struct {
+	RecvNo string `json:"recv_no"` // 原分账接收号，必传，长度32
+	Amt    string `json:"amt"`     // 原分账接收金额，必传，长度15
+}
+
+type OrderSplitLedgerFallbackResponse struct {
+	Msg      string `json:"msg"`       // 消息
+	RespTime string `json:"resp_time"` // 响应时间
+	Code     string `json:"code"`      // 响应码 SACS0000表示成功
+	RespData struct {
+		OutSeparateNo       string `json:"out_separate_no"`        // 外部分账单号，必传，长度32
+		TotalAmt            string `json:"total_amt"`              // 总金额，必传，长度15
+		OriginOutSeparateNo string `json:"origin_out_separate_no"` // 原外部分账单号，必传，长度32
+		OriginSeparateNo    string `json:"origin_separate_no"`     // 原分账单号，必传，长度32
+		Status              string `json:"status"`                 // 状态，必传，长度1
+		SeparateNo          string `json:"separate_no"`            // 分账单号，必传，长度32
+	}
+}
+
+func (s *OrderSplitLedgerFallbackResponse) SuccessOrFail() bool {
+	return s.Code == "SACS0000"
+}

model/preorder.go

@@ -27,6 +27,7 @@ type PreorderReqData struct {
 		Location  string `json:"location"`   // 纬度,经度，商户终端的地理位置，银联二维码交易必填，整体格式：纬度,经度，+表示北纬、东经，-表示南纬、西经。经度格式：1位正负号+3位整数+1位小数点+5位小数；纬度格式：1位正负号+2位整数+1位小数点+6位小数；举例：+31.221345,+121.12345，String(32)
 	} `json:"location_info"` // 地址位置信息，Object
 	Subject       string         `json:"subject"`         // 订单标题，用于简单描述订单或商品主题，传输给账户端（账户端控制，实际最多42个字节），微信支付必送，String(42)
+	AccBusiFields *AccBusiFields `json:"acc_busi_fields"` // 账户业务字段，Object
 }
 
 func NewPreorder(param *PreorderReqData) *Preorder {

model/tradeQuery.go

@@ -69,5 +69,5 @@ type TradeQueryResponse struct {
 }
 
 func (t *TradeQueryResponse) SuccessOrFail() bool {
-	return t.Code == "000000"
+	return t.Code == "BBS00000"
 }

model/wechatRealNameQuery.go

@@ -0,0 +1,46 @@
+package model
+
+type WechatRealNameQueryRequest struct {
+	// 请求业务数据
+	ReqData *WechatRealNameQueryReqData `json:"reqData"`
+	// 接口版本号
+	Ver string `json:"ver"`
+	// 请求时间，格式为yyyyMMddHHmmss
+	Timestamp int64  `json:"timestamp"`
+	ReqId     string `json:"reqId"`
+}
+
+type WechatRealNameQueryReqData struct {
+	Version    string `json:"version" dc:"接口版本号"`
+	OrderNo    string `json:"orderNo" dc:"订单编号 14位年月日时（24小时制）分秒+8位的随机数（不重复）如：2021020112000012345678"`
+	OrgCode    string `json:"orgCode" dc:"机构代码"`
+	MerInnerNo string `json:"merInnerNo" dc:"拉卡拉内部商户号"`
+	SubMchId   string `json:"subMchId" dc:"子商户号"`
+	ChannelId  string `json:"channelId" dc:"渠道号 （建议传入，能具体定位用的渠道，仅支持拉卡拉渠道查询）"`
+}
+
+type WechatRealNameQueryResponse struct {
+	// 响应状态码，000000表示成功
+	RetCode string `json:"retCode"`
+	// 响应消息
+	RetMsg string `json:"retMsg"`
+	// 响应业务数据，当code为000000时返回
+	RespData *WechatRealNameQueryRespData `json:"respData"`
+}
+
+type WechatRealNameQueryRespData struct {
+	MerInnerNo      string `json:"merInnerNo" dc:"拉卡拉内部商户号"`
+	SubMchId        string `json:"subMchId" dc:"账户端子商户号	"`
+	ChannelId       string `json:"channelId" dc:"渠道号"`
+	ReceOrgNo       string `json:"receOrgNo" dc:"从业机构号"`
+	ApplymentId     string `json:"applymentId" dc:"申请编号"`
+	ApplymentState  string `json:"applymentState" dc:"申请状态"`
+	AuthorizeState  string `json:"authorizeState" dc:"认证状态"`
+	QrcodeData      string `json:"qrcodeData" dc:"	小程序码图片"`
+	RejectParameter string `json:"rejectParameter" dc:"驳回参数"`
+	RejectReason    string `json:"rejectReason" dc:"驳回原因"`
+}
+
+func (resp *WechatRealNameQueryResponse) SuccessOrFail() bool {
+	return resp.RetCode == "000000"
+}