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

- 在 consts/url.go 中新增微信实名认证结果查询接口地址常量 - 在 lklsdk/merchant.go 中实现 WechatRealNameQuery 方法，用于发送实名认证查询请求 - 在 lklsdk/sdk.go 中暴露 WechatRealNameQuery 接口方法，方便外部调用 - 新增 model/wechatRealNameQuery.go 文件，定义微信实名认证查询相关的请求与响应结构体 - 实现 SuccessOrFail 方法判断微信实名认证查询是否成功
fix(refund): 更新退款成功状态码判断逻辑
2025-12-12 15:51:30 +08:00 · 2025-12-10 10:18:56 +08:00 · 2025-12-09 15:18:01 +08:00 · 2025-12-08 17:16:32 +08:00
6 changed files with 115 additions and 39 deletions
@@ -58,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地址
@@ -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
+}
@@ -247,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)
+}
@@ -26,7 +26,8 @@ type PreorderReqData 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)
 	} `json:"location_info"` // 地址位置信息，Object
-	Subject string `json:"subject"` // 订单标题，用于简单描述订单或商品主题，传输给账户端（账户端控制，实际最多42个字节），微信支付必送，String(42)
+	Subject       string         `json:"subject"`         // 订单标题，用于简单描述订单或商品主题，传输给账户端（账户端控制，实际最多42个字节），微信支付必送，String(42)
+	AccBusiFields *AccBusiFields `json:"acc_busi_fields"` // 账户业务字段，Object
 }

 func NewPreorder(param *PreorderReqData) *Preorder {
@@ -2,41 +2,41 @@ package model

 // TradeQuery 交易查询请求结构体
 type TradeQuery struct {
-	ReqTime    string             `json:"req_time"`    // 请求时间
-	Version    string             `json:"version"`     // API版本号
+	ReqTime    string             `json:"req_time"`     // 请求时间
+	Version    string             `json:"version"`      // API版本号
 	OutOrgCode string             `json:"out_org_code"` // 外部机构码
-	ReqData    *TradeQueryReqData `json:"req_data"`    // 请求数据
+	ReqData    *TradeQueryReqData `json:"req_data"`     // 请求数据
 }

 // TradeQueryReqData 交易查询请求数据结构体
 type TradeQueryReqData struct {
-	MerchantNo string `json:"merchant_no"` // 商户号，必传
-	TermNo     string `json:"term_no"`     // 终端号，必传
+	MerchantNo string `json:"merchant_no"`  // 商户号，必传
+	TermNo     string `json:"term_no"`      // 终端号，必传
 	OutTradeNo string `json:"out_trade_no"` // 商户交易流水号，条件必传，与trade_no必传其一
 }

 // TradeQueryResponse 交易查询响应结构体
 type TradeQueryResponse struct {
-	Msg      string `json:"msg"`      // 响应消息
+	Msg      string `json:"msg"`       // 响应消息
 	RespTime string `json:"resp_time"` // 响应时间
-	Code     string `json:"code"`     // 响应码，000000表示成功
+	Code     string `json:"code"`      // 响应码，000000表示成功
 	RespData struct {
-		MerchantNo         string `json:"merchant_no"`         // 商户号，必传
-		OutTradeNo         string `json:"out_trade_no"`         // 商户请求流水号，必传
-		TradeNo            string `json:"trade_no"`            // 拉卡拉商户订单号，必传
-		LogNo              string `json:"log_no"`              // 拉卡拉对账流水号，必传
-		TradeMainType      string `json:"trade_main_type"`      // 交易大类，条件必传（PREORDER-主扫，MICROPAY-被扫，REFUND-退款，CANCEL-撤销）
-		SplitAttr          string `json:"split_attr"`          // 拆单属性，条件必传（M-主单，S-子单）
-		SplitInfo          []struct {
-			SubTradeNo    string `json:"sub_trade_no"`    // 子单交易流水号，必传
-			SubLogNo      string `json:"sub_log_no"`      // 子单对账单单流水号，必传
+		MerchantNo    string `json:"merchant_no"`     // 商户号，必传
+		OutTradeNo    string `json:"out_trade_no"`    // 商户请求流水号，必传
+		TradeNo       string `json:"trade_no"`        // 拉卡拉商户订单号，必传
+		LogNo         string `json:"log_no"`          // 拉卡拉对账流水号，必传
+		TradeMainType string `json:"trade_main_type"` // 交易大类，条件必传（PREORDER-主扫，MICROPAY-被扫，REFUND-退款，CANCEL-撤销）
+		SplitAttr     string `json:"split_attr"`      // 拆单属性，条件必传（M-主单，S-子单）
+		SplitInfo     []struct {
+			SubTradeNo    string `json:"sub_trade_no"`     // 子单交易流水号，必传
+			SubLogNo      string `json:"sub_log_no"`       // 子单对账单单流水号，必传
 			OutSubTradeNo string `json:"out_sub_trade_no"` // 外部子交易流水号，必传
 			MerchantNo    string `json:"merchant_no"`      // 商户号，必传
 			MerchantName  string `json:"merchant_name"`    // 商户名称，必传
 			TermNo        string `json:"term_no"`          // 终端号，必传
 			Amount        string `json:"amount"`           // 金额，必传（单位分）
-		} `json:"split_info"`          // 拆单信息，条件必传（如果查询订单是主单，则返回）
-		RefundSplitInfo    []struct {
+		} `json:"split_info"` // 拆单信息，条件必传（如果查询订单是主单，则返回）
+		RefundSplitInfo []struct {
 			OutSubTradeNo string `json:"out_sub_trade_no"` // 外部子退款交易流水号，必传
 			MerchantNo    string `json:"merchant_no"`      // 商户号，必传
 			TermNo        string `json:"term_no"`          // 终端号，必传
@@ -46,28 +46,28 @@ type TradeQueryResponse struct {
 			TradeState    string `json:"trade_state"`      // 子交易状态，条件必传（SUCCESS-交易成功 FAIL-交易失败）
 			ResultCode    string `json:"result_code"`      // 处理结果码，条件必传
 			ResultMsg     string `json:"result_msg"`       // 处理描述，条件必传
-		} `json:"refund_split_info"`    // 合单退款拆单信息，条件必传（如果查询订单是退款主单，则返回）
-		AccTradeNo         string                 `json:"acc_trade_no"`         // 账户端交易订单号，必传
-		AccountType        string                 `json:"account_type"`         // 钱包类型，必传（微信: WECHAT 支付宝: ALIPAY 银联: UQRCODEPAY 翼支付: BESTPAY 苏宁支付: SUNING）
-		TradeState         string                 `json:"trade_state"`          // 交易状态，必传（INIT-初始化 CREATE-下单成功 SUCCESS-交易成功 FAIL-交易失败 DEAL-交易处理中 UNKNOWN-未知状态 CLOSE-订单关闭 PART_REFUND-部分退款 REFUND-全部退款）
-		TradeStateDesc     string                 `json:"trade_state_desc"`     // 交易状态描述，条件必传
-		TotalAmount        string                 `json:"total_amount"`         // 订单金额，必传（单位分）
-		PayerAmount        string                 `json:"payer_amount"`         // 付款人实付金额，条件必传（单位分）
-		AccSettleAmount    string                 `json:"acc_settle_amount"`    // 账户端结算金额，条件必传（单位分）
-		AccMdiscountAmount string                 `json:"acc_mdiscount_amount"` // 商户侧优惠金额，条件必传（单位分）
-		AccDiscountAmount  string                 `json:"acc_discount_amount"`  // 账户端优惠金额，条件必传（单位分）
-		AccOtherDiscountAmount string             `json:"acc_other_discount_amount"` // 账户端其它优惠金额，条件必传（单位分）
-		TradeTime          string                 `json:"trade_time"`           // 交易完成时间，条件必传（yyyyMMddHHmmss）
-		UserId1            string                 `json:"user_id1"`             // 用户标识1，条件必传（微信sub_open_id 支付宝buyer_login_id 买家支付账号）
-		UserId2            string                 `json:"user_id2"`             // 用户标识2，条件必传（微信open_id 支付宝buyer_user_id 银user_id）
-		BankType           string                 `json:"bank_type"`            // 付款银行，条件必传
-		CardType           string                 `json:"card_type"`            // 银行卡类型，条件必传（00: 借记卡 01: 贷记卡 02: 微信零钱 03: 支付宝花呗 04: 支付宝其他 05: 数字货币 06: 拉卡拉支付账户 99: 未知）
-		AccActivityId      string                 `json:"acc_activity_id"`      // 活动ID，条件必传（在账户端商户后台配置的批次ID）
-		TradeReqDate       string                 `json:"trade_req_date"`       // 交易请求日期，必传（yyyyMMdd）
-		AccRespFields      map[string]interface{} `json:"acc_resp_fields"`      // 账户端返回信息域，条件必传
+		} `json:"refund_split_info"` // 合单退款拆单信息，条件必传（如果查询订单是退款主单，则返回）
+		AccTradeNo             string                 `json:"acc_trade_no"`              // 账户端交易订单号，必传
+		AccountType            string                 `json:"account_type"`              // 钱包类型，必传（微信: WECHAT 支付宝: ALIPAY 银联: UQRCODEPAY 翼支付: BESTPAY 苏宁支付: SUNING）
+		TradeState             string                 `json:"trade_state"`               // 交易状态，必传（INIT-初始化 CREATE-下单成功 SUCCESS-交易成功 FAIL-交易失败 DEAL-交易处理中 UNKNOWN-未知状态 CLOSE-订单关闭 PART_REFUND-部分退款 REFUND-全部退款）
+		TradeStateDesc         string                 `json:"trade_state_desc"`          // 交易状态描述，条件必传
+		TotalAmount            string                 `json:"total_amount"`              // 订单金额，必传（单位分）
+		PayerAmount            string                 `json:"payer_amount"`              // 付款人实付金额，条件必传（单位分）
+		AccSettleAmount        string                 `json:"acc_settle_amount"`         // 账户端结算金额，条件必传（单位分）
+		AccMdiscountAmount     string                 `json:"acc_mdiscount_amount"`      // 商户侧优惠金额，条件必传（单位分）
+		AccDiscountAmount      string                 `json:"acc_discount_amount"`       // 账户端优惠金额，条件必传（单位分）
+		AccOtherDiscountAmount string                 `json:"acc_other_discount_amount"` // 账户端其它优惠金额，条件必传（单位分）
+		TradeTime              string                 `json:"trade_time"`                // 交易完成时间，条件必传（yyyyMMddHHmmss）
+		UserId1                string                 `json:"user_id1"`                  // 用户标识1，条件必传（微信sub_open_id 支付宝buyer_login_id 买家支付账号）
+		UserId2                string                 `json:"user_id2"`                  // 用户标识2，条件必传（微信open_id 支付宝buyer_user_id 银user_id）
+		BankType               string                 `json:"bank_type"`                 // 付款银行，条件必传
+		CardType               string                 `json:"card_type"`                 // 银行卡类型，条件必传（00: 借记卡 01: 贷记卡 02: 微信零钱 03: 支付宝花呗 04: 支付宝其他 05: 数字货币 06: 拉卡拉支付账户 99: 未知）
+		AccActivityId          string                 `json:"acc_activity_id"`           // 活动ID，条件必传（在账户端商户后台配置的批次ID）
+		TradeReqDate           string                 `json:"trade_req_date"`            // 交易请求日期，必传（yyyyMMdd）
+		AccRespFields          map[string]interface{} `json:"acc_resp_fields"`           // 账户端返回信息域，条件必传
 	} `json:"resp_data"` // 响应数据
 }

 func (t *TradeQueryResponse) SuccessOrFail() bool {
-	return t.Code == "000000"
+	return t.Code == "BBS00000"
 }
@@ -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"
+}
Author	SHA1	Message	Date
gaoda	deb2985747	feat(merchant): 新增微信实名认证结果查询功能 - 在 consts/url.go 中新增微信实名认证结果查询接口地址常量 - 在 lklsdk/merchant.go 中实现 WechatRealNameQuery 方法，用于发送实名认证查询请求 - 在 lklsdk/sdk.go 中暴露 WechatRealNameQuery 接口方法，方便外部调用 - 新增 model/wechatRealNameQuery.go 文件，定义微信实名认证查询相关的请求与响应结构体 - 实现 SuccessOrFail 方法判断微信实名认证查询是否成功	2025-12-12 15:51:30 +08:00
gaoda	0b902def62	fix(refund): 更新退款成功状态码判断逻辑 - 将退款成功状态码从"BBS0000"更改为"000000" - 确保与最新的退款接口响应格式保持一致	2025-12-10 10:18:56 +08:00
gaoda	c9fa888b05	fix(model): 更新退款和交易查询的成功状态判断码值 - 将 refund.go 中的成功状态码从 "000000" 修改为 "BBS00000" - 将 tradeQuery.go 中的成功状态码从 "00000" 修改为 "BBS00000" - 调整了 tradeQuery.go 中部分字段的注释格式以提高可读性	2025-12-09 15:18:01 +08:00
gaoda	ace91cc127	feat(preorder): 添加账户业务字段支持 - 在预下单模型中新增 AccBusiFields 字段 - 支持传递账户业务相关扩展信息 - 完善字段注释和结构体定义	2025-12-08 17:16:32 +08:00