feat: create mini program virtual payment (#709 )

feat:企业微信-客户联系-客户朋友圈 (#702 )
* feat:企业微信-客户联系-客户朋友圈 * fix:golangci-lint --------- Co-authored-by: markwang <www.wang61@qq.com>
2026-02-23 13:42:25 +08:00 · 2023-08-21 22:09:30 +08:00 · 2023-07-31 19:32:34 +08:00 · 2023-07-15 23:58:24 +08:00 · 2023-07-15 23:56:53 +08:00
15 changed files with 2204 additions and 27 deletions
--- a/miniprogram/README.md
+++ b/miniprogram/README.md
@@ -4,7 +4,7 @@

 ## 包说明

- analysis 数据分析相关API
+- analysis 数据分析相关 API

 ## 快速入门

@@ -18,4 +18,35 @@ cfg := &miniConfig.Config{
 }
 miniprogram := wc.GetMiniProgram(cfg)
 miniprogram.GetAnalysis().GetAnalysisDailyRetain()
+```
+
+### 小程序虚拟支付 
+#### `注意：需要传入 Appkey 的值`
+相关文档：[小程序虚拟支付](https://developers.weixin.qq.com/miniprogram/dev/platform-capabilities/industry/virtual-payment.html)
+```go
+wc := wechat.NewWechat()
+miniprogram := wc.GetMiniProgram(&miniConfig.Config{
+    AppID:     "xxx",
+    AppSecret: "xxx",
+    AppKey:    "xxx",
+    Cache: cache.NewRedis(&redis.Options{
+        Addr: "",
+    }),
+})
+virtualPayment := miniprogram.GetVirtualPayment()
+virtualPayment.SetSessionKey("xxx")
+// 查询用户余额
+var (
+    res *virtualPayment.QueryUserBalanceResponse
+    err error
+)
+
+if res, err = virtualPayment.QueryUserBalance(context.TODO(), &virtualPayment.QueryUserBalanceRequest{
+    OpenID: "xxx",
+    Env: virtualPayment.EnvProduction,
+    UserIP: "xxx",
+}); err != nil {
+    panic(err)
+}
+
 ```
--- a/miniprogram/config/config.go
+++ b/miniprogram/config/config.go
@@ -1,4 +1,4 @@
-// Package config 小程序config配置
+// Package config 小程序 config 配置
 package config

 import (
@@ -9,5 +9,6 @@ import (
 type Config struct {
 	AppID     string `json:"app_id"`     // appid
 	AppSecret string `json:"app_secret"` // appSecret
+	AppKey    string `json:"app_key"`    // appKey
 	Cache     cache.Cache
 }
--- a/miniprogram/miniprogram.go
+++ b/miniprogram/miniprogram.go
@@ -20,15 +20,16 @@ import (
 	"github.com/silenceper/wechat/v2/miniprogram/tcb"
 	"github.com/silenceper/wechat/v2/miniprogram/urllink"
 	"github.com/silenceper/wechat/v2/miniprogram/urlscheme"
+	"github.com/silenceper/wechat/v2/miniprogram/virtualpayment"
 	"github.com/silenceper/wechat/v2/miniprogram/werun"
 )

-// MiniProgram 微信小程序相关API
+// MiniProgram 微信小程序相关 API
 type MiniProgram struct {
 	ctx *context.Context
 }

-// NewMiniProgram 实例化小程序API
+// NewMiniProgram 实例化小程序 API
 func NewMiniProgram(cfg *config.Config) *MiniProgram {
 	defaultAkHandle := credential.NewDefaultAccessToken(cfg.AppID, cfg.AppSecret, credential.CacheKeyMiniProgramPrefix, cfg.Cache)
 	ctx := &context.Context{
@@ -38,7 +39,7 @@ func NewMiniProgram(cfg *config.Config) *MiniProgram {
 	return &MiniProgram{ctx}
 }

-// SetAccessTokenHandle 自定义access_token获取方式
+// SetAccessTokenHandle 自定义 access_token 获取方式
 func (miniProgram *MiniProgram) SetAccessTokenHandle(accessTokenHandle credential.AccessTokenHandle) {
 	miniProgram.ctx.AccessTokenHandle = accessTokenHandle
 }
@@ -68,17 +69,17 @@ func (miniProgram *MiniProgram) GetBusiness() *business.Business {
 	return business.NewBusiness(miniProgram.ctx)
 }

-// GetPrivacy 小程序隐私协议相关API
+// GetPrivacy 小程序隐私协议相关 API
 func (miniProgram *MiniProgram) GetPrivacy() *privacy.Privacy {
 	return privacy.NewPrivacy(miniProgram.ctx)
 }

-// GetQRCode 小程序码相关API
+// GetQRCode 小程序码相关 API
 func (miniProgram *MiniProgram) GetQRCode() *qrcode.QRCode {
 	return qrcode.NewQRCode(miniProgram.ctx)
 }

-// GetTcb 小程序云开发API
+// GetTcb 小程序云开发 API
 func (miniProgram *MiniProgram) GetTcb() *tcb.Tcb {
 	return tcb.NewTcb(miniProgram.ctx)
 }
@@ -103,7 +104,7 @@ func (miniProgram *MiniProgram) GetContentSecurity() *content.Content {
 	return content.NewContent(miniProgram.ctx)
 }

-// GetURLLink 小程序URL Link接口
+// GetURLLink 小程序 URL Link 接口
 func (miniProgram *MiniProgram) GetURLLink() *urllink.URLLink {
 	return urllink.NewURLLink(miniProgram.ctx)
 }
@@ -123,12 +124,17 @@ func (miniProgram *MiniProgram) GetShortLink() *shortlink.ShortLink {
 	return shortlink.NewShortLink(miniProgram.ctx)
 }

-// GetSURLScheme 小程序URL Scheme接口
+// GetSURLScheme 小程序 URL Scheme 接口
 func (miniProgram *MiniProgram) GetSURLScheme() *urlscheme.URLScheme {
 	return urlscheme.NewURLScheme(miniProgram.ctx)
 }

-// GetOpenAPI openApi管理接口
+// GetOpenAPI openApi 管理接口
 func (miniProgram *MiniProgram) GetOpenAPI() *openapi.OpenAPI {
 	return openapi.NewOpenAPI(miniProgram.ctx)
 }
+
+// GetVirtualPayment 小程序虚拟支付
+func (miniProgram *MiniProgram) GetVirtualPayment() *virtualpayment.VirtualPayment {
+	return virtualpayment.NewVirtualPayment(miniProgram.ctx)
+}
--- a/miniprogram/shortlink/shortlink.go
+++ b/miniprogram/shortlink/shortlink.go
@@ -24,10 +24,10 @@ func NewShortLink(ctx *context.Context) *ShortLink {
 // ShortLinker 请求结构体
 type ShortLinker struct {

-	// pageUrl 通过 Short Link 进入的小程序页面路径，必须是已经发布的小程序存在的页面，可携带 query，最大1024个字符
+	// pageUrl 通过 Short Link 进入的小程序页面路径，必须是已经发布的小程序存在的页面，可携带 query，最大 1024 个字符
 	PageURL string `json:"page_url"`

-	// pageTitle 页面标题，不能包含违法信息，超过20字符会用... 截断代替
+	// pageTitle 页面标题，不能包含违法信息，超过 20 字符会用... 截断代替
 	PageTitle string `json:"page_title"`

 	// isPermanent 生成的 Short Link 类型，短期有效：false，永久有效：true
@@ -67,7 +67,7 @@ func (shortLink *ShortLink) generate(shortLinkParams ShortLinker) (string, error
 	return res.Link, nil
 }

-// GenerateShortLinkPermanent 生成永久shortLink
+// GenerateShortLinkPermanent 生成永久 shortLink
 func (shortLink *ShortLink) GenerateShortLinkPermanent(PageURL, pageTitle string) (string, error) {
 	return shortLink.generate(ShortLinker{
 		PageURL:     PageURL,
@@ -76,7 +76,7 @@ func (shortLink *ShortLink) GenerateShortLinkPermanent(PageURL, pageTitle string
 	})
 }

-// GenerateShortLinkTemp 生成临时shortLink
+// GenerateShortLinkTemp 生成临时 shortLink
 func (shortLink *ShortLink) GenerateShortLinkTemp(PageURL, pageTitle string) (string, error) {
 	return shortLink.generate(ShortLinker{
 		PageURL:     PageURL,
--- a/miniprogram/virtualpayment/constant.go
+++ b/miniprogram/virtualpayment/constant.go
@@ -0,0 +1,134 @@
+/*
+ *   Copyright silenceper/wechat Author(https://silenceper.com/wechat/). All Rights Reserved.
+ *
+ *   Licensed under the Apache License, Version 2.0 (the "License");
+ *   you may not use this file except in compliance with the License.
+ *   You may obtain a copy of the License at
+ *
+ *       http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *   Unless required by applicable law or agreed to in writing, software
+ *   distributed under the License is distributed on an "AS IS" BASIS,
+ *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *   See the License for the specific language governing permissions and
+ *   limitations under the License.
+ *
+ *   You can obtain one at https://github.com/silenceper/wechat.
+ *
+ */
+
+package virtualpayment
+
+const (
+	// EnvProduction 环境 0-正式环境 1-沙箱环境
+	EnvProduction Env = 0
+	// EnvSandbox 环境 0-正式环境 1-沙箱环境
+	EnvSandbox Env = 1
+)
+
+const (
+	// Success 错误码 0、成功
+	Success ErrCode = 0
+	// SystemError 错误码 -1、系统错误
+	SystemError ErrCode = -1
+	// OpenIDError 错误码 268490001、openid 错误
+	OpenIDError ErrCode = 268490001
+	// RequestParamError 错误码 268490002、请求参数字段错误，具体看 errmsg
+	RequestParamError ErrCode = 268490002
+	// SignError 错误码 268490003、签名错误
+	SignError ErrCode = 268490003
+	// RepeatOperationError 错误码 268490004、重复操作（赠送和代币支付相关接口会返回，表示之前的操作已经成功）
+	RepeatOperationError ErrCode = 268490004
+	// OrderRefundedError 错误码 268490005、订单已经通过 cancel_currency_pay 接口退款，不支持再退款
+	OrderRefundedError ErrCode = 268490005
+	// InsufficientBalanceError 错误码 268490006、代币的退款/支付操作金额不足
+	InsufficientBalanceError ErrCode = 268490006
+	// SensitiveContentError 错误码 268490007、图片或文字存在敏感内容，禁止使用
+	SensitiveContentError ErrCode = 268490007
+	// TokenNotPublishedError 错误码 268490008、代币未发布，不允许进行代币操作
+	TokenNotPublishedError ErrCode = 268490008
+	// SessionKeyExpiredError 错误码 268490009、用户 session_key 不存在或已过期，请重新登录
+	SessionKeyExpiredError ErrCode = 268490009
+	// BillGeneratingError 错误码 268490011、账单数据生成中，请稍后调用本接口获取
+	BillGeneratingError ErrCode = 268490011
+)
+
+const (
+	// OrderStatusInit 订单状态 当前状态 0-订单初始化（未创建成功，不可用于支付）
+	OrderStatusInit OrderStatus = 0
+	// OrderStatusCreated 订单状态 当前状态 1-订单创建成功
+	OrderStatusCreated OrderStatus = 1
+	// OrderStatusPaid 订单状态 当前状态  2-订单已经支付，待发货
+	OrderStatusPaid OrderStatus = 2
+	// OrderStatusDelivering 订单状态 当前状态 3-订单发货中
+	OrderStatusDelivering OrderStatus = 3
+	// OrderStatusDelivered 订单状态 当前状态 4-订单已发货
+	OrderStatusDelivered OrderStatus = 4
+	// OrderStatusRefunded 订单状态 当前状态 5-订单已经退款
+	OrderStatusRefunded OrderStatus = 5
+	// OrderStatusClosed 订单状态 当前状态  6-订单已经关闭（不可再使用）
+	OrderStatusClosed OrderStatus = 6
+	// OrderStatusRefundFailed 订单状态 当前状态 7-订单退款失败
+	OrderStatusRefundFailed OrderStatus = 7
+)
+
+const (
+	// baseSite 基础网址
+	baseSite = "https://api.weixin.qq.com"
+
+	// queryUserBalance 查询虚拟支付余额
+	queryUserBalance = "/xpay/query_user_balance"
+
+	// currencyPay 扣减代币（一般用于代币支付）
+	currencyPay = "/xpay/currency_pay"
+
+	// queryOrder 查询创建的订单（现金单，非代币单）
+	queryOrder = "/xpay/query_order"
+
+	// cancelCurrencyPay 代币支付退款 (currency_pay 接口的逆操作)
+	cancelCurrencyPay = "/xpay/cancel_currency_pay"
+
+	// notifyProvideGoods 通知已经发货完成（只能通知现金单）,正常通过 xpay_goods_deliver_notify 消息推送返回成功就不需要调用这个 api 接口。这个接口用于异常情况推送不成功时手动将单改成已发货状态
+	notifyProvideGoods = "/xpay/notify_provide_goods"
+
+	// presentCurrency 代币赠送接口，由于目前不支付按单号查赠送单的功能，所以当需要赠送的时候可以一直重试到返回 0 或者返回 268490004（重复操作）为止
+	presentCurrency = "/xpay/present_currency"
+
+	// downloadBill 下载账单
+	downloadBill = "/xpay/download_bill"
+
+	// refundOrder 退款 对使用 jsapi 接口下的单进行退款
+	refundOrder = "/xpay/refund_order"
+
+	// createWithdrawOrder 创建提现单
+	createWithdrawOrder = "/xpay/create_withdraw_order"
+
+	// queryWithdrawOrder 查询提现单
+	queryWithdrawOrder = "/xpay/query_withdraw_order"
+
+	// startUploadGoods 启动批量上传道具任务
+	startUploadGoods = "/xpay/start_upload_goods"
+
+	// queryUploadGoods 查询批量上传道具任务状态
+	queryUploadGoods = "/xpay/query_upload_goods"
+
+	// startPublishGoods 启动批量发布道具任务
+	startPublishGoods = "/xpay/start_publish_goods"
+
+	// queryPublishGoods 查询批量发布道具任务状态
+	queryPublishGoods = "/xpay/query_publish_goods"
+)
+
+const (
+	// signature user mode signature
+	signature = "signature"
+
+	// paySignature payment signature
+	paySignature = "pay_sig"
+
+	// accessToken access_token authorization tokens
+	accessToken = "access_token"
+
+	// EmptyString empty string
+	EmptyString = ""
+)
--- a/miniprogram/virtualpayment/doc.go
+++ b/miniprogram/virtualpayment/doc.go
@@ -0,0 +1,32 @@
+/*
+ *   Copyright silenceper/wechat Author(https://silenceper.com/wechat/). All Rights Reserved.
+ *
+ *   Licensed under the Apache License, Version 2.0 (the "License");
+ *   you may not use this file except in compliance with the License.
+ *   You may obtain a copy of the License at
+ *
+ *       http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *   Unless required by applicable law or agreed to in writing, software
+ *   distributed under the License is distributed on an "AS IS" BASIS,
+ *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *   See the License for the specific language governing permissions and
+ *   limitations under the License.
+ *
+ *   You can obtain one at https://github.com/silenceper/wechat.
+ *
+ */
+
+// Package virtualpayment mini program virtual payment
+package virtualpayment
+
+import (
+	"github.com/silenceper/wechat/v2/miniprogram/context"
+)
+
+// NewVirtualPayment 实例化小程序虚拟支付 API
+func NewVirtualPayment(ctx *context.Context) *VirtualPayment {
+	return &VirtualPayment{
+		ctx: ctx,
+	}
+}
--- a/miniprogram/virtualpayment/domain.go
+++ b/miniprogram/virtualpayment/domain.go
@@ -0,0 +1,427 @@
+/*
+ *   Copyright silenceper/wechat Author(https://silenceper.com/wechat/). All Rights Reserved.
+ *
+ *   Licensed under the Apache License, Version 2.0 (the "License");
+ *   you may not use this file except in compliance with the License.
+ *   You may obtain a copy of the License at
+ *
+ *       http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *   Unless required by applicable law or agreed to in writing, software
+ *   distributed under the License is distributed on an "AS IS" BASIS,
+ *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *   See the License for the specific language governing permissions and
+ *   limitations under the License.
+ *
+ *   You can obtain one at https://github.com/silenceper/wechat.
+ *
+ */
+
+package virtualpayment
+
+import (
+	"github.com/silenceper/wechat/v2/miniprogram/context"
+	"github.com/silenceper/wechat/v2/util"
+)
+
+// VirtualPayment mini program virtual payment
+// https://developers.weixin.qq.com/miniprogram/dev/platform-capabilities/industry/virtual-payment.html#_2-3-%E6%9C%8D%E5%8A%A1%E5%99%A8API
+type VirtualPayment struct {
+	ctx        *context.Context
+	sessionKey string
+}
+
+// Env Environment 0 - Production environment 1 - Sandbox environment
+type Env int
+
+// ErrCode error code
+type ErrCode int
+
+// OrderStatus 订单状态
+type OrderStatus int
+
+// CommonRequest common request parameters
+type CommonRequest struct {
+	OpenID string `json:"openid"` // The user's openID
+	Env    Env    `json:"env"`    // Environment 0 - Production environment 1 - Sandbox environment
+}
+
+// PaymentRequest payment request parameters
+type PaymentRequest struct {
+	SignData  string `json:"sign_data"` // 具体支付参数见 signData, 该参数需以 string 形式传递，例如 signData: '{"offerId":"123","buyQuantity":1,"env":0,"currencyType":"CNY","platform":"android","productId":"testproductId","goodsPrice":10,"outTradeNo":"xxxxxx","attach":"testdata"}'
+	Mode      string `json:"mode"`      // 支付模式，枚举值：short_series_goods: 道具直购，short_series_coin: 代币充值
+	PaySig    string `json:"pay_sig"`   // 支付签名，具体生成方式见下方说明
+	Signature string `json:"signature"` // 用户态签名，具体生成方式见下方说明
+}
+
+// SignData 签名数据
+type SignData struct {
+	OfferID      string `json:"offerId"`             // 在米大师侧申请的应用 id, mp-支付基础配置中的 offerid
+	BuyQuantity  int    `json:"buyQuantity"`         // 购买数量
+	Env          Env    `json:"env"`                 // 环境 0-正式环境 1-沙箱环境
+	CurrencyType string `json:"currencyType"`        // 币种 默认值：CNY 人民币
+	Platform     string `json:"platform,omitempty"`  // 申请接入时的平台，platform 与应用 id 有关 默认值：android 安卓平台
+	ProductID    string `json:"productId,omitempty"` // 道具 ID, **该字段仅 mode=short_series_goods 时可用**
+	GoodsPrice   int    `json:"goodsPrice"`          // 道具单价 (分), **该字段仅 mode=short_series_goods 时可用**, 用来校验价格与后台道具价格是否一致，避免用户在业务商城页看到的价格与实际价格不一致导致投诉
+	OutTradeNo   string `json:"outTradeNo"`          // 业务订单号，每个订单号只能使用一次，重复使用会失败 (极端情况不保证唯一，不建议业务强依赖唯一性). 要求 8-32 个字符内，只能是数字、大小写字母、符号 _-|*@组成，不能以下划线 (_) 开头
+	Attach       string `json:"attach"`              // 透传数据，发货通知时会透传给开发者
+}
+
+// QueryUserBalanceRequest 查询用户代币余额，请求参数
+// 1. 需要用户态签名与支付签名
+// POST，请求参数为 json 字符串，Content-Type 为 application/json
+type QueryUserBalanceRequest struct {
+	CommonRequest
+	UserIP string `json:"user_ip"` // 用户 ip，例如:1.1.1.1
+}
+
+// QueryUserBalanceResponse 查询虚拟支付余额 响应参数
+type QueryUserBalanceResponse struct {
+	util.CommonError
+	Balance        int `json:"balance"`         // 代币总余额，包括有价和赠送部分
+	PresentBalance int `json:"present_balance"` // 赠送账户的代币余额
+	SumSave        int `json:"sum_save"`        // 累计有价货币充值数量
+	SumPresent     int `json:"sum_present"`     // 累计赠送无价货币数量
+	SumBalance     int `json:"sum_balance"`     // 历史总增加的代币金额
+	SumCost        int `json:"sum_cost"`        // 历史总消耗代币金额
+	FirstSaveFlag  int `json:"first_save_flag"` // 是否满足首充活动标记。0:不满足。1:满足
+}
+
+// CurrencyPayRequest 扣减代币（一般用于代币支付）
+// 1. 需要用户态签名与支付签名
+// POST，请求参数为 json 字符串，Content-Type 为 application/json
+type CurrencyPayRequest struct {
+	CommonRequest
+	UserIP     string `json:"user_ip"`     // 用户 ip，例如：1.1.1.1
+	Amount     int    `json:"amount"`      // 支付的代币数量
+	OrderID    string `json:"order_id"`    // 商户订单号，需要保证唯一性
+	PayItem    string `json:"payitem"`     // 物品信息。记录到账户流水中。如:[{"productid":"物品 id", "unit_price": 单价，"quantity": 数量}]
+	Remark     string `json:"remark"`      // 备注信息。需要在账单中展示
+	DeviceType string `json:"device_type"` // 平台类型 1-安卓 2-苹果
+}
+
+// PayItem 物品信息
+type PayItem struct {
+	ProductID string `json:"productid"`  // 物品 id
+	UnitPrice int    `json:"unit_price"` // 单价
+	Quantity  int    `json:"quantity"`   // 数量
+}
+
+// CurrencyPayResponse 扣减代币（一般用于代币支付）响应参数
+type CurrencyPayResponse struct {
+	util.CommonError
+	OrderID           string `json:"order_id"`            // 商户订单号
+	Balance           int    `json:"balance"`             // 总余额，包括有价和赠送部分
+	UsedPresentAmount int    `json:"used_present_amount"` // 使用赠送部分的代币数量
+}
+
+// QueryOrderRequest 查询创建的订单（现金单，非代币单），请求参数
+// 1. 使用支付签名
+// POST，请求参数为 json 字符串，Content-Type 为 application/json
+type QueryOrderRequest struct {
+	CommonRequest
+	OrderID   string `json:"order_id,omitempty"`    // 商户订单号 创建的订单号
+	WxOrderID string `json:"wx_order_id,omitempty"` // 微信内部单号 (与 order_id 二选一)
+}
+
+// OrderItem 订单信息
+type OrderItem struct {
+	OrderID        string      `json:"order_id"`         // 商户订单号
+	CreateTime     int64       `json:"create_time"`      // 订单创建时间
+	UpdateTime     int64       `json:"update_time"`      // 订单更新时间
+	Status         OrderStatus `json:"status"`           // 订单状态 当前状态 0-订单初始化（未创建成功，不可用于支付）1-订单创建成功 2-订单已经支付，待发货 3-订单发货中 4-订单已发货 5-订单已经退款 6-订单已经关闭（不可再使用）7-订单退款失败
+	BizType        int         `json:"biz_type"`         // 业务类型 0-短剧
+	OrderFee       int         `json:"order_fee"`        // 订单金额，单位：分
+	CouponFee      int         `json:"coupon_fee"`       // 优惠金额，单位：分
+	PaidFee        int         `json:"paid_fee"`         // 用户支付金额，单位：分
+	OrderType      int         `json:"order_type"`       // 订单类型 0-支付单 1-退款单
+	RefundFee      int         `json:"refund_fee"`       // 当类型为退款单时表示退款金额，单位分
+	PaidTime       int64       `json:"paid_time"`        // 支付/退款时间，unix秒级时间戳
+	ProvideTime    int64       `json:"provide_time"`     // 发货时间，unix 秒级时间戳
+	BizMeta        string      `json:"biz_meta"`         // 业务自定义数据 订单创建时传的信息
+	EnvType        int         `json:"env_type"`         // 环境类型 1-现网 2-沙箱
+	Token          string      `json:"token"`            // 下单时米大师返回的 token
+	LeftFee        int         `json:"left_fee"`         // 支付单类型时表示此单经过退款还剩余的金额，单位：分
+	WxOrderID      string      `json:"wx_order_id"`      // 微信内部单号
+	ChannelOrderID string      `json:"channel_order_id"` // 渠道订单号，为用户微信支付详情页面上的商户单号
+	WxPayOrderID   string      `json:"wxpay_order_id"`   // 微信支付交易单号，为用户微信支付详情页面上的交易单号
+}
+
+// QueryOrderResponse 查询创建的订单（现金单，非代币单）响应参数
+type QueryOrderResponse struct {
+	util.CommonError
+	Order *OrderItem `json:"order"` // 订单信息
+}
+
+// CancelCurrencyPayRequest 取消订单（现金单，非代币单），请求参数
+// 1. 使用支付签名
+// POST，请求参数为 json 字符串，Content-Type 为 application/json
+type CancelCurrencyPayRequest struct {
+	CommonRequest
+	UserIP     string `json:"user_ip"`      // 用户 ip，例如：1.1.1.1
+	PayOrderID string `json:"pay_order_id"` // 支付单号 代币支付 (调用 currency_pay 接口时) 时传的 order_id
+	OrderID    string `json:"order_id"`     // 本次退款单的单号
+	Amount     int    `json:"amount"`       // 退款金额
+	DeviceType int    `json:"device_type"`  // 平台类型 1-安卓 2-苹果
+}
+
+// CancelCurrencyPayResponse 取消订单（现金单，非代币单）响应参数
+type CancelCurrencyPayResponse struct {
+	util.CommonError
+	OrderID string `json:"order_id"` // 退款订单号
+}
+
+// NotifyProvideGoodsRequest 通知发货，请求参数
+// 通知已经发货完成（只能通知现金单）,正常通过 xpay_goods_deliver_notify 消息推送返回成功就不需要调用这个 api 接口。这个接口用于异常情况推送不成功时手动将单改成已发货状态
+// 1. 使用支付签名
+// POST，请求参数为 json 字符串，Content-Type 为 application/json
+type NotifyProvideGoodsRequest struct {
+	OrderID   string `json:"order_id,omitempty"`    // 商户订单号 下单时传的单号
+	WxOrderID string `json:"wx_order_id,omitempty"` // 微信内部单号 (与 order_id 二选一)
+	Env       Env    `json:"env"`                   // 环境 0-正式环境 1-沙箱环境
+}
+
+// NotifyProvideGoodsResponse 通知发货响应参数
+type NotifyProvideGoodsResponse struct {
+	util.CommonError
+}
+
+// PresentCurrencyRequest 赠送代币，请求参数
+// 代币赠送接口，由于目前不支付按单号查赠送单的功能，所以当需要赠送的时候可以一直重试到返回 0 或者返回 268490004（重复操作）为止
+// 1. 需要用户态签名与支付签名
+// POST，请求参数为 json 字符串，Content-Type 为 application/json
+type PresentCurrencyRequest struct {
+	CommonRequest
+	OrderID    string `json:"order_id"`    // 赠送单号，商户订单号，需要保证唯一性
+	Amount     int    `json:"amount"`      // 赠送的代币数量
+	DeviceType string `json:"device_type"` // 平台类型 1-安卓 2-苹果
+}
+
+// PresentCurrencyResponse 赠送代币响应参数
+type PresentCurrencyResponse struct {
+	util.CommonError
+	Balance        int    `json:"balance"`         // 赠送后用户的代币余额
+	OrderID        string `json:"order_id"`        // 赠送单号
+	PresentBalance int    `json:"present_balance"` // 用户收到的总赠送金额
+}
+
+// DownloadBillRequest 下载账单，请求参数
+// 用于下载小程序账单，第一次调用触发生成下载 url，可以间隔轮训来获取最终生成的下载 url。账单中金额相关字段是以分为单位。
+// 1. 使用支付签名
+// POST，请求参数为 json 字符串，Content-Type 为 application/json
+type DownloadBillRequest struct {
+	BeginDs string `json:"begin_ds"` // 账单开始日期，格式为 yyyymmdd 起始时间（如 20230801）
+	EndDs   string `json:"end_ds"`   // 账单结束日期，格式为 yyyymmdd 结束时间（如 20230801）
+}
+
+// DownloadBillResponse 下载账单响应参数
+type DownloadBillResponse struct {
+	util.CommonError
+	URL string `json:"url"` // 账单下载地址
+}
+
+// RefundOrderRequest 退款，请求参数
+// 对使用 jsapi 接口下的单进行退款
+// 1. 使用支付签名
+// POST，请求参数为 json 字符串，Content-Type 为 application/json
+type RefundOrderRequest struct {
+	CommonRequest
+	OrderID       string `json:"order_id"`        // 商户订单号，需要保证唯一性
+	WxOrderID     string `json:"wx_order_id"`     // 微信内部单号 (与 order_id 二选一)
+	RefundOrderID string `json:"refund_order_id"` // 退款单号，本次退款时需要传的单号，长度为 [8,32]，字符只允许使用字母、数字、'_'、'-'
+	LeftFee       int    `json:"left_fee"`        // 退款金额，单位：分 当前单剩余可退金额，单位分，可以通过调用 query_order 接口查到
+	RefundFee     int    `json:"refund_fee"`      // 退款金额，单位：分 需要 (0,left_fee] 之间
+	BizMeta       string `json:"biz_meta"`        // 商家自定义数据，传入后可在 query_order 接口查询时原样返回，长度需要 [0,1024]
+	RefundReason  string `json:"refund_reason"`   // 退款原因，当前仅支持以下值 0-暂无描述 1-产品问题，影响使用或效果不佳 2-售后问题，无法满足需求 3-意愿问题，用户主动退款 4-价格问题 5:其他原因
+	ReqFrom       string `json:"req_from"`        // 退款来源，当前仅支持以下值 1-人工客服退款，即用户电话给客服，由客服发起退款流程 2-用户自己发起退款流程 3-其它
+}
+
+// RefundOrderResponse 退款响应参数
+type RefundOrderResponse struct {
+	util.CommonError
+	RefundOrderID   string `json:"refund_order_id"`    // 退款单号
+	RefundWxOrderID string `json:"refund_wx_order_id"` // 退款单的微信侧单号
+	PayOrderID      string `json:"pay_order_id"`       // 该退款单对应的支付单单号
+	PayWxOrderID    string `json:"pay_wx_order_id"`    // 该退款单对应的支付单微信侧单号
+}
+
+// CreateWithdrawOrderRequest 创建提现单，请求参数
+// 1. 使用支付签名
+// POST，请求参数为 json 字符串，Content-Type 为 application/json
+type CreateWithdrawOrderRequest struct {
+	WithdrawNO     string `json:"withdraw_no"`     // 提现单单号，长度为 [8,32]，字符只允许使用字母、数字、'_'、'-'
+	WithdrawAmount string `json:"withdraw_amount"` // 提现的金额，单位元，例如提现 1 分钱请使用 0.01
+	Env            Env    `json:"env"`             // 环境 0-正式环境 1-沙箱环境
+}
+
+// CreateWithdrawOrderResponse 创建提现单响应参数
+type CreateWithdrawOrderResponse struct {
+	util.CommonError
+	WithdrawNO   string `json:"withdraw_no"`    // 提现单单号
+	WxWithdrawNO string `json:"wx_withdraw_no"` // 提现单的微信侧单号
+}
+
+// QueryWithdrawOrderRequest 查询提现单，请求参数
+// 1. 使用支付签名
+// POST，请求参数为 json 字符串，Content-Type 为 application/json
+type QueryWithdrawOrderRequest struct {
+	WithdrawNO string `json:"withdraw_no"` // 提现单单号，长度为 [8,32]，字符只允许使用字母、数字、'_'、'-' (与 wx_withdraw_no 二选一)
+	Env        Env    `json:"env"`         // 环境 0-正式环境 1-沙箱环境
+}
+
+// QueryWithdrawOrderResponse 查询提现单响应参数
+type QueryWithdrawOrderResponse struct {
+	util.CommonError
+	WithdrawNO               string `json:"withdraw_no"`                // 提现单单号
+	Status                   int    `json:"status"`                     // 提现单的微信侧单号 1-创建成功，提现中 2-提现成功 3-提现失败
+	WithdrawAmount           string `json:"withdraw_amount"`            // 提现的金额，单位元，例如提现 1 分钱请使用 0.01
+	WxWithdrawNo             string `json:"wx_withdraw_no"`             // 提现单的微信侧单号
+	WithdrawSuccessTimestamp int64  `json:"withdraw_success_timestamp"` // 提现单成功的秒级时间戳，unix 秒级时间戳
+	CreateTime               string `json:"create_time"`                // 提现单创建时间
+	FailReason               string `json:"failReason"`                 // 提现失败的原因
+}
+
+// StartUploadGoodsRequest 启动批量上传道具任务，请求参数
+// 1. 使用支付签名
+// POST，请求参数为 json 字符串，Content-Type 为 application/json
+type StartUploadGoodsRequest struct {
+	UploadItem []*UploadItem `json:"upload_item"` // 道具信息
+	Env        Env           `json:"env"`         // 环境 0-正式环境 1-沙箱环境
+}
+
+// UploadItem 道具信息
+type UploadItem struct {
+	ID           string `json:"id"`                      // 道具 id，长度 (0,64]，字符只允许使用字母、数字、'_'、'-'
+	Name         string `json:"name"`                    // 道具名称，长度 (0,1024]
+	Price        int    `json:"price"`                   // 道具单价，单位分，需要大于 0
+	Remark       string `json:"remark"`                  // 道具备注，长度 (0,1024]
+	ItemURL      string `json:"item_url"`                // 道具图片的 url 地址，当前仅支持 jpg,png 等格式
+	UploadStatus int    `json:"upload_status,omitempty"` // 上传状态 0-上传中 1-id 已经存在 2-上传成功 3-上传失败
+	ErrMsg       string `json:"errmsg,omitempty"`        // 上传失败的原因
+}
+
+// StartUploadGoodsResponse 启动批量上传道具任务响应参数
+type StartUploadGoodsResponse struct {
+	util.CommonError
+}
+
+// QueryUploadGoodsRequest 查询批量上传道具任务，请求参数
+// 1. 使用支付签名
+// POST，请求参数为 json 字符串，Content-Type 为 application/json
+type QueryUploadGoodsRequest struct {
+	Env Env `json:"env"` // 环境 0-正式环境 1-沙箱环境
+}
+
+// QueryUploadGoodsResponse 查询批量上传道具任务响应参数
+type QueryUploadGoodsResponse struct {
+	util.CommonError
+	UploadItem []*UploadItem `json:"upload_item"` // 道具信息列表
+	Status     int           `json:"status"`      // 任务状态 0-无任务在运行 1-任务运行中 2-上传失败或部分失败（上传任务已经完成）3-上传成功
+}
+
+// StartPublishGoodsRequest 启动批量发布道具任务，请求参数
+// 1. 使用支付签名
+// POST，请求参数为 json 字符串，Content-Type 为 application/json
+type StartPublishGoodsRequest struct {
+	Env         Env            `json:"env"`          // 环境 0-正式环境 1-沙箱环境
+	PublishItem []*PublishItem `json:"publish_item"` // 道具信息 发布的商品列表
+}
+
+// PublishItem 道具信息
+type PublishItem struct {
+	ID            string `json:"id"`                       // 道具 id，添加到开发环境时传的道具 id，长度 (0,64]，字符只允许使用字母、数字、'_'、'-'
+	PublishStatus int    `json:"publish_status,omitempty"` // 发布状态 0-上传中 1-id 已经存在 2-发布成功 3-发布失败
+	ErrMsg        string `json:"errmsg,omitempty"`         // 发布失败的原因
+}
+
+// StartPublishGoodsResponse 启动批量发布道具任务响应参数
+type StartPublishGoodsResponse struct {
+	util.CommonError
+}
+
+// QueryPublishGoodsRequest 查询批量发布道具任务，请求参数
+// 1. 使用支付签名
+// POST，请求参数为 json 字符串，Content-Type 为 application/json
+type QueryPublishGoodsRequest struct {
+	Env Env `json:"env"` // 环境 0-正式环境 1-沙箱环境
+}
+
+// QueryPublishGoodsResponse 查询批量发布道具任务响应参数
+type QueryPublishGoodsResponse struct {
+	util.CommonError
+	PublishItem []*PublishItem `json:"publish_item"` // 道具信息列表
+	Status      int            `json:"status"`       // 任务状态 0-无任务在运行 1-任务运行中 2-上传失败或部分失败（上传任务已经完成）3-上传成功
+
+}
+
+// AsyncXPayGoodsDeliverNotifyRequest 异步通知发货，请求参数
+// 1. 使用支付签名
+// POST，请求参数为 json 字符串，Content-Type 为 application/json
+type AsyncXPayGoodsDeliverNotifyRequest struct {
+	ToUserName    string         `json:"ToUserName"`    // 小程序的原始 ID
+	FromUserName  string         `json:"FromUserName"`  // 发送方帐号（一个 OpenID）该事件消息的 openid，道具发货场景固定为微信官方的 openid
+	CreateTime    int            `json:"CreateTime"`    // 消息发送时间（整型）
+	MsgType       string         `json:"MsgType"`       // 消息类型，此时固定为：event
+	Event         string         `json:"Event"`         // 事件类型，此时固定为：xpay_goods_deliver_notify
+	Openid        string         `json:"openid"`        // 用户 openid
+	OutTradeNo    string         `json:"OutTradeNo"`    // 业务订单号
+	Env           Env            `json:"env"`           // 环境 0-正式环境 1-沙箱环境
+	WechatPayInfo *WeChatPayInfo `json:"WechatPayInfo"` // 微信支付订单信息
+	GoodsInfo     *GoodsInfo     `json:"GoodsInfo"`     // 道具信息
+}
+
+// WeChatPayInfo 微信支付信息 非微信支付渠道可能没有
+type WeChatPayInfo struct {
+	MchOrderNo    string `json:"MchOrderNo"`    // 商户订单号
+	TransactionID string `json:"TransactionId"` // 微信支付订单号
+}
+
+// GoodsInfo 道具参数信息
+type GoodsInfo struct {
+	ProductID   string `json:"ProductId"`   // 道具 ID
+	Quantity    int    `json:"Quantity"`    // 数量
+	OrigPrice   int    `json:"OrigPrice"`   // 物品原始价格（单位：分）
+	ActualPrice int    `json:"ActualPrice"` // 物品实际支付价格（单位：分）
+	Attach      string `json:"Attach"`      // 透传信息
+}
+
+// AsyncXPayGoodsDeliverNotifyResponse 异步通知发货响应参数
+type AsyncXPayGoodsDeliverNotifyResponse struct {
+	util.CommonError
+}
+
+// AsyncXPayCoinPayNotifyRequest 异步通知代币支付推送，请求参数
+type AsyncXPayCoinPayNotifyRequest struct {
+	ToUserName    string         `json:"ToUserName"`    // 小程序的原始 ID
+	FromUserName  string         `json:"FromUserName"`  // 发送方帐号（一个 OpenID）该事件消息的 openid，道具发货场景固定为微信官方的 openid
+	CreateTime    int            `json:"CreateTime"`    // 消息发送时间（整型）
+	MsgType       string         `json:"MsgType"`       // 消息类型，此时固定为：event
+	Event         string         `json:"Event"`         // 事件类型，此时固定为：xpay_goods_deliver_notify
+	Openid        string         `json:"openid"`        // 用户 openid
+	OutTradeNo    string         `json:"OutTradeNo"`    // 业务订单号
+	Env           Env            `json:"env"`           // 环境 0-正式环境 1-沙箱环境
+	WechatPayInfo *WeChatPayInfo `json:"WechatPayInfo"` // 微信支付订单信息
+	CoinInfo      *CoinInfo      `json:"GoodsInfo"`     // 道具信息
+}
+
+// CoinInfo 代币信息
+type CoinInfo struct {
+	Quantity    int    `json:"Quantity"`    // 数量
+	OrigPrice   int    `json:"OrigPrice"`   // 物品原始价格（单位：分）
+	ActualPrice int    `json:"ActualPrice"` // 物品实际支付价格（单位：分）
+	Attach      string `json:"Attach"`      // 透传信息
+}
+
+// AsyncXPayCoinPayNotifyResponse 异步通知代币支付推送响应参数
+type AsyncXPayCoinPayNotifyResponse struct {
+	util.CommonError
+}
+
+// URLParams url parameter
+type URLParams struct {
+	Path        string `json:"path"`
+	AccessToken string `json:"access_token"`
+	PaySign     string `json:"paySign"`
+	Signature   string `json:"signature"`
+	Content     string `json:"content"`
+}
--- a/miniprogram/virtualpayment/virtualpayment.go
+++ b/miniprogram/virtualpayment/virtualpayment.go
@@ -0,0 +1,558 @@
+/*
+ *   Copyright silenceper/wechat Author(https://silenceper.com/wechat/). All Rights Reserved.
+ *
+ *   Licensed under the Apache License, Version 2.0 (the "License");
+ *   you may not use this file except in compliance with the License.
+ *   You may obtain a copy of the License at
+ *
+ *       http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *   Unless required by applicable law or agreed to in writing, software
+ *   distributed under the License is distributed on an "AS IS" BASIS,
+ *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *   See the License for the specific language governing permissions and
+ *   limitations under the License.
+ *
+ *   You can obtain one at https://github.com/silenceper/wechat.
+ *
+ */
+
+package virtualpayment
+
+import (
+	"context"
+	"crypto/hmac"
+	"crypto/sha256"
+	"encoding/hex"
+	"encoding/json"
+	"errors"
+	"strings"
+
+	"github.com/silenceper/wechat/v2/util"
+)
+
+// SetSessionKey 设置 sessionKey
+func (s *VirtualPayment) SetSessionKey(sessionKey string) {
+	s.sessionKey = sessionKey
+}
+
+// QueryUserBalance 查询虚拟支付余额
+func (s *VirtualPayment) QueryUserBalance(ctx context.Context, in *QueryUserBalanceRequest) (out *QueryUserBalanceResponse, err error) {
+	var jsonByte []byte
+	if jsonByte, err = json.Marshal(in); err != nil {
+		return
+	}
+
+	var (
+		params = URLParams{
+			Path:    queryUserBalance,
+			Content: string(jsonByte),
+		}
+		address string
+	)
+	if address, err = s.requestAddress(params); err != nil {
+		return
+	}
+
+	var response []byte
+	if response, err = util.PostJSONContext(ctx, address, in); err != nil {
+		return
+	}
+
+	// 使用通用方法返回错误
+	if err = util.DecodeWithError(response, out, "QueryUserBalance"); err != nil {
+		return
+	}
+
+	return
+}
+
+// CurrencyPay currency pay 扣减代币（一般用于代币支付）
+func (s *VirtualPayment) CurrencyPay(ctx context.Context, in *CurrencyPayRequest) (out *CurrencyPayResponse, err error) {
+	var jsonByte []byte
+	if jsonByte, err = json.Marshal(in); err != nil {
+		return
+	}
+
+	var (
+		params = URLParams{
+			Path:    currencyPay,
+			Content: string(jsonByte),
+		}
+		address string
+	)
+	if address, err = s.requestAddress(params); err != nil {
+		return
+	}
+
+	var response []byte
+	if response, err = util.PostJSONContext(ctx, address, in); err != nil {
+		return
+	}
+
+	// 使用通用方法返回错误
+	if err = util.DecodeWithError(response, out, "CurrencyPay"); err != nil {
+		return
+	}
+
+	return
+}
+
+// QueryOrder 查询创建的订单（现金单，非代币单）
+func (s *VirtualPayment) QueryOrder(ctx context.Context, in *QueryOrderRequest) (out *QueryOrderResponse, err error) {
+	var jsonByte []byte
+	if jsonByte, err = json.Marshal(in); err != nil {
+		return
+	}
+
+	var (
+		params = URLParams{
+			Path:      queryOrder,
+			Signature: EmptyString,
+			Content:   string(jsonByte),
+		}
+		address string
+	)
+	if address, err = s.requestAddress(params); err != nil {
+		return
+	}
+	var response []byte
+	if response, err = util.PostJSONContext(ctx, address, in); err != nil {
+		return
+	}
+
+	// 使用通用方法返回错误
+	if err = util.DecodeWithError(response, out, "QueryOrder"); err != nil {
+		return
+	}
+
+	return
+}
+
+// CancelCurrencyPay 取消订单 代币支付退款 (currency_pay 接口的逆操作)
+func (s *VirtualPayment) CancelCurrencyPay(ctx context.Context, in *CancelCurrencyPayRequest) (out *CancelCurrencyPayResponse, err error) {
+	var jsonByte []byte
+	if jsonByte, err = json.Marshal(in); err != nil {
+		return
+	}
+
+	var (
+		params = URLParams{
+			Path:    cancelCurrencyPay,
+			Content: string(jsonByte),
+		}
+		address string
+	)
+	if address, err = s.requestAddress(params); err != nil {
+		return
+	}
+
+	var response []byte
+	if response, err = util.PostJSONContext(ctx, address, in); err != nil {
+		return
+	}
+
+	// 使用通用方法返回错误
+	if err = util.DecodeWithError(response, out, "CancelCurrencyPay"); err != nil {
+		return
+	}
+
+	return
+}
+
+// NotifyProvideGoods 通知发货
+// 通知已经发货完成（只能通知现金单）,正常通过 xpay_goods_deliver_notify 消息推送返回成功就不需要调用这个 api 接口。这个接口用于异常情况推送不成功时手动将单改成已发货状态
+func (s *VirtualPayment) NotifyProvideGoods(ctx context.Context, in *NotifyProvideGoodsRequest) (out *NotifyProvideGoodsResponse, err error) {
+	var jsonByte []byte
+	if jsonByte, err = json.Marshal(in); err != nil {
+		return
+	}
+
+	var (
+		params = URLParams{
+			Path:      notifyProvideGoods,
+			Content:   string(jsonByte),
+			Signature: EmptyString,
+		}
+		address string
+	)
+	if address, err = s.requestAddress(params); err != nil {
+		return
+	}
+
+	var response []byte
+	if response, err = util.PostJSONContext(ctx, address, in); err != nil {
+		return
+	}
+
+	// 使用通用方法返回错误
+	if err = util.DecodeWithError(response, out, "NotifyProvideGoods"); err != nil {
+		return
+	}
+
+	return
+}
+
+// PresentCurrency 代币赠送接口，由于目前不支付按单号查赠送单的功能，所以当需要赠送的时候可以一直重试到返回 0 或者返回 268490004（重复操作）为止
+func (s *VirtualPayment) PresentCurrency(ctx context.Context, in *PresentCurrencyRequest) (out *PresentCurrencyResponse, err error) {
+	var jsonByte []byte
+	if jsonByte, err = json.Marshal(in); err != nil {
+		return
+	}
+
+	var (
+		params = URLParams{
+			Path:      presentCurrency,
+			Content:   string(jsonByte),
+			Signature: EmptyString,
+		}
+		address string
+	)
+	if address, err = s.requestAddress(params); err != nil {
+		return
+	}
+
+	var response []byte
+	if response, err = util.PostJSONContext(ctx, address, in); err != nil {
+		return
+	}
+
+	// 使用通用方法返回错误
+	if err = util.DecodeWithError(response, out, "PresentCurrency"); err != nil {
+		return
+	}
+
+	return
+}
+
+// DownloadBill 下载订单交易账单
+func (s *VirtualPayment) DownloadBill(ctx context.Context, in *DownloadBillRequest) (out *DownloadBillResponse, err error) {
+	var jsonByte []byte
+	if jsonByte, err = json.Marshal(in); err != nil {
+		return
+	}
+
+	var (
+		params = URLParams{
+			Path:      downloadBill,
+			Content:   string(jsonByte),
+			Signature: EmptyString,
+		}
+		address string
+	)
+	if address, err = s.requestAddress(params); err != nil {
+		return
+	}
+
+	var response []byte
+	if response, err = util.PostJSONContext(ctx, address, in); err != nil {
+		return
+	}
+
+	// 使用通用方法返回错误
+	if err = util.DecodeWithError(response, out, "DownloadBill"); err != nil {
+		return
+	}
+
+	return
+}
+
+// RefundOrder 退款 对使用 jsapi 接口下的单进行退款
+func (s *VirtualPayment) RefundOrder(ctx context.Context, in *RefundOrderRequest) (out *RefundOrderResponse, err error) {
+	var jsonByte []byte
+	if jsonByte, err = json.Marshal(in); err != nil {
+		return
+	}
+
+	var (
+		params = URLParams{
+			Path:      refundOrder,
+			Content:   string(jsonByte),
+			Signature: EmptyString,
+		}
+		address string
+	)
+	if address, err = s.requestAddress(params); err != nil {
+		return
+	}
+
+	var response []byte
+	if response, err = util.PostJSONContext(ctx, address, in); err != nil {
+		return
+	}
+
+	// 使用通用方法返回错误
+	if err = util.DecodeWithError(response, out, "RefundOrder"); err != nil {
+		return
+	}
+
+	return
+}
+
+// CreateWithdrawOrder 创建提现单
+func (s *VirtualPayment) CreateWithdrawOrder(ctx context.Context, in *CreateWithdrawOrderRequest) (out *CreateWithdrawOrderResponse, err error) {
+	var jsonByte []byte
+	if jsonByte, err = json.Marshal(in); err != nil {
+		return
+	}
+
+	var (
+		params = URLParams{
+			Path:      createWithdrawOrder,
+			Content:   string(jsonByte),
+			Signature: EmptyString,
+		}
+		address string
+	)
+	if address, err = s.requestAddress(params); err != nil {
+		return
+	}
+
+	var response []byte
+	if response, err = util.PostJSONContext(ctx, address, in); err != nil {
+		return
+	}
+
+	// 使用通用方法返回错误
+	if err = util.DecodeWithError(response, out, "CreateWithdrawOrder"); err != nil {
+		return
+	}
+
+	return
+}
+
+// QueryWithdrawOrder 查询提现单
+func (s *VirtualPayment) QueryWithdrawOrder(ctx context.Context, in *QueryWithdrawOrderRequest) (out *QueryWithdrawOrderResponse, err error) {
+	var jsonByte []byte
+	if jsonByte, err = json.Marshal(in); err != nil {
+		return
+	}
+
+	var (
+		params = URLParams{
+			Path:      queryWithdrawOrder,
+			Content:   string(jsonByte),
+			Signature: EmptyString,
+		}
+		address string
+	)
+	if address, err = s.requestAddress(params); err != nil {
+		return
+	}
+
+	var response []byte
+	if response, err = util.PostJSONContext(ctx, address, in); err != nil {
+		return
+	}
+
+	// 使用通用方法返回错误
+	if err = util.DecodeWithError(response, out, "QueryWithdrawOrder"); err != nil {
+		return
+	}
+
+	return
+}
+
+// StartUploadGoods 开始上传商品
+func (s *VirtualPayment) StartUploadGoods(ctx context.Context, in *StartUploadGoodsRequest) (out *StartUploadGoodsResponse, err error) {
+	var jsonByte []byte
+	if jsonByte, err = json.Marshal(in); err != nil {
+		return
+	}
+
+	var (
+		params = URLParams{
+			Path:      startUploadGoods,
+			Content:   string(jsonByte),
+			Signature: EmptyString,
+		}
+		address string
+	)
+	if address, err = s.requestAddress(params); err != nil {
+		return
+	}
+
+	var response []byte
+	if response, err = util.PostJSONContext(ctx, address, in); err != nil {
+		return
+	}
+
+	// 使用通用方法返回错误
+	if err = util.DecodeWithError(response, out, "StartUploadGoods"); err != nil {
+		return
+	}
+
+	return
+}
+
+// QueryUploadGoods 查询上传商品
+func (s *VirtualPayment) QueryUploadGoods(ctx context.Context, in *QueryUploadGoodsRequest) (out *QueryUploadGoodsResponse, err error) {
+	var jsonByte []byte
+	if jsonByte, err = json.Marshal(in); err != nil {
+		return
+	}
+
+	var (
+		params = URLParams{
+			Path:      queryUploadGoods,
+			Content:   string(jsonByte),
+			Signature: EmptyString,
+		}
+		address string
+	)
+	if address, err = s.requestAddress(params); err != nil {
+		return
+	}
+
+	var response []byte
+	if response, err = util.PostJSONContext(ctx, address, in); err != nil {
+		return
+	}
+
+	// 使用通用方法返回错误
+	if err = util.DecodeWithError(response, out, "QueryUploadGoods"); err != nil {
+		return
+	}
+
+	return
+}
+
+// StartPublishGoods 开始发布商品
+func (s *VirtualPayment) StartPublishGoods(ctx context.Context, in *StartPublishGoodsRequest) (out *StartPublishGoodsResponse, err error) {
+	var jsonByte []byte
+	if jsonByte, err = json.Marshal(in); err != nil {
+		return
+	}
+
+	var (
+		params = URLParams{
+			Path:      startPublishGoods,
+			Content:   string(jsonByte),
+			Signature: EmptyString,
+		}
+		address string
+	)
+	if address, err = s.requestAddress(params); err != nil {
+		return
+	}
+
+	var response []byte
+	if response, err = util.PostJSONContext(ctx, address, in); err != nil {
+		return
+	}
+
+	// 使用通用方法返回错误
+	if err = util.DecodeWithError(response, out, "StartPublishGoods"); err != nil {
+		return
+	}
+
+	return
+}
+
+// QueryPublishGoods 查询发布商品
+func (s *VirtualPayment) QueryPublishGoods(ctx context.Context, in *QueryPublishGoodsRequest) (out *QueryPublishGoodsResponse, err error) {
+	var jsonByte []byte
+	if jsonByte, err = json.Marshal(in); err != nil {
+		return
+	}
+
+	var (
+		params = URLParams{
+			Path:      queryPublishGoods,
+			Content:   string(jsonByte),
+			Signature: EmptyString,
+		}
+		address string
+	)
+	if address, err = s.requestAddress(params); err != nil {
+		return
+	}
+
+	var response []byte
+	if response, err = util.PostJSONContext(ctx, address, in); err != nil {
+		return
+	}
+
+	// 使用通用方法返回错误
+	if err = util.DecodeWithError(response, out, "QueryPublishGoods"); err != nil {
+		return
+	}
+
+	return
+}
+
+// hmacSha256 hmac sha256
+func (s *VirtualPayment) hmacSha256(key, data string) string {
+	h := hmac.New(sha256.New, []byte(key))
+	h.Write([]byte(data))
+	return hex.EncodeToString(h.Sum(nil))
+}
+
+// PaySign pay sign
+func (s *VirtualPayment) PaySign(url, data string) (string, error) {
+	if strings.TrimSpace(s.ctx.Config.AppKey) == "" {
+		return "", errors.New("appKey is empty")
+	}
+	return s.hmacSha256(s.ctx.Config.AppKey, url+"&"+data), nil
+}
+
+// Signature user signature
+func (s *VirtualPayment) Signature(data string) (string, error) {
+	if strings.TrimSpace(s.sessionKey) == "" {
+		return "", errors.New("sessionKey is empty")
+	}
+	return s.hmacSha256(s.sessionKey, data), nil
+}
+
+// PaySignature pay sign and signature
+func (s *VirtualPayment) PaySignature(url, data string) (paySign, signature string, err error) {
+	if paySign, err = s.PaySign(url, data); err != nil {
+		return
+	}
+	if signature, err = s.Signature(data); err != nil {
+		return
+	}
+	return
+}
+
+// requestURL .组合 URL
+func (s *VirtualPayment) requestAddress(params URLParams) (url string, err error) {
+	switch params.Path {
+	case queryUserBalance:
+	case currencyPay:
+	case cancelCurrencyPay:
+		if params.PaySign, params.Signature, err = s.PaySignature(params.Path, params.Content); err != nil {
+			return
+		}
+	case queryOrder:
+	case notifyProvideGoods:
+	case presentCurrency:
+	case downloadBill:
+	case refundOrder:
+	case createWithdrawOrder:
+	case queryWithdrawOrder:
+	case startUploadGoods:
+	case queryUploadGoods:
+	case startPublishGoods:
+	case queryPublishGoods:
+		if params.PaySign, err = s.PaySign(params.Path, params.Content); err != nil {
+			return
+		}
+	default:
+		err = errors.New("path is not exist")
+		return
+	}
+
+	if params.AccessToken, err = s.ctx.GetAccessToken(); err != nil {
+		return
+	}
+
+	url = baseSite + params.Path + "?" + accessToken + "=" + params.AccessToken
+	if params.PaySign != EmptyString {
+		url += "&" + paySignature + "=" + params.PaySign
+	}
+	if params.Signature != EmptyString {
+		url += "&" + signature + "=" + params.Signature
+	}
+	return
+}
--- a/officialaccount/material/material.go
+++ b/officialaccount/material/material.go
@@ -27,7 +27,7 @@ const (
 	PermanentMaterialTypeImage PermanentMaterialType = "image"
 	// PermanentMaterialTypeVideo 永久素材视频类型（video）
 	PermanentMaterialTypeVideo PermanentMaterialType = "video"
-	// PermanentMaterialTypeVoice 永久素材语音类型 （voice）
+	// PermanentMaterialTypeVoice 永久素材语音类型（voice）
 	PermanentMaterialTypeVoice PermanentMaterialType = "voice"
 	// PermanentMaterialTypeNews 永久素材图文类型（news）
 	PermanentMaterialTypeNews PermanentMaterialType = "news"
@@ -278,7 +278,7 @@ type ArticleList struct {
 	Item       []ArticleListItem `json:"item"`
 }

-// ArticleListItem 用于ArticleList的item节点
+// ArticleListItem 用于 ArticleList 的 item 节点
 type ArticleListItem struct {
 	MediaID    string             `json:"media_id"`
 	Content    ArticleListContent `json:"content"`
@@ -287,14 +287,14 @@ type ArticleListItem struct {
 	UpdateTime int64              `json:"update_time"`
 }

-// ArticleListContent 用于ArticleListItem的content节点
+// ArticleListContent 用于 ArticleListItem 的 content 节点
 type ArticleListContent struct {
 	NewsItem   []Article `json:"news_item"`
 	UpdateTime int64     `json:"update_time"`
 	CreateTime int64     `json:"create_time"`
 }

-// reqBatchGetMaterial BatchGetMaterial请求参数
+// reqBatchGetMaterial BatchGetMaterial 请求参数
 type reqBatchGetMaterial struct {
 	Type   PermanentMaterialType `json:"type"`
 	Count  int64                 `json:"count"`
@@ -337,7 +337,7 @@ type ResMaterialCount struct {
 	NewsCount  int64 `json:"news_count"`  // 图文总数量
 }

-// GetMaterialCount 获取素材总数.
+// GetMaterialCount 获取素材总数。
 func (material *Material) GetMaterialCount() (res ResMaterialCount, err error) {
 	var accessToken string
 	accessToken, err = material.GetAccessToken()
--- a/util/error.go
+++ b/util/error.go
@@ -6,7 +6,7 @@ import (
 	"reflect"
 )

-// CommonError 微信返回的通用错误json
+// CommonError 微信返回的通用错误 json
 type CommonError struct {
 	apiName string
 	ErrCode int64  `json:"errcode"`
@@ -17,7 +17,7 @@ func (c *CommonError) Error() string {
 	return fmt.Sprintf("%s Error , errcode=%d , errmsg=%s", c.apiName, c.ErrCode, c.ErrMsg)
 }

-// NewCommonError 新建CommonError错误，对于无errcode和errmsg的返回也可以返回该通用错误
+// NewCommonError 新建 CommonError 错误，对于无 errcode 和 errmsg 的返回也可以返回该通用错误
 func NewCommonError(apiName string, code int64, msg string) *CommonError {
 	return &CommonError{
 		apiName: apiName,
@@ -26,7 +26,7 @@ func NewCommonError(apiName string, code int64, msg string) *CommonError {
 	}
 }

-// DecodeWithCommonError 将返回值按照CommonError解析
+// DecodeWithCommonError 将返回值按照 CommonError 解析
 func DecodeWithCommonError(response []byte, apiName string) (err error) {
 	var commError CommonError
 	err = json.Unmarshal(response, &commError)
--- a/util/http.go
+++ b/util/http.go
@@ -100,7 +100,7 @@ func PostJSON(uri string, obj interface{}) ([]byte, error) {
 	return PostJSONContext(context.Background(), uri, obj)
 }

-// PostJSONWithRespContentType post json数据请求，且返回数据类型
+// PostJSONWithRespContentType post json 数据请求，且返回数据类型
 func PostJSONWithRespContentType(uri string, obj interface{}) ([]byte, string, error) {
 	jsonBuf := new(bytes.Buffer)
 	enc := json.NewEncoder(jsonBuf)
@@ -216,7 +216,7 @@ func PostXML(uri string, obj interface{}) ([]byte, error) {
 	return io.ReadAll(response.Body)
 }

-// httpWithTLS CA证书
+// httpWithTLS CA 证书
 func httpWithTLS(rootCa, key string) (*http.Client, error) {
 	var client *http.Client
 	certData, err := os.ReadFile(rootCa)
@@ -235,7 +235,7 @@ func httpWithTLS(rootCa, key string) (*http.Client, error) {
 	return client, nil
 }

-// pkcs12ToPem 将Pkcs12转成Pem
+// pkcs12ToPem 将 Pkcs12 转成 Pem
 func pkcs12ToPem(p12 []byte, password string) tls.Certificate {
 	blocks, err := pkcs12.ToPEM(p12, password)
 	defer func() {
--- a/wechat.go
+++ b/wechat.go
@@ -40,7 +40,7 @@ func NewWechat() *Wechat {
 	return &Wechat{}
 }

-// SetCache 设置cache
+// SetCache 设置 cache
 func (wc *Wechat) SetCache(cache cache.Cache) {
 	wc.cache = cache
 }
--- a/work/addresslist/department.go
+++ b/work/addresslist/department.go
@@ -9,6 +9,8 @@ import (
 const (
 	// departmentSimpleListURL 获取子部门ID列表
 	departmentSimpleListURL = "https://qyapi.weixin.qq.com/cgi-bin/department/simplelist?access_token=%s&id=%d"
+	// departmentListURL 获取部门列表
+	departmentListURL = "https://qyapi.weixin.qq.com/cgi-bin/department/list?access_token=%s"
 )

 type (
@@ -23,6 +25,21 @@ type (
 		ParentID int `json:"parentid"`
 		Order    int `json:"order"`
 	}
+
+	// DepartmentListResponse 获取部门列表响应
+	DepartmentListResponse struct {
+		util.CommonError
+		Department []*Department `json:"department"`
+	}
+	// Department 部门列表数据
+	Department struct {
+		ID               int      `json:"id"`                // 创建的部门id
+		Name             string   `json:"name"`              // 部门名称
+		NameEn           string   `json:"name_en"`           // 英文名称
+		DepartmentLeader []string `json:"department_leader"` // 部门负责人的UserID
+		ParentID         int      `json:"parentid"`          // 父部门id。根部门为1
+		Order            int      `json:"order"`             // 在父部门中的次序值。order值大的排序靠前
+	}
 )

 // DepartmentSimpleList 获取子部门ID列表
@@ -45,3 +62,25 @@ func (r *Client) DepartmentSimpleList(departmentID int) ([]*DepartmentID, error)
 	}
 	return result.DepartmentID, nil
 }
+
+// DepartmentList 获取部门列表
+// @desc https://developer.work.weixin.qq.com/document/path/90208
+func (r *Client) DepartmentList() ([]*Department, error) {
+	// 获取accessToken
+	accessToken, err := r.GetAccessToken()
+	if err != nil {
+		return nil, err
+	}
+	// 发起http请求
+	response, err := util.HTTPGet(fmt.Sprintf(departmentListURL, accessToken))
+	if err != nil {
+		return nil, err
+	}
+	// 按照结构体解析返回值
+	result := &DepartmentListResponse{}
+	if err = util.DecodeWithError(response, result, "DepartmentList"); err != nil {
+		return nil, err
+	}
+	// 返回数据
+	return result.Department, err
+}
--- a/work/externalcontact/moment.go
+++ b/work/externalcontact/moment.go
@@ -0,0 +1,658 @@
+package externalcontact
+
+import (
+	"fmt"
+
+	"github.com/silenceper/wechat/v2/util"
+)
+
+const (
+	// addMomentTaskURL 创建发表任务
+	addMomentTaskURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/add_moment_task?access_token=%s"
+	// getMomentTaskResultURL 获取任务创建结果
+	getMomentTaskResultURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get_moment_task_result?access_token=%s&jobid=%s"
+	// cancelMomentTaskURL 停止发表企业朋友圈
+	cancelMomentTaskURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/cancel_moment_task?access_token=%s"
+	// getMomentListURL 获取企业全部的发表列表
+	getMomentListURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get_moment_list?access_token=%s"
+	// getMomentTaskURL 获取客户朋友圈企业发表的列表
+	getMomentTaskURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get_moment_task?access_token=%s"
+	// getMomentCustomerListURL 获取客户朋友圈发表时选择的可见范围
+	getMomentCustomerListURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get_moment_customer_list?access_token=%s"
+	// getMomentSendResultURL 获取客户朋友圈发表后的可见客户列表
+	getMomentSendResultURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get_moment_send_result?access_token=%s"
+	// getMomentCommentsURL 获取客户朋友圈的互动数据
+	getMomentCommentsURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get_moment_comments?access_token=%s"
+	// listMomentStrategyURL 获取规则组列表
+	listMomentStrategyURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/moment_strategy/list?access_token=%s"
+	// getMomentStrategyURL 获取规则组详情
+	getMomentStrategyURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/moment_strategy/get?access_token=%s"
+	// getRangeMomentStrategyURL 获取规则组管理范围
+	getRangeMomentStrategyURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/moment_strategy/get_range?access_token=%s"
+	// createMomentStrategyURL 创建新的规则组
+	createMomentStrategyURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/moment_strategy/create?access_token=%s"
+	// editMomentStrategyURL 编辑规则组及其管理范围
+	editMomentStrategyURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/moment_strategy/edit?access_token=%s"
+	// delMomentStrategyURL 删除规则组
+	delMomentStrategyURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/moment_strategy/del?access_token=%s"
+)
+
+// AddMomentTaskRequest 创建发表任务请求
+type AddMomentTaskRequest struct {
+	Text         MomentTaskText         `json:"text"`
+	Attachments  []MomentTaskAttachment `json:"attachments"`
+	VisibleRange MomentVisibleRange     `json:"visible_range"`
+}
+
+// MomentTaskText 发表任务文本消息
+type MomentTaskText struct {
+	Content string `json:"content"`
+}
+
+// MomentTaskImage 发表任务图片消息
+type MomentTaskImage struct {
+	MediaID string `json:"media_id"`
+}
+
+// MomentTaskVideo 发表任务视频消息
+type MomentTaskVideo struct {
+	MediaID string `json:"media_id"`
+}
+
+// MomentTaskLink 发表任务图文消息
+type MomentTaskLink struct {
+	Title   string `json:"title"`
+	URL     string `json:"url"`
+	MediaID string `json:"media_id"`
+}
+
+// MomentTaskAttachment 发表任务附件
+type MomentTaskAttachment struct {
+	MsgType string          `json:"msgtype"`
+	Image   MomentTaskImage `json:"image,omitempty"`
+	Video   MomentTaskVideo `json:"video,omitempty"`
+	Link    MomentTaskLink  `json:"link,omitempty"`
+}
+
+// MomentVisibleRange 朋友圈指定的发表范围
+type MomentVisibleRange struct {
+	SenderList          MomentSenderList          `json:"sender_list"`
+	ExternalContactList MomentExternalContactList `json:"external_contact_list"`
+}
+
+// MomentSenderList 发表任务的执行者列表
+type MomentSenderList struct {
+	UserList       []string `json:"user_list"`
+	DepartmentList []int    `json:"department_list"`
+}
+
+// MomentExternalContactList 可见到该朋友圈的客户列表
+type MomentExternalContactList struct {
+	TagList []string `json:"tag_list"`
+}
+
+// AddMomentTaskResponse 创建发表任务响应
+type AddMomentTaskResponse struct {
+	util.CommonError
+	JobID string `json:"jobid"`
+}
+
+// AddMomentTask 创建发表任务
+// see https://developer.work.weixin.qq.com/document/path/95094#%E5%88%9B%E5%BB%BA%E5%8F%91%E8%A1%A8%E4%BB%BB%E5%8A%A1
+func (r *Client) AddMomentTask(req *AddMomentTaskRequest) (*AddMomentTaskResponse, error) {
+	var (
+		accessToken string
+		err         error
+	)
+	if accessToken, err = r.GetAccessToken(); err != nil {
+		return nil, err
+	}
+	var response []byte
+	if response, err = util.PostJSON(fmt.Sprintf(addMomentTaskURL, accessToken), req); err != nil {
+		return nil, err
+	}
+	result := &AddMomentTaskResponse{}
+	if err = util.DecodeWithError(response, result, "AddMomentTask"); err != nil {
+		return nil, err
+	}
+	return result, nil
+}
+
+// GetMomentTaskResultResponse 获取任务创建结果响应
+type GetMomentTaskResultResponse struct {
+	util.CommonError
+	Status int              `json:"status"`
+	Type   string           `json:"type"`
+	Result MomentTaskResult `json:"result"`
+}
+
+// MomentTaskResult 任务创建结果
+type MomentTaskResult struct {
+	ErrCode                    int64                            `json:"errcode"`
+	ErrMsg                     string                           `json:"errmsg"`
+	MomentID                   string                           `json:"moment_id"`
+	InvalidSenderList          MomentInvalidSenderList          `json:"invalid_sender_list"`
+	InvalidExternalContactList MomentInvalidExternalContactList `json:"invalid_external_contact_list"`
+}
+
+// MomentInvalidSenderList 不合法的执行者列表
+type MomentInvalidSenderList struct {
+	UserList       []string `json:"user_list"`
+	DepartmentList []int    `json:"department_list"`
+}
+
+// MomentInvalidExternalContactList 不合法的可见到该朋友圈的客户列表
+type MomentInvalidExternalContactList struct {
+	TagList []string `json:"tag_list"`
+}
+
+// GetMomentTaskResult 获取任务创建结果
+// see https://developer.work.weixin.qq.com/document/path/95094#%E8%8E%B7%E5%8F%96%E4%BB%BB%E5%8A%A1%E5%88%9B%E5%BB%BA%E7%BB%93%E6%9E%9C
+func (r *Client) GetMomentTaskResult(jobID string) (*GetMomentTaskResultResponse, error) {
+	var (
+		accessToken string
+		err         error
+	)
+	if accessToken, err = r.GetAccessToken(); err != nil {
+		return nil, err
+	}
+	var response []byte
+	if response, err = util.HTTPGet(fmt.Sprintf(getMomentTaskResultURL, accessToken, jobID)); err != nil {
+		return nil, err
+	}
+	result := &GetMomentTaskResultResponse{}
+	if err = util.DecodeWithError(response, result, "GetMomentTaskResult"); err != nil {
+		return nil, err
+	}
+	return result, nil
+}
+
+// CancelMomentTaskRequest 停止发表企业朋友圈请求
+type CancelMomentTaskRequest struct {
+	MomentID string `json:"moment_id"`
+}
+
+// CancelMomentTask 停止发表企业朋友圈
+// see https://developer.work.weixin.qq.com/document/path/97612
+func (r *Client) CancelMomentTask(req *CancelMomentTaskRequest) error {
+	var (
+		accessToken string
+		err         error
+	)
+	if accessToken, err = r.GetAccessToken(); err != nil {
+		return err
+	}
+	var response []byte
+	if response, err = util.PostJSON(fmt.Sprintf(cancelMomentTaskURL, accessToken), req); err != nil {
+		return err
+	}
+	return util.DecodeWithCommonError(response, "CancelMomentTask")
+}
+
+// GetMomentListRequest 获取企业全部的发表列表请求
+type GetMomentListRequest struct {
+	StartTime  int64  `json:"start_time"`
+	EndTime    int64  `json:"end_time"`
+	Creator    string `json:"creator"`
+	FilterType int    `json:"filter_type"`
+	Cursor     string `json:"cursor"`
+	Limit      int    `json:"limit"`
+}
+
+// GetMomentListResponse 获取企业全部的发表列表响应
+type GetMomentListResponse struct {
+	util.CommonError
+	NextCursor string       `json:"next_cursor"`
+	MomentList []MomentItem `json:"moment_list"`
+}
+
+// MomentItem 朋友圈
+type MomentItem struct {
+	MomentID    string         `json:"moment_id"`
+	Creator     string         `json:"creator"`
+	CreateTime  int64          `json:"create_time"`
+	CreateType  int            `json:"create_type"`
+	VisibleType int            `json:"visible_type"`
+	Text        MomentText     `json:"text"`
+	Image       []MomentImage  `json:"image"`
+	Video       MomentVideo    `json:"video"`
+	Link        MomentLink     `json:"link"`
+	Location    MomentLocation `json:"location"`
+}
+
+// MomentText 朋友圈文本消息
+type MomentText struct {
+	Content string `json:"content"`
+}
+
+// MomentImage 朋友圈图片
+type MomentImage struct {
+	MediaID string `json:"media_id"`
+}
+
+// MomentVideo 朋友圈视频
+type MomentVideo struct {
+	MediaID      string `json:"media_id"`
+	ThumbMediaID string `json:"thumb_media_id"`
+}
+
+// MomentLink 朋友圈网页链接
+type MomentLink struct {
+	Title string `json:"title"`
+	URL   string `json:"url"`
+}
+
+// MomentLocation 朋友圈地理位置
+type MomentLocation struct {
+	Latitude  string `json:"latitude"`
+	Longitude string `json:"longitude"`
+	Name      string `json:"name"`
+}
+
+// GetMomentList 获取企业全部的发表列表
+// see https://developer.work.weixin.qq.com/document/path/93333#%E8%8E%B7%E5%8F%96%E4%BC%81%E4%B8%9A%E5%85%A8%E9%83%A8%E7%9A%84%E5%8F%91%E8%A1%A8%E5%88%97%E8%A1%A8
+func (r *Client) GetMomentList(req *GetMomentListRequest) (*GetMomentListResponse, error) {
+	var (
+		accessToken string
+		err         error
+	)
+	if accessToken, err = r.GetAccessToken(); err != nil {
+		return nil, err
+	}
+	var response []byte
+	if response, err = util.PostJSON(fmt.Sprintf(getMomentListURL, accessToken), req); err != nil {
+		return nil, err
+	}
+	result := &GetMomentListResponse{}
+	if err = util.DecodeWithError(response, result, "GetMomentList"); err != nil {
+		return nil, err
+	}
+	return result, nil
+}
+
+// GetMomentTaskRequest 获取客户朋友圈企业发表的列表请求
+type GetMomentTaskRequest struct {
+	MomentID string `json:"moment_id"`
+	Cursor   string `json:"cursor"`
+	Limit    int    `json:"limit"`
+}
+
+// GetMomentTaskResponse 获取客户朋友圈企业发表的列表响应
+type GetMomentTaskResponse struct {
+	util.CommonError
+	NextCursor string       `json:"next_cursor"`
+	TaskList   []MomentTask `json:"task_list"`
+}
+
+// MomentTask 发表任务
+type MomentTask struct {
+	UserID        string `json:"userid"`
+	PublishStatus int    `json:"publish_status"`
+}
+
+// GetMomentTask 获取客户朋友圈企业发表的列表
+// see https://developer.work.weixin.qq.com/document/path/93333#%E8%8E%B7%E5%8F%96%E5%AE%A2%E6%88%B7%E6%9C%8B%E5%8F%8B%E5%9C%88%E4%BC%81%E4%B8%9A%E5%8F%91%E8%A1%A8%E7%9A%84%E5%88%97%E8%A1%A8
+func (r *Client) GetMomentTask(req *GetMomentTaskRequest) (*GetMomentTaskResponse, error) {
+	var (
+		accessToken string
+		err         error
+	)
+	if accessToken, err = r.GetAccessToken(); err != nil {
+		return nil, err
+	}
+	var response []byte
+	if response, err = util.PostJSON(fmt.Sprintf(getMomentTaskURL, accessToken), req); err != nil {
+		return nil, err
+	}
+	result := &GetMomentTaskResponse{}
+	if err = util.DecodeWithError(response, result, "GetMomentTask"); err != nil {
+		return nil, err
+	}
+	return result, nil
+}
+
+// GetMomentCustomerListRequest 获取客户朋友圈发表时选择的可见范围请求
+type GetMomentCustomerListRequest struct {
+	MomentID string `json:"moment_id"`
+	UserID   string `json:"userid"`
+	Cursor   string `json:"cursor"`
+	Limit    int    `json:"limit"`
+}
+
+// GetMomentCustomerListResponse 获取客户朋友圈发表时选择的可见范围响应
+type GetMomentCustomerListResponse struct {
+	util.CommonError
+	NextCursor   string           `json:"next_cursor"`
+	CustomerList []MomentCustomer `json:"customer_list"`
+}
+
+// MomentCustomer 成员可见客户列表
+type MomentCustomer struct {
+	UserID         string `json:"userid"`
+	ExternalUserID string `json:"external_userid"`
+}
+
+// GetMomentCustomerList 获取客户朋友圈发表时选择的可见范围
+// see https://developer.work.weixin.qq.com/document/path/93333#%E8%8E%B7%E5%8F%96%E5%AE%A2%E6%88%B7%E6%9C%8B%E5%8F%8B%E5%9C%88%E5%8F%91%E8%A1%A8%E6%97%B6%E9%80%89%E6%8B%A9%E7%9A%84%E5%8F%AF%E8%A7%81%E8%8C%83%E5%9B%B4
+func (r *Client) GetMomentCustomerList(req *GetMomentCustomerListRequest) (*GetMomentCustomerListResponse, error) {
+	var (
+		accessToken string
+		err         error
+	)
+	if accessToken, err = r.GetAccessToken(); err != nil {
+		return nil, err
+	}
+	var response []byte
+	if response, err = util.PostJSON(fmt.Sprintf(getMomentCustomerListURL, accessToken), req); err != nil {
+		return nil, err
+	}
+	result := &GetMomentCustomerListResponse{}
+	if err = util.DecodeWithError(response, result, "GetMomentCustomerList"); err != nil {
+		return nil, err
+	}
+	return result, nil
+}
+
+// GetMomentSendResultRequest 获取客户朋友圈发表后的可见客户列表请求
+type GetMomentSendResultRequest struct {
+	MomentID string `json:"moment_id"`
+	UserID   string `json:"userid"`
+	Cursor   string `json:"cursor"`
+	Limit    int    `json:"limit"`
+}
+
+// GetMomentSendResultResponse 获取客户朋友圈发表后的可见客户列表响应
+type GetMomentSendResultResponse struct {
+	util.CommonError
+	NextCursor   string               `json:"next_cursor"`
+	CustomerList []MomentSendCustomer `json:"customer_list"`
+}
+
+// MomentSendCustomer 成员发送成功客户
+type MomentSendCustomer struct {
+	ExternalUserID string `json:"external_userid"`
+}
+
+// GetMomentSendResult 获取客户朋友圈发表后的可见客户列表
+// see https://developer.work.weixin.qq.com/document/path/93333#%E8%8E%B7%E5%8F%96%E5%AE%A2%E6%88%B7%E6%9C%8B%E5%8F%8B%E5%9C%88%E5%8F%91%E8%A1%A8%E5%90%8E%E7%9A%84%E5%8F%AF%E8%A7%81%E5%AE%A2%E6%88%B7%E5%88%97%E8%A1%A8
+func (r *Client) GetMomentSendResult(req *GetMomentSendResultRequest) (*GetMomentSendResultResponse, error) {
+	var (
+		accessToken string
+		err         error
+	)
+	if accessToken, err = r.GetAccessToken(); err != nil {
+		return nil, err
+	}
+	var response []byte
+	if response, err = util.PostJSON(fmt.Sprintf(getMomentSendResultURL, accessToken), req); err != nil {
+		return nil, err
+	}
+	result := &GetMomentSendResultResponse{}
+	if err = util.DecodeWithError(response, result, "GetMomentSendResult"); err != nil {
+		return nil, err
+	}
+	return result, nil
+}
+
+// GetMomentCommentsRequest 获取客户朋友圈的互动数据请求
+type GetMomentCommentsRequest struct {
+	MomentID string `json:"moment_id"`
+	UserID   string `json:"userid"`
+}
+
+// GetMomentCommentsResponse 获取客户朋友圈的互动数据响应
+type GetMomentCommentsResponse struct {
+	util.CommonError
+	CommentList []MomentComment `json:"comment_list"`
+	LikeList    []MomentLike    `json:"like_list"`
+}
+
+// MomentComment 朋友圈评论
+type MomentComment struct {
+	ExternalUserID string `json:"external_userid,omitempty"`
+	UserID         string `json:"userid,omitempty"`
+	CreateTime     int64  `json:"create_time"`
+}
+
+// MomentLike 朋友圈点赞
+type MomentLike struct {
+	ExternalUserID string `json:"external_userid,omitempty"`
+	UserID         string `json:"userid,omitempty"`
+	CreateTime     int64  `json:"create_time"`
+}
+
+// GetMomentComments 获取客户朋友圈的互动数据
+// see https://developer.work.weixin.qq.com/document/path/93333#%E8%8E%B7%E5%8F%96%E5%AE%A2%E6%88%B7%E6%9C%8B%E5%8F%8B%E5%9C%88%E7%9A%84%E4%BA%92%E5%8A%A8%E6%95%B0%E6%8D%AE
+func (r *Client) GetMomentComments(req *GetMomentCommentsRequest) (*GetMomentCommentsResponse, error) {
+	var (
+		accessToken string
+		err         error
+	)
+	if accessToken, err = r.GetAccessToken(); err != nil {
+		return nil, err
+	}
+	var response []byte
+	if response, err = util.PostJSON(fmt.Sprintf(getMomentCommentsURL, accessToken), req); err != nil {
+		return nil, err
+	}
+	result := &GetMomentCommentsResponse{}
+	if err = util.DecodeWithError(response, result, "GetMomentComments"); err != nil {
+		return nil, err
+	}
+	return result, nil
+}
+
+// ListMomentStrategyRequest 获取规则组列表请求
+type ListMomentStrategyRequest struct {
+	Cursor string `json:"cursor"`
+	Limit  int    `json:"limit"`
+}
+
+// ListMomentStrategyResponse 获取规则组列表响应
+type ListMomentStrategyResponse struct {
+	util.CommonError
+	Strategy   []MomentStrategyID `json:"strategy"`
+	NextCursor string             `json:"next_cursor"`
+}
+
+// MomentStrategyID 规则组ID
+type MomentStrategyID struct {
+	StrategyID int `json:"strategy_id"`
+}
+
+// ListMomentStrategy 获取规则组列表
+// see https://developer.work.weixin.qq.com/document/path/94890#%E8%8E%B7%E5%8F%96%E8%A7%84%E5%88%99%E7%BB%84%E5%88%97%E8%A1%A8
+func (r *Client) ListMomentStrategy(req *ListMomentStrategyRequest) (*ListMomentStrategyResponse, error) {
+	var (
+		accessToken string
+		err         error
+	)
+	if accessToken, err = r.GetAccessToken(); err != nil {
+		return nil, err
+	}
+	var response []byte
+	if response, err = util.PostJSON(fmt.Sprintf(listMomentStrategyURL, accessToken), req); err != nil {
+		return nil, err
+	}
+	result := &ListMomentStrategyResponse{}
+	if err = util.DecodeWithError(response, result, "ListMomentStrategy"); err != nil {
+		return nil, err
+	}
+	return result, nil
+}
+
+// GetMomentStrategyRequest 获取规则组详情请求
+type GetMomentStrategyRequest struct {
+	StrategyID int `json:"strategy_id"`
+}
+
+// GetMomentStrategyResponse 获取规则组详情响应
+type GetMomentStrategyResponse struct {
+	util.CommonError
+	Strategy MomentStrategy `json:"strategy"`
+}
+
+// MomentStrategy 规则组
+type MomentStrategy struct {
+	StrategyID   int             `json:"strategy_id"`
+	ParentID     int             `json:"parent_id"`
+	StrategyName string          `json:"strategy_name"`
+	CreateTime   int64           `json:"create_time"`
+	AdminList    []string        `json:"admin_list"`
+	Privilege    MomentPrivilege `json:"privilege"`
+}
+
+// MomentPrivilege 规则组权限
+type MomentPrivilege struct {
+	ViewMomentList           bool `json:"view_moment_list"`
+	SendMoment               bool `json:"send_moment"`
+	ManageMomentCoverAndSign bool `json:"manage_moment_cover_and_sign"`
+}
+
+// GetMomentStrategy 获取规则组详情
+// see https://developer.work.weixin.qq.com/document/path/94890#%E8%8E%B7%E5%8F%96%E8%A7%84%E5%88%99%E7%BB%84%E8%AF%A6%E6%83%85
+func (r *Client) GetMomentStrategy(req *GetMomentStrategyRequest) (*GetMomentStrategyResponse, error) {
+	var (
+		accessToken string
+		err         error
+	)
+	if accessToken, err = r.GetAccessToken(); err != nil {
+		return nil, err
+	}
+	var response []byte
+	if response, err = util.PostJSON(fmt.Sprintf(getMomentStrategyURL, accessToken), req); err != nil {
+		return nil, err
+	}
+	result := &GetMomentStrategyResponse{}
+	if err = util.DecodeWithError(response, result, "GetMomentStrategy"); err != nil {
+		return nil, err
+	}
+	return result, nil
+}
+
+// GetRangeMomentStrategyRequest 获取规则组管理范围请求
+type GetRangeMomentStrategyRequest struct {
+	StrategyID int    `json:"strategy_id"`
+	Cursor     string `json:"cursor"`
+	Limit      int    `json:"limit"`
+}
+
+// GetRangeMomentStrategyResponse 获取规则组管理范围响应
+type GetRangeMomentStrategyResponse struct {
+	util.CommonError
+	Range      []RangeMomentStrategy `json:"range"`
+	NextCursor string                `json:"next_cursor"`
+}
+
+// RangeMomentStrategy 	管理范围内配置的成员或部门
+type RangeMomentStrategy struct {
+	Type    int    `json:"type"`
+	UserID  string `json:"userid,omitempty"`
+	PartyID int    `json:"partyid,omitempty"`
+}
+
+// GetRangeMomentStrategy 获取规则组管理范围
+// see https://developer.work.weixin.qq.com/document/path/94890#%E8%8E%B7%E5%8F%96%E8%A7%84%E5%88%99%E7%BB%84%E7%AE%A1%E7%90%86%E8%8C%83%E5%9B%B4
+func (r *Client) GetRangeMomentStrategy(req *GetRangeMomentStrategyRequest) (*GetRangeMomentStrategyResponse, error) {
+	var (
+		accessToken string
+		err         error
+	)
+	if accessToken, err = r.GetAccessToken(); err != nil {
+		return nil, err
+	}
+	var response []byte
+	if response, err = util.PostJSON(fmt.Sprintf(getRangeMomentStrategyURL, accessToken), req); err != nil {
+		return nil, err
+	}
+	result := &GetRangeMomentStrategyResponse{}
+	if err = util.DecodeWithError(response, result, "GetRangeMomentStrategy"); err != nil {
+		return nil, err
+	}
+	return result, nil
+}
+
+// CreateMomentStrategyRequest 创建新的规则组请求
+type CreateMomentStrategyRequest struct {
+	ParentID     int                   `json:"parent_id"`
+	StrategyName string                `json:"strategy_name"`
+	AdminList    []string              `json:"admin_list"`
+	Privilege    MomentPrivilege       `json:"privilege"`
+	Range        []RangeMomentStrategy `json:"range"`
+}
+
+// CreateMomentStrategyResponse 创建新的规则组响应
+type CreateMomentStrategyResponse struct {
+	util.CommonError
+	StrategyID int `json:"strategy_id"`
+}
+
+// CreateMomentStrategy 创建新的规则组
+// see https://developer.work.weixin.qq.com/document/path/94890#%E5%88%9B%E5%BB%BA%E6%96%B0%E7%9A%84%E8%A7%84%E5%88%99%E7%BB%84
+func (r *Client) CreateMomentStrategy(req *CreateMomentStrategyRequest) (*CreateMomentStrategyResponse, error) {
+	var (
+		accessToken string
+		err         error
+	)
+	if accessToken, err = r.GetAccessToken(); err != nil {
+		return nil, err
+	}
+	var response []byte
+	if response, err = util.PostJSON(fmt.Sprintf(createMomentStrategyURL, accessToken), req); err != nil {
+		return nil, err
+	}
+	result := &CreateMomentStrategyResponse{}
+	if err = util.DecodeWithError(response, result, "CreateMomentStrategy"); err != nil {
+		return nil, err
+	}
+	return result, nil
+}
+
+// EditMomentStrategyRequest 编辑规则组及其管理范围请求
+type EditMomentStrategyRequest struct {
+	StrategyID   int                   `json:"strategy_id"`
+	StrategyName string                `json:"strategy_name"`
+	AdminList    []string              `json:"admin_list"`
+	Privilege    MomentPrivilege       `json:"privilege"`
+	RangeAdd     []RangeMomentStrategy `json:"range_add"`
+	RangeDel     []RangeMomentStrategy `json:"range_del"`
+}
+
+// EditMomentStrategy 编辑规则组及其管理范围
+// see https://developer.work.weixin.qq.com/document/path/94890#%E7%BC%96%E8%BE%91%E8%A7%84%E5%88%99%E7%BB%84%E5%8F%8A%E5%85%B6%E7%AE%A1%E7%90%86%E8%8C%83%E5%9B%B4
+func (r *Client) EditMomentStrategy(req *EditMomentStrategyRequest) error {
+	var (
+		accessToken string
+		err         error
+	)
+	if accessToken, err = r.GetAccessToken(); err != nil {
+		return err
+	}
+	var response []byte
+	if response, err = util.PostJSON(fmt.Sprintf(editMomentStrategyURL, accessToken), req); err != nil {
+		return err
+	}
+	return util.DecodeWithCommonError(response, "EditMomentStrategy")
+}
+
+// DelMomentStrategyRequest 删除规则组请求
+type DelMomentStrategyRequest struct {
+	StrategyID int `json:"strategy_id"`
+}
+
+// DelMomentStrategy 删除规则组
+// see https://developer.work.weixin.qq.com/document/path/94890#%E5%88%A0%E9%99%A4%E8%A7%84%E5%88%99%E7%BB%84
+func (r *Client) DelMomentStrategy(req *DelMomentStrategyRequest) error {
+	var (
+		accessToken string
+		err         error
+	)
+	if accessToken, err = r.GetAccessToken(); err != nil {
+		return err
+	}
+	var response []byte
+	if response, err = util.PostJSON(fmt.Sprintf(delMomentStrategyURL, accessToken), req); err != nil {
+		return err
+	}
+	return util.DecodeWithCommonError(response, "DelMomentStrategy")
+}
--- a/work/externalcontact/transfer.go
+++ b/work/externalcontact/transfer.go
@@ -0,0 +1,291 @@
+package externalcontact
+
+import (
+	"fmt"
+
+	"github.com/silenceper/wechat/v2/util"
+)
+
+const (
+	// transferCustomerURL 分配在职成员的客户
+	transferCustomerURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/transfer_customer?access_token=%s"
+	// transferResultURL 查询客户接替状态
+	transferResultURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/transfer_result?access_token=%s"
+	// groupChatOnJobTransferURL 分配在职成员的客户群
+	groupChatOnJobTransferURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/groupchat/onjob_transfer?access_token=%s"
+	// getUnassignedListURL 获取待分配的离职成员列表
+	getUnassignedListURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get_unassigned_list?access_token=%s"
+	// resignedTransferCustomerURL 分配离职成员的客户
+	resignedTransferCustomerURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/resigned/transfer_customer?access_token=%s"
+	// resignedTransferResultURL 查询离职客户接替状态
+	resignedTransferResultURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/resigned/transfer_result?access_token=%s"
+	// groupChatTransferURL 分配离职成员的客户群
+	groupChatTransferURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/groupchat/transfer?access_token=%s"
+)
+
+// TransferCustomerRequest 分配在职成员的客户请求
+type TransferCustomerRequest struct {
+	HandoverUserID     string   `json:"handover_userid"`
+	TakeoverUserID     string   `json:"takeover_userid"`
+	ExternalUserID     []string `json:"external_userid"`
+	TransferSuccessMsg string   `json:"transfer_success_msg"`
+}
+
+// TransferCustomerResponse 分配在职成员的客户请求响应
+type TransferCustomerResponse struct {
+	util.CommonError
+	Customer []TransferCustomerItem `json:"customer"`
+}
+
+// TransferCustomerItem 客户分配结果
+type TransferCustomerItem struct {
+	ExternalUserID string `json:"external_userid"`
+	ErrCode        int    `json:"errcode"`
+}
+
+// TransferCustomer 分配在职成员的客户
+// see https://developer.work.weixin.qq.com/document/path/92125
+func (r *Client) TransferCustomer(req *TransferCustomerRequest) (*TransferCustomerResponse, error) {
+	var (
+		accessToken string
+		err         error
+	)
+	if accessToken, err = r.GetAccessToken(); err != nil {
+		return nil, err
+	}
+	var response []byte
+	if response, err = util.PostJSON(fmt.Sprintf(transferCustomerURL, accessToken), req); err != nil {
+		return nil, err
+	}
+	result := &TransferCustomerResponse{}
+	if err = util.DecodeWithError(response, result, "TransferCustomer"); err != nil {
+		return nil, err
+	}
+	return result, nil
+}
+
+// TransferResultRequest 查询客户接替状态请求
+type TransferResultRequest struct {
+	HandoverUserID string `json:"handover_userid"`
+	TakeoverUserID string `json:"takeover_userid"`
+	Cursor         string `json:"cursor"`
+}
+
+// TransferResultResponse 查询客户接替状态响应
+type TransferResultResponse struct {
+	util.CommonError
+	Customer   []TransferResultItem `json:"customer"`
+	NextCursor string               `json:"next_cursor"`
+}
+
+// TransferResultItem 客户接替状态
+type TransferResultItem struct {
+	ExternalUserID string `json:"external_userid"`
+	Status         int    `json:"status"`
+	TakeoverTime   int64  `json:"takeover_time"`
+}
+
+// TransferResult 查询客户接替状态
+// see https://developer.work.weixin.qq.com/document/path/94088
+func (r *Client) TransferResult(req *TransferResultRequest) (*TransferResultResponse, error) {
+	var (
+		accessToken string
+		err         error
+	)
+	if accessToken, err = r.GetAccessToken(); err != nil {
+		return nil, err
+	}
+	var response []byte
+	if response, err = util.PostJSON(fmt.Sprintf(transferResultURL, accessToken), req); err != nil {
+		return nil, err
+	}
+	result := &TransferResultResponse{}
+	if err = util.DecodeWithError(response, result, "TransferResult"); err != nil {
+		return nil, err
+	}
+	return result, nil
+}
+
+// GroupChatOnJobTransferRequest 分配在职成员的客户群请求
+type GroupChatOnJobTransferRequest struct {
+	ChatIDList []string `json:"chat_id_list"`
+	NewOwner   string   `json:"new_owner"`
+}
+
+// GroupChatOnJobTransferResponse 分配在职成员的客户群响应
+type GroupChatOnJobTransferResponse struct {
+	util.CommonError
+	FailedChatList []FailedChat `json:"failed_chat_list"`
+}
+
+// FailedChat 没能成功继承的群
+type FailedChat struct {
+	ChatID  string `json:"chat_id"`
+	ErrCode int    `json:"errcode"`
+	ErrMsg  string `json:"errmsg"`
+}
+
+// GroupChatOnJobTransfer 分配在职成员的客户群
+// see https://developer.work.weixin.qq.com/document/path/95703
+func (r *Client) GroupChatOnJobTransfer(req *GroupChatOnJobTransferRequest) (*GroupChatOnJobTransferResponse, error) {
+	var (
+		accessToken string
+		err         error
+	)
+	if accessToken, err = r.GetAccessToken(); err != nil {
+		return nil, err
+	}
+	var response []byte
+	if response, err = util.PostJSON(fmt.Sprintf(groupChatOnJobTransferURL, accessToken), req); err != nil {
+		return nil, err
+	}
+	result := &GroupChatOnJobTransferResponse{}
+	if err = util.DecodeWithError(response, result, "GroupChatOnJobTransfer"); err != nil {
+		return nil, err
+	}
+	return result, nil
+}
+
+// GetUnassignedListRequest 获取待分配的离职成员列表请求
+type GetUnassignedListRequest struct {
+	Cursor   string `json:"cursor"`
+	PageSize int    `json:"page_size"`
+}
+
+// GetUnassignedListResponse 获取待分配的离职成员列表响应
+type GetUnassignedListResponse struct {
+	util.CommonError
+	Info       []UnassignedListInfo `json:"info"`
+	IsLast     bool                 `json:"is_last"`
+	NextCursor string               `json:"next_cursor"`
+}
+
+// UnassignedListInfo 离职成员信息
+type UnassignedListInfo struct {
+	HandoverUserID string `json:"handover_userid"`
+	ExternalUserID string `json:"external_userid"`
+	DimissionTime  int64  `json:"dimission_time"`
+}
+
+// GetUnassignedList 获取待分配的离职成员列表
+// see https://developer.work.weixin.qq.com/document/path/92124
+func (r *Client) GetUnassignedList(req *GetUnassignedListRequest) (*GetUnassignedListResponse, error) {
+	var (
+		accessToken string
+		err         error
+	)
+	if accessToken, err = r.GetAccessToken(); err != nil {
+		return nil, err
+	}
+	var response []byte
+	if response, err = util.PostJSON(fmt.Sprintf(getUnassignedListURL, accessToken), req); err != nil {
+		return nil, err
+	}
+	result := &GetUnassignedListResponse{}
+	if err = util.DecodeWithError(response, result, "GetUnassignedList"); err != nil {
+		return nil, err
+	}
+	return result, nil
+}
+
+// ResignedTransferCustomerRequest 分配离职成员的客户请求
+type ResignedTransferCustomerRequest struct {
+	HandoverUserID string   `json:"handover_userid"`
+	TakeoverUserID string   `json:"takeover_userid"`
+	ExternalUserID []string `json:"external_userid"`
+}
+
+// ResignedTransferCustomerResponse 分配离职成员的客户响应
+type ResignedTransferCustomerResponse struct {
+	util.CommonError
+	Customer []TransferCustomerItem `json:"customer"`
+}
+
+// ResignedTransferCustomer 分配离职成员的客户
+// see https://developer.work.weixin.qq.com/document/path/94081
+func (r *Client) ResignedTransferCustomer(req *ResignedTransferCustomerRequest) (*ResignedTransferCustomerResponse, error) {
+	var (
+		accessToken string
+		err         error
+	)
+	if accessToken, err = r.GetAccessToken(); err != nil {
+		return nil, err
+	}
+	var response []byte
+	if response, err = util.PostJSON(fmt.Sprintf(resignedTransferCustomerURL, accessToken), req); err != nil {
+		return nil, err
+	}
+	result := &ResignedTransferCustomerResponse{}
+	if err = util.DecodeWithError(response, result, "ResignedTransferCustomer"); err != nil {
+		return nil, err
+	}
+	return result, nil
+}
+
+// ResignedTransferResultRequest 查询离职客户接替状态请求
+type ResignedTransferResultRequest struct {
+	HandoverUserID string `json:"handover_userid"`
+	TakeoverUserID string `json:"takeover_userid"`
+	Cursor         string `json:"cursor"`
+}
+
+// ResignedTransferResultResponse 查询离职客户接替状态响应
+type ResignedTransferResultResponse struct {
+	util.CommonError
+	Customer   []TransferResultItem `json:"customer"`
+	NextCursor string               `json:"next_cursor"`
+}
+
+// ResignedTransferResult 查询离职客户接替状态
+// see https://developer.work.weixin.qq.com/document/path/94082
+func (r *Client) ResignedTransferResult(req *ResignedTransferResultRequest) (*ResignedTransferResultResponse, error) {
+	var (
+		accessToken string
+		err         error
+	)
+	if accessToken, err = r.GetAccessToken(); err != nil {
+		return nil, err
+	}
+	var response []byte
+	if response, err = util.PostJSON(fmt.Sprintf(resignedTransferResultURL, accessToken), req); err != nil {
+		return nil, err
+	}
+	result := &ResignedTransferResultResponse{}
+	if err = util.DecodeWithError(response, result, "ResignedTransferResult"); err != nil {
+		return nil, err
+	}
+	return result, nil
+}
+
+// GroupChatTransferRequest 分配离职成员的客户群请求
+type GroupChatTransferRequest struct {
+	ChatIDList []string `json:"chat_id_list"`
+	NewOwner   string   `json:"new_owner"`
+}
+
+// GroupChatTransferResponse 分配离职成员的客户群响应
+type GroupChatTransferResponse struct {
+	util.CommonError
+	FailedChatList []FailedChat `json:"failed_chat_list"`
+}
+
+// GroupChatTransfer 分配离职成员的客户群
+// see https://developer.work.weixin.qq.com/document/path/92127
+func (r *Client) GroupChatTransfer(req *GroupChatTransferRequest) (*GroupChatTransferResponse, error) {
+	var (
+		accessToken string
+		err         error
+	)
+	if accessToken, err = r.GetAccessToken(); err != nil {
+		return nil, err
+	}
+	var response []byte
+	if response, err = util.PostJSON(fmt.Sprintf(groupChatTransferURL, accessToken), req); err != nil {
+		return nil, err
+	}
+	result := &GroupChatTransferResponse{}
+	if err = util.DecodeWithError(response, result, "GroupChatTransfer"); err != nil {
+		return nil, err
+	}
+	return result, nil
+}
Author	SHA1	Message	Date
houseme	26b0aacb4c	feat: create mini program virtual payment (#709 )	2023-08-21 22:09:30 +08:00
markwang	7df3fe1a09	feat:企业微信-客户联系-客户朋友圈 (#702 ) * feat:企业微信-客户联系-客户朋友圈 * fix:golangci-lint --------- Co-authored-by: markwang <www.wang61@qq.com>	2023-07-31 19:32:34 +08:00
markwang	5a23c5c780	feat:企业微信-客户联系-在职继承/离职继承 (#699 ) Co-authored-by: markwang <www.wang61@qq.com>	2023-07-15 23:58:24 +08:00
黄翠刚	c84eb7b550	新增获取部门列表接口：https://qyapi.weixin.qq.com/cgi-bin/department/list (#698 )	2023-07-15 23:56:53 +08:00