新增电子合同相关接口及数据结构

添加电子合同申请、下载、状态查询、人工复核等功能模块
包含请求/响应数据结构及API实现
新增相关常量定义和类型

consts/ec.go

@@ -0,0 +1,42 @@
+package consts
+
+type ECType string
+
+const (
+	ECType001 ECType = "EC001" // EC001 : 特约商户支付服务合作协议V3.1(商户入网)
+	ECType002 ECType = "EC002" // EC002 : 特约商户支付服务合作协议V3.2（商户入网+分账）
+	ECType003 ECType = "EC003" // EC003 : 分账结算授权委托书
+	ECType004 ECType = "EC004" // EC004 : 特约商户支付服务合作协议V3.3（商户入网）
+	ECType005 ECType = "EC005" // EC005 : 特约商户支付服务合作协议V3.3（商户入网+分账）
+	ECType007 ECType = "EC007" // EC007 : 特约商户支付服务合作协议V4.1 + 结算授权委托书 (商户入网 + 分账 )
+	ECType008 ECType = "EC008" // EC008 : 特约商户支付服务合作协议V4.1 (商户入网)
+	ECType009 ECType = "EC009" // EC009 : 结算授权委托书
+)
+
+func (e ECType) Ptr() string {
+	return string(e)
+}
+
+type CertType string
+
+const (
+	CertType_RESIDENT_ID   CertType = "RESIDENT_ID"   // RESIDENT_ID（身份证)
+	CertType_PASSPORT      CertType = "PASSPORT"      // PASSPORT（护照）
+	CertType_HK_MACAO_PASS CertType = "HK_MACAO_PASS" // HK_MACAO_PASS（港澳居民往来内地通行证）
+	CertType_TAIWAN_PASS   CertType = "TAIWAN_PASS"   // TAIWAN_PASS（台湾居民来往大陆通行证）
+)
+
+func (c CertType) Ptr() string {
+	return string(c)
+}
+
+type AgentTag int
+
+const (
+	AgentTag0 AgentTag = iota // 0：不启用  缺省
+	AgentTag1  // 1: 启用
+)
+
+func (a AgentTag) Ptr() int {
+	return int(a)
+}

lklsdk/merchant/in_net/ec/apply/api.go

@@ -0,0 +1,47 @@
+package apply
+
+import (
+	"github.com/black1552/lkl_sdk/consts"
+	"github.com/black1552/lkl_sdk/lklsdk/common"
+	"github.com/gogf/gf/v2/os/gtime"
+)
+
+type Apply struct {
+	Client *common.Client[ECApplyResponse]
+}
+
+func NewEcApply(client *common.Client[ECApplyResponse]) *Apply {
+	return &Apply{
+		Client: client,
+	}
+}
+
+// ECApply 电子合同申请
+// 提供与拉卡拉进行电子签约的第四方进行电子合同申请
+// 电子合同签约成功后不需要将其下载出来作为附件上传，只需将电子合同编号（ecNo）
+// 在“新增商户入网”接口中在（contractNo）字段中传入即可
+func (a *Apply) ECApply(req *ECApplyRequestData) (*ECApplyResponse, error) {
+	// 构建请求
+	baseReq := ECApplyRequest{
+		ReqTime: gtime.Now().Format("YmdHis"),
+		ReqData: req,
+		Version: "1.0",
+	}
+
+	return a.Client.DoRequest(consts.BASE_URL+consts.LKL_EC_APPLY, baseReq)
+}
+
+// ECApplyTest 电子合同申请（测试环境）
+// 提供与拉卡拉进行电子签约的第四方进行电子合同申请
+// 电子合同签约成功后不需要将其下载出来作为附件上传，只需将电子合同编号（ecNo）
+// 在“新增商户入网”接口中在（contractNo）字段中传入即可
+func (a *Apply) ECApplyTest(req *ECApplyRequestData) (*ECApplyResponse, error) {
+	// 构建请求
+	baseReq := ECApplyRequest{
+		ReqTime: gtime.Now().Format("YmdHis"),
+		ReqData: req,
+		Version: "1.0",
+	}
+
+	return a.Client.DoRequest(consts.BASE_TEST_URL+consts.LKL_EC_APPLY, baseReq)
+}

lklsdk/merchant/in_net/ec/apply/request.go

@@ -0,0 +1,54 @@
+package apply
+
+import (
+	"github.com/black1552/lkl_sdk/consts"
+)
+
+// ECApplyRequestData 电子合同申请请求数据
+// 提供与拉卡拉进行电子签约的第四方进行电子合同申请
+// 电子合同签约成功后不需要将其下载出来作为附件上传，只需将电子合同编号（ecNo）
+// 在“新增商户入网”接口中在（contractNo）字段中传入即可
+// 合同类别适用业务场景说明：
+// EC001: 特约商户支付服务合作协议V3.1(商户入网) - 历史存量，推荐使用EC008
+// EC002: 特约商户支付服务合作协议V3.2+分账结算授权委托书 - 历史存量，推荐使用EC007
+// EC003: 分账结算授权委托书 - 历史存量，推荐使用EC009
+// EC004: 特约商户支付服务合作协议V3.3(商户入网) - 历史存量，推荐使用EC008
+// EC005: 特约商户支付服务合作协议V3.3+分账结算授权委托书 - 历史存量，推荐使用EC007
+// EC007: 特约商户支付服务合作协议V4.1+分账结算授权委托书(商户入网+分账业务) - 当前最新版本
+// EC008: 特约商户支付服务合作协议V4.1(商户入网) - 当前最新版本
+// EC009: 清分结算授权委托书(分账业务) - 当前最新版本
+type ECApplyRequestData struct {
+	OrderNo             string              `json:"order_no" dc:"四方机构自定义订单编号 必选，建议：平台编号+14位年月日时分秒+8位的随机数"`                                                          // 必选，建议：平台编号+14位年月日时分秒+8位的随机数
+	OrgID               int                 `json:"org_id" dc:"机构号 必选，签约方所属拉卡拉机构"`                                                                                  // 必选，签约方所属拉卡拉机构
+	EcTypeCode          consts.ECType       `json:"ec_type_code" dc:"合同类别 必选，合同类别编码"`                                                                               // 必选，合同类别编码
+	CertType            consts.CertType     `json:"cert_type" dc:"法人/经营者证件类型 必选，RESIDENT_ID（身份证）；PASSPORT（护照）；HK_MACAO_PASS（港澳居民往来内地通行证）；TAIWAN_PASS（台湾居民来往大陆通行证）"` // 必选，RESIDENT_ID（身份证）；PASSPORT（护照）；HK_MACAO_PASS（港澳居民往来内地通行证）；TAIWAN_PASS（台湾居民来往大陆通行证）
+	CertName            string              `json:"cert_name" dc:"法人/经营者姓名 必选"`                                                                                     // 必选
+	CertNo              string              `json:"cert_no" dc:"法人/经营者证件号码 必选"`                                                                                     // 必选
+	Mobile              string              `json:"mobile" dc:"签约手机号 必选，小微个人商户必须填写经营者本人手机号；个体工商户或企业商户必须填写法人手机号或者经办人手机号"`                                            // 必选，小微个人商户必须填写经营者本人手机号；个体工商户或企业商户必须填写法人手机号或者经办人手机号
+	BusinessLicenseNo   string              `json:"business_license_no" dc:"营业执照号 可选，个体工商户或企业商户必传"`                                                                 // 可选，个体工商户或企业商户必传
+	BusinessLicenseName string              `json:"business_license_name" dc:"营业执照名称 可选，个体工商户或企业商户必传"`                                                              // 可选，个体工商户或企业商户必传
+	OpenningBankCode    string              `json:"openning_bank_code" dc:"企业/经营者结算开户行号 必选"`                                                                        // 必选
+	OpenningBankName    string              `json:"openning_bank_name" dc:"企业/经营者结算开户行名称 必选"`                                                                       // 必选
+	AcctTypeCode        consts.AcctTypeCode `json:"acct_type_code" dc:"企业/经营者结算卡性质 必选，57 对公、 58 对私"`                                                                // 必选，57 对公、 58 对私
+	AcctNo              string              `json:"acct_no" dc:"企业/经营者结算卡号 必选"`                                                                                     // 必选
+	AcctName            string              `json:"acct_name" dc:"企业/经营者结算卡名称 必选"`                                                                                  // 必选
+	EcContentParameters string              `json:"ec_content_parameters" dc:"电子合同内容参数集合 必选，JSON字符串"`                                                               // 必选，JSON字符串
+	AgentTag            consts.AgentTag     `json:"agent_tag" dc:"是否经办签约 可选，0 不启用 1启用，缺省 0"`                                                                        // 可选，0 不启用 1启用，缺省 0
+	AgentName           string              `json:"agent_name" dc:"经办人名称 可选，agentTag为1时必传"`                                                                         // 可选，agentTag为1时必传
+	AgentCertType       consts.CertType     `json:"agent_cert_type" dc:"经办人证件类型 可选，agentTag为1时必传"`                                                                  // 可选，agentTag为1时必传
+	AgentCertNo         string              `json:"agent_cert_no" dc:"经办人证件号 可选，agentTag为1时必传"`                                                                     // 可选，agentTag为1时必传
+	AgentFileName       string              `json:"agent_file_name" dc:"经办签约授权委托书文件名 可选，agentTag为1时必传"`                                                             // 可选，agentTag为1时必传
+	AgentFilePath       string              `json:"agent_file_path" dc:"经办授权委托书文件路径 可选，agentTag为1时必传"`                                                              // 可选，agentTag为1时必传
+	Remark              string              `json:"remark" dc:"备注说明 可选"`                                                                                            // 可选
+	RetUrl              string              `json:"ret_url" dc:"电子合同签约结果回调通知 可选，成功签约才通知"`                                                                           // 可选，成功签约才通知
+}
+
+// ECApplyRequest 电子合同申请请求
+// 请求URL：
+// 测试环境：https://test.wsmsd.cn/sit/api/v3/mms/open_api/ec/apply
+// 生产环境：https://s2.lakala.com/api/v3/mms/open_api/ec/apply
+type ECApplyRequest struct {
+	ReqTime string              `json:"req_time" dc:"请求时间"` // 必选，格式：yyyyMMddHHmmss
+	ReqData *ECApplyRequestData `json:"req_data" dc:"请求数据"` // 请求数据
+	Version string              `json:"version" dc:"版本号"`   // 必选，固定值：1.0
+}

lklsdk/merchant/in_net/ec/apply/response.go

@@ -0,0 +1,20 @@
+package apply
+
+// ECApplyResponseData 电子合同申请响应数据
+type ECApplyResponseData struct {
+	OrderNo   string `json:"order_no" dc:"请求上送的订单号"`         // 请求上送的订单号
+	EcApplyID int64  `json:"ec_apply_id" dc:"电子签约申请受理编号"`    // 电子签约申请受理编号
+	ResultUrl string `json:"result_url" dc:"电子签约申请结果H5链接地址"` // 申请成功时：待签约合同H5链接；申请失败时：错误信息结果H5链接
+}
+
+// ECApplyResponse 电子合同申请响应
+type ECApplyResponse struct {
+	Code     string               `json:"code" dc:"返回码"`         // 成功 000000 其它失败
+	Msg      string               `json:"msg" dc:"返回码描述"`        // 返回码描述
+	RespData *ECApplyResponseData `json:"resp_data" dc:"结果信息集合"` // 结果信息集合
+	RespTime string               `json:"resp_time" dc:"响应时间"`   // 格式：yyyyMMddHHmmss
+}
+
+func (r *ECApplyResponse) SuccessOfFail() bool {
+	return r.Code == "000000"
+}

lklsdk/merchant/in_net/ec/applymanual/api.go

@@ -0,0 +1,41 @@
+package applymanual
+
+import (
+	"github.com/black1552/lkl_sdk/consts"
+	"github.com/black1552/lkl_sdk/lklsdk/common"
+	"github.com/gogf/gf/v2/os/gtime"
+)
+
+// ApplyManual 电子合同人工复核申请服务
+type ApplyManual struct {
+	Client *common.Client[ECApplyManualResponse]
+}
+
+// NewApplyManual 创建新的电子合同人工复核申请服务
+func NewApplyManual(client *common.Client[ECApplyManualResponse]) *ApplyManual {
+	return &ApplyManual{
+		Client: client,
+	}
+}
+
+// ECApplyManual 电子合同人工复核申请（生产环境）
+func (a *ApplyManual) ECApplyManual(req *ECApplyManualRequestData) (*ECApplyManualResponse, error) {
+	// 创建请求对象
+	request := ECApplyManualRequest{
+		ReqTime: gtime.Now().Format("YmdHis"),
+		ReqData: req,
+		Version: "1.0",
+	}
+	return a.Client.DoRequest(consts.BASE_URL+consts.LKL_EC_APPLY_MANUAL, request)
+}
+
+// ECApplyManualTest 电子合同人工复核申请（测试环境）
+func (a *ApplyManual) ECApplyManualTest(req *ECApplyManualRequestData) (*ECApplyManualResponse, error) {
+	// 创建请求对象
+	request := ECApplyManualRequest{
+		ReqTime: gtime.Now().Format("YmdHis"),
+		ReqData: req,
+		Version: "1.0",
+	}
+	return a.Client.DoRequest(consts.BASE_TEST_URL+consts.LKL_EC_APPLY_MANUAL, request)
+}

lklsdk/merchant/in_net/ec/applymanual/request.go

@@ -0,0 +1,27 @@
+package applymanual
+
+// ECApplyManualRequestData 电子合同人工复核申请请求数据结构体
+type ECApplyManualRequestData struct {
+	Version   string        `json:"version"`           // 版本号，默认1.0
+	OrderNo   string        `json:"order_no"`          // 四方机构自定义订单编号，必填，建议平台编号+14位年月日时分秒+8位随机数
+	OrgID     int           `json:"org_id"`            // 机构号，必填，签约方所属拉卡拉机构
+	EcApplyID string        `json:"ec_apply_id"`       // 电子合同申请受理号，必填，申请接口反馈编号
+	ApplyDesc string        `json:"apply_desc"`        // 申请说明，必填，复议提交的原因说明
+	FileData  []*ECFileData `json:"file_data"`         // 附件信息集合，必填，提供给审核人员核对信息
+	RetURL    string        `json:"ret_url,omitempty"` // 回调地址，可选
+}
+
+// ECFileData 附件信息结构体
+type ECFileData struct {
+	AttachType      string `json:"attach_type"`       // 附件类型，必填，枚举值见文档
+	AttachName      string `json:"attach_name"`       // 附件名称，必填，最大32字符
+	AttachExtName   string `json:"attach_ext_name"`   // 附件格式，必填，jpg、pdf等
+	AttachStorePath string `json:"attach_store_path"` // 附件坐标URL，必填，如G1/M00/00/61/CrFdEl3IyceAVVd8AAA0ADuZsA0911.jpg
+}
+
+// ECApplyManualRequest 电子合同人工复核申请请求结构体
+type ECApplyManualRequest struct {
+	ReqTime string                    `json:"req_time"` // 请求时间
+	ReqData *ECApplyManualRequestData `json:"req_data"` // 请求数据
+	Version string                    `json:"version"`  // 接口版本号
+}

lklsdk/merchant/in_net/ec/applymanual/response.go

@@ -0,0 +1,19 @@
+package applymanual
+
+// ECApplyManualResponseData 电子合同人工复核申请响应数据结构体
+type ECApplyManualResponseData struct {
+	// 响应数据为空对象，根据API文档，成功时返回空的resp_data
+}
+
+// ECApplyManualResponse 电子合同人工复核申请响应结构体
+type ECApplyManualResponse struct {
+	Code     string                  `json:"code"`     // 返回码，成功为000000，其他为失败
+	Msg      string                  `json:"msg"`      // 返回码描述
+	RespData ECApplyManualResponseData `json:"resp_data"` // 响应数据
+}
+
+// SuccessOfFail 检查响应是否成功
+// 返回true表示成功，false表示失败
+func (r *ECApplyManualResponse) SuccessOfFail() bool {
+	return r.Code == "000000"
+}

lklsdk/merchant/in_net/ec/download/api.go

@@ -0,0 +1,46 @@
+package download
+
+import (
+	"github.com/black1552/lkl_sdk/consts"
+	"github.com/black1552/lkl_sdk/lklsdk/common"
+	"github.com/gogf/gf/v2/os/gtime"
+)
+
+type Download struct {
+	Client *common.Client[ECDownloadResponse]
+}
+
+// NewDownload 创建电子合同下载服务实例
+func NewDownload(client *common.Client[ECDownloadResponse]) *Download {
+	return &Download{
+		Client: client,
+	}
+}
+
+// ECDownload 电子合同下载
+// 提供已完成的签约电子合同下载
+func (d *Download) ECDownload(req *ECDownloadRequestData) (*ECDownloadResponse, error) {
+	// 构建请求
+	baseReq := ECDownloadRequest{
+		ReqTime: gtime.Now().Format("YmdHis"),
+		ReqData: req,
+		Version: "1.0",
+	}
+
+	// 使用生产环境URL
+	return d.Client.DoRequest(consts.BASE_URL+consts.LKL_EC_DOWNLOAD, baseReq)
+}
+
+// ECDownloadTest 电子合同下载（测试环境）
+// 提供已完成的签约电子合同下载
+func (d *Download) ECDownloadTest(req *ECDownloadRequestData) (*ECDownloadResponse, error) {
+	// 构建请求
+	baseReq := ECDownloadRequest{
+		ReqTime: gtime.Now().Format("YmdHis"),
+		ReqData: req,
+		Version: "1.0",
+	}
+
+	// 使用测试环境URL
+	return d.Client.DoRequest(consts.BASE_TEST_URL+consts.LKL_EC_DOWNLOAD, baseReq)
+}

lklsdk/merchant/in_net/ec/download/request.go

@@ -0,0 +1,15 @@
+package download
+
+// ECDownloadRequestData 电子合同下载请求数据
+type ECDownloadRequestData struct {
+	OrderNo   string `json:"order_no" dc:"四方机构自定义订单编号"`   // 四方机构自定义订单编号
+	OrgCode   int    `json:"org_code" dc:"机构号"`   // 机构号
+	EcApplyID int64  `json:"ec_apply_id" dc:"电子合同申请受理号"` // 电子合同申请受理号
+}
+
+// ECDownloadRequest 电子合同下载请求结构
+type ECDownloadRequest struct {
+	ReqTime string               `json:"req_time"` // 请求时间
+	ReqData *ECDownloadRequestData `json:"req_data"` // 请求数据
+	Version string               `json:"version"`  // 接口版本号
+}

lklsdk/merchant/in_net/ec/download/response.go

@@ -0,0 +1,22 @@
+package download
+
+// ECDownloadResponseData 电子合同下载响应数据
+type ECDownloadResponseData struct {
+	OrderNo   string `json:"order_no"`   // 请求上送的订单号
+	EcApplyID int64  `json:"ec_apply_id"` // 电子签约申请受理编号
+	EcStatus  string `json:"ec_status"`  // 电子合同状态: UNDONE 未完成, COMPLETED 已完成
+	EcNo      string `json:"ec_no"`      // 电子合同号（合同状态为COMPLETED时返回）
+	EcFile    string `json:"ec_file"`    // 电子合同pdf文件(base64格式字符，合同状态为COMPLETED时返回)
+}
+
+// ECDownloadResponse 电子合同下载响应结构
+type ECDownloadResponse struct {
+	Code     string               `json:"code"`      // 返回码
+	Msg      string               `json:"msg"`       // 返回码描述
+	RespData *ECDownloadResponseData `json:"resp_data"` // 结果信息集合
+}
+
+// SuccessOfFail 检查响应是否成功
+func (r *ECDownloadResponse) SuccessOfFail() bool {
+	return r.Code == "000000"
+}

lklsdk/merchant/in_net/ec/qmastatus/api.go

@@ -0,0 +1,39 @@
+package qmastatus
+
+import (
+	"github.com/black1552/lkl_sdk/consts"
+	"github.com/black1552/lkl_sdk/lklsdk/common"
+	"github.com/gogf/gf/v2/os/gtime"
+)
+
+// QmaStatus 电子合同人工复核结果查询服务
+type QmaStatus struct {
+	Client *common.Client[ECQmaStatusResponse]
+}
+
+// NewQmaStatus 创建新的电子合同人工复核结果查询服务
+func NewQmaStatus(client *common.Client[ECQmaStatusResponse]) *QmaStatus {
+	return &QmaStatus{Client: client}
+}
+
+// ECQmaStatus 电子合同人工复核结果查询（生产环境）
+func (q *QmaStatus) ECQmaStatus(req *ECQmaStatusRequestData) (*ECQmaStatusResponse, error) {
+	// 创建请求对象
+	request := ECQmaStatusRequest{
+		ReqTime: gtime.Now().Format("YmdHis"),
+		ReqData: req,
+		Version: "1.0",
+	}
+	return q.Client.DoRequest(consts.BASE_URL+consts.LKL_EC_QMA_STATUS, request)
+}
+
+// ECQmaStatusTest 电子合同人工复核结果查询（测试环境）
+func (q *QmaStatus) ECQmaStatusTest(req *ECQmaStatusRequestData) (*ECQmaStatusResponse, error) {
+	// 创建请求对象
+	request := ECQmaStatusRequest{
+		ReqTime: gtime.Now().Format("YmdHis"),
+		ReqData: req,
+		Version: "1.0",
+	}
+	return q.Client.DoRequest(consts.BASE_TEST_URL+consts.LKL_EC_QMA_STATUS, request)
+}

lklsdk/merchant/in_net/ec/qmastatus/request.go

@@ -0,0 +1,16 @@
+package qmastatus
+
+// ECQmaStatusRequestData 电子合同人工复核结果查询请求数据结构体
+type ECQmaStatusRequestData struct {
+	Version   string `json:"version"`   // 版本号，默认1.0
+	OrderNo   string `json:"order_no"`  // 四方机构自定义订单编号，必填，建议平台编号+14位年月日时分秒+8位随机数
+	OrgID     int    `json:"org_id"`    // 机构号，必填，签约方所属拉卡拉机构
+	EcApplyID string `json:"ec_apply_id"` // 电子合同申请受理号，必填，申请接口反馈编号
+}
+
+// ECQmaStatusRequest 电子合同人工复核结果查询请求结构体
+type ECQmaStatusRequest struct {
+	ReqTime string                  `json:"req_time"` // 请求时间
+	ReqData *ECQmaStatusRequestData `json:"req_data"` // 请求数据
+	Version string                  `json:"version"`  // 接口版本号
+}

lklsdk/merchant/in_net/ec/qmastatus/response.go

@@ -0,0 +1,25 @@
+package qmastatus
+
+// ECQmaStatusResponseData 电子合同人工复核结果查询响应数据结构体
+type ECQmaStatusResponseData struct {
+	Version        string `json:"version"`         // 版本号
+	OrderNo        string `json:"order_no"`        // 四方机构自定义订单编号
+	OrgID          int    `json:"org_id"`          // 机构号
+	EcApplyID      string `json:"ec_apply_id"`     // 电子合同申请受理号
+	AuditStatus    string `json:"audit_status"`    // 人工审核状态：WAIT_AUDIT待审核、PASS审核通过、REFUSE审核拒绝、CLOSE审核关闭
+	AuditDesc      string `json:"audit_desc"`      // 人工审核结果说明
+	SignH5URL      string `json:"sign_h5_url"`     // 签约H5地址，审核通过时返回
+	SignH5URLExpTm string `json:"sign_h5_url_exp_tm"` // 签约H5地址过期时间，审核通过时返回
+}
+
+// ECQmaStatusResponse 电子合同人工复核结果查询响应结构体
+type ECQmaStatusResponse struct {
+	Code     string                  `json:"code"`      // 返回码，成功000000，其它失败
+	Msg      string                  `json:"msg"`       // 返回码描述
+	RespData *ECQmaStatusResponseData `json:"resp_data"` // 响应数据
+}
+
+// SuccessOfFail 判断响应是否成功
+func (r *ECQmaStatusResponse) SuccessOfFail() bool {
+	return r != nil && r.Code == "000000"
+}

lklsdk/merchant/in_net/ec/querystatus/api.go

@@ -0,0 +1,46 @@
+package querystatus
+
+import (
+	"github.com/black1552/lkl_sdk/consts"
+	"github.com/black1552/lkl_sdk/lklsdk/common"
+	"github.com/gogf/gf/v2/os/gtime"
+)
+
+type QStatus struct {
+	Client *common.Client[ECQueryStatusResponse]
+}
+
+// NewQStatus 创建电子合同查询状态服务实例
+func NewQStatus(client *common.Client[ECQueryStatusResponse]) *QStatus {
+	return &QStatus{
+		Client: client,
+	}
+}
+
+// QueryStatus 电子合同查询状态
+// 提供申请过与拉卡拉电子签约用户查询电子合同签署状态
+func (q *QStatus) QueryStatus(req *ECQueryStatusRequestData) (*ECQueryStatusResponse, error) {
+	// 构建请求
+	baseReq := ECQueryStatusRequest{
+		ReqTime: gtime.Now().Format("YmdHis"),
+		ReqData: req,
+		Version: "1.0",
+	}
+
+	// 使用生产环境URL
+	return q.Client.DoRequest(consts.BASE_URL+consts.LKL_EC_QUERY_STATUS, baseReq)
+}
+
+// QueryStatusTest 电子合同查询状态（测试环境）
+// 提供申请过与拉卡拉电子签约用户查询电子合同签署状态
+func (q *QStatus) QueryStatusTest(req *ECQueryStatusRequestData) (*ECQueryStatusResponse, error) {
+	// 构建请求
+	baseReq := ECQueryStatusRequest{
+		ReqTime: gtime.Now().Format("YmdHis"),
+		ReqData: req,
+		Version: "1.0",
+	}
+
+	// 使用测试环境URL
+	return q.Client.DoRequest(consts.BASE_TEST_URL+consts.LKL_EC_QUERY_STATUS, baseReq)
+}

lklsdk/merchant/in_net/ec/querystatus/request.go

@@ -0,0 +1,19 @@
+package querystatus
+
+// ECQueryStatusRequestData 电子合同查询状态请求数据
+// 提供申请过与拉卡拉电子签约用户查询电子合同签署状态
+// 请求URL：
+// 测试环境：https://test.wsmsd.cn/sit/api/v3/mms/open_api/ec/q_status
+// 生产环境：https://s2.lakala.com/api/v3/mms/open_api/ec/q_status
+type ECQueryStatusRequestData struct {
+	OrderNo   string `json:"order_no" dc:"四方机构自定义订单编号 必选，建议：平台编号+14位年月日时（24小时制）分秒+8位的随机数（同一接入机构不重复）"` // 必选，建议：平台编号+14位年月日时（24小时制）分秒+8位的随机数（同一接入机构不重复）
+	OrgID     int    `json:"org_id" dc:"机构号 必选，签约方所属拉卡拉机构"`                                     // 必选，签约方所属拉卡拉机构
+	EcApplyID int64  `json:"ec_apply_id" dc:"电子合同申请受理号 必选，申请接口反馈编号"`                               // 必选，申请接口反馈编号
+}
+
+// ECQueryStatusRequest 电子合同查询状态请求
+type ECQueryStatusRequest struct {
+	ReqTime string                    `json:"req_time" dc:"请求时间"` // 必选，格式：yyyyMMddHHmmss
+	ReqData *ECQueryStatusRequestData `json:"req_data" dc:"请求数据"` // 请求数据
+	Version string                    `json:"version" dc:"版本号"`   // 必选，固定值：1.0
+}

lklsdk/merchant/in_net/ec/querystatus/response.go

@@ -0,0 +1,22 @@
+package querystatus
+
+// ECQueryStatusResponseData 电子合同查询状态响应数据
+type ECQueryStatusResponseData struct {
+	OrderNo   string `json:"order_no" dc:"请求上送的订单号"`               // 请求上送的订单号
+	EcApplyID int64  `json:"ec_apply_id" dc:"电子签约申请受理编号"`          // 电子签约申请受理编号
+	EcStatus  string `json:"ec_status" dc:"电子合同签署状态"`               // 电子合同签署状态，UNDONE 未完成，COMPLETED 已完成
+	EcNo      string `json:"ec_no" dc:"电子合同号"`                       // 签署完成反馈
+}
+
+// ECQueryStatusResponse 电子合同查询状态响应
+type ECQueryStatusResponse struct {
+	Code     string                     `json:"code" dc:"返回码"`         // 成功 000000 其它失败
+	Msg      string                     `json:"msg" dc:"返回码描述"`        // 返回码描述
+	RespData *ECQueryStatusResponseData `json:"resp_data" dc:"结果信息集合"` // 结果信息集合
+	RespTime string                     `json:"resp_time" dc:"响应时间"`   // 格式：yyyyMMddHHmmss
+}
+
+// SuccessOfFail 检查响应是否成功
+func (r *ECQueryStatusResponse) SuccessOfFail() bool {
+	return r.Code == "000000"
+}