From e73b1ba84153302737bf2912576b823626b500f0 Mon Sep 17 00:00:00 2001
From: 13294258710 <guoshuai19971210@163.com>
Date: Thu, 15 Jun 2023 16:33:46 +0800
Subject: [PATCH 1/5] =?UTF-8?q?=E4=BC=98=E5=8C=96=E6=94=AF=E4=BB=98/?=
 =?UTF-8?q?=E9=80=80=E6=AC=BE=E7=BB=93=E6=9E=9C=E8=A7=A3=E6=9E=90=EF=BC=8C?=
 =?UTF-8?q?=E5=A2=9E=E5=8A=A0=E5=AF=B9V3=E7=89=88=E6=9C=AC=E6=9C=8D?=
 =?UTF-8?q?=E5=8A=A1=E5=95=86=E7=9A=84=E4=B8=8B=E5=8D=95/=E9=80=80?=
 =?UTF-8?q?=E6=AC=BE=E6=94=AF=E6=8C=81?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../bean/notify/WxPayBaseNotifyV3Result.java  |  32 +
 ...V3Result.java => WxPayNotifyV3Result.java} |   2 +-
 .../notify/WxPayPartnerNotifyV3Result.java    | 568 ++++++++++++++++
 .../WxPayPartnerRefundNotifyV3Result.java     | 230 +++++++
 .../notify/WxPayRefundNotifyV3Result.java     |   2 +-
 .../request/WxPayPartnerRefundV3Request.java  |  55 ++
 .../WxPayPartnerUnifiedOrderV3Request.java    | 610 ++++++++++++++++++
 .../wxpay/service/WxPayService.java           |  65 +-
 .../service/impl/BaseWxPayServiceImpl.java    |  75 ++-
 .../impl/BaseWxPayServiceImplTest.java        |   2 +-
 10 files changed, 1611 insertions(+), 30 deletions(-)
 create mode 100644 weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/WxPayBaseNotifyV3Result.java
 rename weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/{WxPayOrderNotifyV3Result.java => WxPayNotifyV3Result.java} (99%)
 create mode 100644 weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/WxPayPartnerNotifyV3Result.java
 create mode 100644 weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/WxPayPartnerRefundNotifyV3Result.java
 create mode 100644 weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/request/WxPayPartnerRefundV3Request.java
 create mode 100644 weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/request/WxPayPartnerUnifiedOrderV3Request.java

diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/WxPayBaseNotifyV3Result.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/WxPayBaseNotifyV3Result.java
new file mode 100644
index 0000000000..41d6ab4273
--- /dev/null
+++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/WxPayBaseNotifyV3Result.java
@@ -0,0 +1,32 @@
+package com.github.binarywang.wxpay.bean.notify;
+
+/**
+ * 微信支付公用回调
+ *
+ * @author Pursuer
+ * @version 1.0
+ * @date 2023/6/15
+ */
+public interface WxPayBaseNotifyV3Result<T> {
+  /**
+   * 设置原始数据
+   *
+   * @param rawData 原始数据
+   * @return void
+   * @author Pursuer
+   * @date 2023/6/15
+   * @since 1.0
+   **/
+  void setRawData(OriginNotifyResponse rawData);
+
+  /**
+   * 解密后的数据
+   *
+   * @param data
+   * @return void
+   * @author Pursuer
+   * @date 2023/6/15
+   * @since 1.0
+   **/
+  void setResult(T data);
+}
diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/WxPayOrderNotifyV3Result.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/WxPayNotifyV3Result.java
similarity index 99%
rename from weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/WxPayOrderNotifyV3Result.java
rename to weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/WxPayNotifyV3Result.java
index 549e2af16c..22ed94fca3 100644
--- a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/WxPayOrderNotifyV3Result.java
+++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/WxPayNotifyV3Result.java
@@ -15,7 +15,7 @@
  */
 @Data
 @NoArgsConstructor
-public class WxPayOrderNotifyV3Result implements Serializable {
+public class WxPayNotifyV3Result implements Serializable, WxPayBaseNotifyV3Result<WxPayNotifyV3Result.DecryptNotifyResult> {
   private static final long serialVersionUID = -1L;
   /**
    * 源数据
diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/WxPayPartnerNotifyV3Result.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/WxPayPartnerNotifyV3Result.java
new file mode 100644
index 0000000000..2a33910fd5
--- /dev/null
+++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/WxPayPartnerNotifyV3Result.java
@@ -0,0 +1,568 @@
+package com.github.binarywang.wxpay.bean.notify;
+
+import com.google.gson.annotations.SerializedName;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.io.Serializable;
+import java.util.List;
+
+/**
+ * 微信支付服务商下单回调
+ * 文档见：https://pay.weixin.qq.com/wiki/doc/apiv3_partner/apis/chapter4_1_5.shtml
+ *
+ * @author Guo Shuai
+ * @version 1.0
+ * @date 2023/3/2
+ */
+@Data
+@NoArgsConstructor
+public class WxPayPartnerNotifyV3Result implements Serializable, WxPayBaseNotifyV3Result<WxPayPartnerNotifyV3Result.DecryptNotifyResult> {
+  private static final long serialVersionUID = -1L;
+  /**
+   * 源数据
+   */
+  private OriginNotifyResponse rawData;
+  /**
+   * 解密后的数据
+   */
+  private DecryptNotifyResult result;
+
+  @Data
+  @NoArgsConstructor
+  public static class DecryptNotifyResult implements Serializable {
+    private static final long serialVersionUID = 1L;
+    /**
+     * <pre>
+     * 字段名：服务商应用ID
+     * 变量名：spAppid
+     * 是否必填：是
+     * 类型：string[1,32]
+     * 描述：
+     *  由微信生成的应用ID，全局唯一。请求统一下单接口时请注意APPID的应用属性，例如公众号场景下，需使用应用属性为公众号的APPID
+     *  示例值：wxd678efh567hg6787
+     * </pre>
+     */
+    @SerializedName(value = "sp_appid")
+    protected String spAppid;
+    /**
+     * <pre>
+     * 字段名：服务商商户号
+     * 变量名：spMchid
+     * 是否必填：是
+     * 类型：string[1,32]
+     * 描述：
+     *  服务商商户号，由微信支付生成并下发。
+     *  示例值：1230000109
+     * </pre>
+     */
+    @SerializedName(value = "sp_mchid")
+    protected String spMchid;
+    /**
+     * <pre>
+     * 字段名：子商户应用ID
+     * 变量名：subAppid
+     * 是否必填：否
+     * 类型：string[1,32]
+     * 描述：
+     *  由微信生成的应用ID，全局唯一。请求统一下单接口时请注意APPID的应用属性，例如公众号场景下，需使用应用属性为公众号的APPID
+     *  示例值：wxd678efh567hg6787
+     * </pre>
+     */
+    @SerializedName(value = "sub_appid")
+    protected String subAppid;
+    /**
+     * <pre>
+     * 字段名：子商户商户号
+     * 变量名：subMchid
+     * 是否必填：是
+     * 类型：string[1,32]
+     * 描述：
+     *  子商户商户号，由微信支付生成并下发。
+     *  示例值：1230000109
+     * </pre>
+     */
+    @SerializedName(value = "sub_mchid")
+    protected String subMchid;
+    /**
+     * <pre>
+     * 字段名：商户订单号
+     * 变量名：out_trade_no
+     * 是否必填：是
+     * 类型：string[6,32]
+     * 描述：
+     *  商户系统内部订单号，只能是数字、大小写字母_-*且在同一个商户号下唯一。
+     *  特殊规则：最小字符长度为6
+     *  示例值：1217752501201407033233368018
+     * </pre>
+     */
+    @SerializedName(value = "out_trade_no")
+    private String outTradeNo;
+    /**
+     * <pre>
+     * 字段名：微信支付订单号
+     * 变量名：transaction_id
+     * 是否必填：是
+     * 类型：string[1,32]
+     * 描述：
+     *  微信支付系统生成的订单号。
+     *  示例值：1217752501201407033233368018
+     * </pre>
+     */
+    @SerializedName(value = "transaction_id")
+    private String transactionId;
+    /**
+     * <pre>
+     * 字段名：交易类型
+     * 变量名：trade_type
+     * 是否必填：是
+     * 类型：string[1,16]
+     * 描述：
+     *  交易类型，枚举值：
+     *  JSAPI：公众号支付
+     *  NATIVE：扫码支付
+     *  APP：APP支付
+     *  MICROPAY：付款码支付
+     *  MWEB：H5支付
+     *  FACEPAY：刷脸支付
+     *  示例值：MICROPAY
+     * </pre>
+     */
+    @SerializedName(value = "trade_type")
+    private String tradeType;
+    /**
+     * <pre>
+     * 字段名：交易状态
+     * 变量名：trade_state
+     * 是否必填：是
+     * 类型：string[1,32]
+     * 描述：
+     *  交易状态，枚举值：
+     *  SUCCESS：支付成功
+     *  REFUND：转入退款
+     *  NOTPAY：未支付
+     *  CLOSED：已关闭
+     *  REVOKED：已撤销（付款码支付）
+     *  USERPAYING：用户支付中（付款码支付）
+     *  PAYERROR：支付失败(其他原因，如银行返回失败)
+     *  示例值：SUCCESS
+     * </pre>
+     */
+    @SerializedName(value = "trade_state")
+    private String tradeState;
+    /**
+     * <pre>
+     * 字段名：交易状态描述
+     * 变量名：trade_state_desc
+     * 是否必填：是
+     * 类型：string[1,256]
+     * 描述：
+     *  交易状态描述
+     *  示例值：支付成功
+     * </pre>
+     */
+    @SerializedName(value = "trade_state_desc")
+    private String tradeStateDesc;
+    /**
+     * <pre>
+     * 字段名：付款银行
+     * 变量名：bank_type
+     * 是否必填：是
+     * 类型：string[1,16]
+     * 描述：
+     *  银行类型，采用字符串类型的银行标识。银行标识请参考《银行类型对照表》https://pay.weixin.qq.com/wiki/doc/apiv3/terms_definition/chapter1_1_3.shtml#part-6
+     *  示例值：CMC
+     * </pre>
+     */
+    @SerializedName(value = "bank_type")
+    private String bankType;
+    /**
+     * <pre>
+     * 字段名：附加数据
+     * 变量名：attach
+     * 是否必填：否
+     * 类型：string[1,128]
+     * 描述：
+     *  附加数据，在查询API和支付通知中原样返回，可作为自定义参数使用
+     *  示例值：自定义数据
+     * </pre>
+     */
+    @SerializedName(value = "attach")
+    private String attach;
+    /**
+     * <pre>
+     * 字段名：支付完成时间
+     * 变量名：success_time
+     * 是否必填：是
+     * 类型：string[1,64]
+     * 描述：
+     *  支付完成时间，遵循rfc3339标准格式，格式为YYYY-MM-DDTHH:mm:ss+TIMEZONE，YYYY-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35+08:00表示，北京时间2015年5月20日 13点29分35秒。
+     *  示例值：2018-06-08T10:34:56+08:00
+     * </pre>
+     */
+    @SerializedName(value = "success_time")
+    private String successTime;
+    /**
+     * <pre>
+     * 字段名：支付者
+     * 变量名：payer
+     * 是否必填：是
+     * 类型：object
+     * 描述：
+     *  支付者信息
+     * </pre>
+     */
+    private Payer payer;
+    /**
+     * <pre>
+     * 字段名：订单金额
+     * 变量名：amount
+     * 是否必填：否
+     * 类型：object
+     * 描述：
+     *  订单金额信息
+     * </pre>
+     */
+    @SerializedName(value = "amount")
+    private Amount amount;
+    /**
+     * <pre>
+     * 字段名：场景信息
+     * 变量名：scene_info
+     * 是否必填：否
+     * 类型：object
+     * 描述：
+     *  支付场景信息描述
+     * </pre>
+     */
+    @SerializedName(value = "scene_info")
+    private SceneInfo sceneInfo;
+    /**
+     * <pre>
+     * 字段名：优惠功能
+     * 变量名：promotion_detail
+     * 是否必填：否
+     * 类型：array
+     * 描述：
+     *  优惠功能，享受优惠时返回该字段。
+     * </pre>
+     */
+    @SerializedName(value = "promotion_detail")
+    private List<PromotionDetail> promotionDetails;
+  }
+  @Data
+  @NoArgsConstructor
+  public static class Payer implements Serializable {
+    private static final long serialVersionUID = 1L;
+    /**
+     * <pre>
+     * 字段名：用户标识
+     * 变量名：openid
+     * 是否必填：是
+     * 类型：string[1,128]
+     * 描述：
+     *  用户在直连商户appid下的唯一标识。
+     *  示例值：oUpF8uMuAJO_M2pxb1Q9zNjWeS6o
+     * </pre>
+     */
+    @SerializedName(value = "openid")
+    private String openid;
+  }
+
+  @Data
+  @NoArgsConstructor
+  public static class Amount implements Serializable {
+    private static final long serialVersionUID = 1L;
+    /**
+     * <pre>
+     * 字段名：总金额
+     * 变量名：total
+     * 是否必填：否
+     * 类型：int
+     * 描述：
+     *  订单总金额，单位为分。
+     *  示例值：100
+     * </pre>
+     */
+    @SerializedName(value = "total")
+    private Integer total;
+    /**
+     * <pre>
+     * 字段名：用户支付金额
+     * 变量名：payer_total
+     * 是否必填：否
+     * 类型：int
+     * 描述：
+     *  用户支付金额，单位为分。
+     *  示例值：100
+     * </pre>
+     */
+    @SerializedName(value = "payer_total")
+    private Integer payerTotal;
+    /**
+     * <pre>
+     * 字段名：货币类型
+     * 变量名：currency
+     * 是否必填：否
+     * 类型：string[1,16]
+     * 描述：
+     *  CNY：人民币，境内商户号仅支持人民币。
+     *  示例值：CNY
+     * </pre>
+     */
+    @SerializedName(value = "currency")
+    private String currency;
+    /**
+     * <pre>
+     * 字段名：用户支付币种
+     * 变量名：payer_currency
+     * 是否必填：否
+     * 类型：string[1,16]
+     * 描述：
+     *  用户支付币种
+     *  示例值： CNY
+     * </pre>
+     */
+    @SerializedName(value = "payer_currency")
+    private String payerCurrency;
+  }
+
+  @Data
+  @NoArgsConstructor
+  public static class SceneInfo implements Serializable {
+    private static final long serialVersionUID = 1L;
+    /**
+     * <pre>
+     * 字段名：商户端设备号
+     * 变量名：device_id
+     * 是否必填：否
+     * 类型：string[1,32]
+     * 描述：
+     *  终端设备号（门店号或收银设备ID）。
+     *  示例值：013467007045764
+     * </pre>
+     */
+    @SerializedName(value = "device_id")
+    private String deviceId;
+  }
+
+  @Data
+  @NoArgsConstructor
+  public static class PromotionDetail implements Serializable {
+    /**
+     * <pre>
+     * 字段名：券ID
+     * 变量名：coupon_id
+     * 是否必填：是
+     * 类型：string[1,32]
+     * 描述：
+     *  券ID
+     *  示例值：109519
+     * </pre>
+     */
+    @SerializedName(value = "coupon_id")
+    private String couponId;
+    /**
+     * <pre>
+     * 字段名：优惠名称
+     * 变量名：name
+     * 是否必填：否
+     * 类型：string[1,64]
+     * 描述：
+     *  优惠名称
+     *  示例值：单品惠-6
+     * </pre>
+     */
+    @SerializedName(value = "name")
+    private String name;
+    /**
+     * <pre>
+     * 字段名：优惠范围
+     * 变量名：scope
+     * 是否必填：否
+     * 类型：string[1,32]
+     * 描述：
+     *  GLOBAL：全场代金券
+     *  SINGLE：单品优惠
+     *  示例值：GLOBAL
+     * </pre>
+     */
+    @SerializedName(value = "scope")
+    private String scope;
+    /**
+     * <pre>
+     * 字段名：优惠类型
+     * 变量名：type
+     * 是否必填：否
+     * 类型：string[1,32]
+     * 描述：
+     *  CASH：充值
+     *  NOCASH：预充值
+     *  示例值：CASH
+     * </pre>
+     */
+    @SerializedName(value = "type")
+    private String type;
+    /**
+     * <pre>
+     * 字段名：优惠券面额
+     * 变量名：amount
+     * 是否必填：是
+     * 类型：int
+     * 描述：
+     *  优惠券面额
+     *  示例值：100
+     * </pre>
+     */
+    @SerializedName(value = "amount")
+    private Integer amount;
+    /**
+     * <pre>
+     * 字段名：活动ID
+     * 变量名：stock_id
+     * 是否必填：否
+     * 类型：string[1,32]
+     * 描述：
+     *  活动ID
+     *  示例值：931386
+     * </pre>
+     */
+    @SerializedName(value = "stock_id")
+    private String stockId;
+    /**
+     * <pre>
+     * 字段名：微信出资
+     * 变量名：wechatpay_contribute
+     * 是否必填：否
+     * 类型：int
+     * 描述：
+     *  微信出资，单位为分
+     *  示例值：0
+     * </pre>
+     */
+    @SerializedName(value = "wechatpay_contribute")
+    private Integer wechatpayContribute;
+    /**
+     * <pre>
+     * 字段名：商户出资
+     * 变量名：merchant_contribute
+     * 是否必填：否
+     * 类型：int
+     * 描述：
+     *  商户出资，单位为分
+     *  示例值：0
+     * </pre>
+     */
+    @SerializedName(value = "merchant_contribute")
+    private Integer merchantContribute;
+    /**
+     * <pre>
+     * 字段名：其他出资
+     * 变量名：other_contribute
+     * 是否必填：否
+     * 类型：int
+     * 描述：
+     *  其他出资，单位为分
+     *  示例值：0
+     * </pre>
+     */
+    @SerializedName(value = "other_contribute")
+    private Integer otherContribute;
+    /**
+     * <pre>
+     * 字段名：优惠币种
+     * 变量名：currency
+     * 是否必填：否
+     * 类型：string[1,16]
+     * 描述：
+     *  CNY：人民币，境内商户号仅支持人民币。
+     *  示例值：CNY
+     * </pre>
+     */
+    @SerializedName(value = "currency")
+    private String currency;
+    /**
+     * <pre>
+     * 字段名：单品列表
+     * 变量名：goods_detail
+     * 是否必填：否
+     * 类型：array
+     * 描述：
+     *  单品列表信息
+     * </pre>
+     */
+    @SerializedName(value = "goods_detail")
+    private List<GoodsDetail> goodsDetails;
+  }
+
+  @Data
+  @NoArgsConstructor
+  public static class GoodsDetail implements Serializable {
+    private static final long serialVersionUID = 1L;
+    /**
+     * <pre>
+     * 字段名：商品编码
+     * 变量名：goods_id
+     * 是否必填：是
+     * 类型：string[1,32]
+     * 描述：
+     *  商品编码
+     *  示例值：M1006
+     * </pre>
+     */
+    @SerializedName(value = "goods_id")
+    private String goodsId;
+    /**
+     * <pre>
+     * 字段名：商品数量
+     * 变量名：quantity
+     * 是否必填：是
+     * 类型：int
+     * 描述：
+     *  用户购买的数量
+     *  示例值：1
+     * </pre>
+     */
+    @SerializedName(value = "quantity")
+    private Integer quantity;
+    /**
+     * <pre>
+     * 字段名：商品单价
+     * 变量名：unit_price
+     * 是否必填：是
+     * 类型：int
+     * 描述：
+     *  商品单价，单位为分
+     *  示例值：100
+     * </pre>
+     */
+    @SerializedName(value = "unit_price")
+    private Integer unitPrice;
+    /**
+     * <pre>
+     * 字段名：商品优惠金额
+     * 变量名：discount_amount
+     * 是否必填：是
+     * 类型：int
+     * 描述：
+     *  商品优惠金额
+     *  示例值：0
+     * </pre>
+     */
+    @SerializedName(value = "discount_amount")
+    private Integer discountAmount;
+    /**
+     * <pre>
+     * 字段名：商品备注
+     * 变量名：goods_remark
+     * 是否必填：否
+     * 类型：string[1,128]
+     * 描述：
+     *  商品备注信息
+     *  示例值：商品备注信息
+     * </pre>
+     */
+    @SerializedName(value = "goods_remark")
+    private String goodsRemark;
+  }
+}
diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/WxPayPartnerRefundNotifyV3Result.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/WxPayPartnerRefundNotifyV3Result.java
new file mode 100644
index 0000000000..f3dcf168b1
--- /dev/null
+++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/WxPayPartnerRefundNotifyV3Result.java
@@ -0,0 +1,230 @@
+package com.github.binarywang.wxpay.bean.notify;
+
+import com.google.gson.annotations.SerializedName;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.io.Serializable;
+
+/**
+ * 微信支付服务商退款回调
+ * 文档见：https://pay.weixin.qq.com/wiki/doc/apiv3_partner/apis/chapter4_1_11.shtml
+ *
+ * @author Guo Shuai
+ * @version 1.0
+ * @date 2023/3/2
+ */
+@Data
+@NoArgsConstructor
+public class WxPayPartnerRefundNotifyV3Result implements Serializable, WxPayBaseNotifyV3Result<WxPayPartnerRefundNotifyV3Result.DecryptNotifyResult> {
+  private static final long serialVersionUID = -1L;
+  /**
+   * 源数据
+   */
+  private OriginNotifyResponse rawData;
+  /**
+   * 解密后的数据
+   */
+  private DecryptNotifyResult result;
+
+  @Data
+  @NoArgsConstructor
+  public static class DecryptNotifyResult implements Serializable {
+    private static final long serialVersionUID = -1L;
+    /**
+     * <pre>
+     * 字段名：服务商的商户号
+     * 变量名：sub_mchid
+     * 是否必填：是
+     * 类型：string[1, 32]
+     * 描述：
+     *  服务商的商户号，由微信支付生成并下发。
+     *  示例值：1230000109
+     * </pre>
+     */
+    @SerializedName(value = "sp_mchid")
+    private String spMchId;
+    /**
+     * <pre>
+     * 字段名：子商户的商户号
+     * 变量名：sub_mchid
+     * 是否必填：是
+     * 类型：string[1, 32]
+     * 描述：
+     *  子商户商户号，由微信支付生成并下发。
+     *  示例值：1230000109
+     * </pre>
+     */
+    @SerializedName(value = "sub_mchid")
+    private String subMchId;
+    /**
+     * <pre>
+     * 字段名：商户订单号
+     * 变量名：out_trade_no
+     * 是否必填：是
+     * 类型：string[1,32]
+     * 描述：
+     *  返回的商户订单号
+     *  示例值： 1217752501201407033233368018
+     * </pre>
+     */
+    @SerializedName(value = "out_trade_no")
+    private String outTradeNo;
+    /**
+     * <pre>
+     * 字段名：微信支付订单号
+     * 变量名：transaction_id
+     * 是否必填：是
+     * 类型：string[1,32]
+     * 描述：
+     *  微信支付订单号
+     *  示例值： 1217752501201407033233368018
+     * </pre>
+     */
+    @SerializedName(value = "transaction_id")
+    private String transactionId;
+    /**
+     * <pre>
+     * 字段名：商户退款单号
+     * 变量名：out_refund_no
+     * 是否必填：是
+     * 类型：string[1,64]
+     * 描述：
+     *  商户退款单号
+     *  示例值： 1217752501201407033233368018
+     * </pre>
+     */
+    @SerializedName(value = "out_refund_no")
+    private String outRefundNo;
+    /**
+     * <pre>
+     * 字段名：微信支付退款号
+     * 变量名：refund_id
+     * 是否必填：是
+     * 类型：string[1,32]
+     * 描述：
+     *  微信退款单号
+     *  示例值： 1217752501201407033233368018
+     * </pre>
+     */
+    @SerializedName(value = "refund_id")
+    private String refundId;
+    /**
+     * <pre>
+     * 字段名：退款状态
+     * 变量名：refund_status
+     * 是否必填：是
+     * 类型：string[1,16]
+     * 描述：
+     *  退款状态，枚举值：
+     *  SUCCESS：退款成功
+     *  CLOSE：退款关闭
+     *  ABNORMAL：退款异常，退款到银行发现用户的卡作废或者冻结了，导致原路退款银行卡失败，可前往【商户平台—>交易中心】，手动处理此笔退款
+     *  示例值：SUCCESS
+     * </pre>
+     */
+    @SerializedName(value = "refund_status")
+    private String refundStatus;
+    /**
+     * <pre>
+     * 字段名：退款成功时间
+     * 变量名：success_time
+     * 是否必填：否
+     * 类型：string[1,64]
+     * 描述：
+     *  1、退款成功时间，遵循rfc3339标准格式，格式为YYYY-MM-DDTHH:mm:ss+TIMEZONE，YYYY-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35+08:00表示，北京时间2015年5月20日13点29分35秒。
+     *  2、当退款状态为退款成功时返回此参数。
+     *  示例值：2018-06-08T10:34:56+08:00
+     * </pre>
+     */
+    @SerializedName(value = "success_time")
+    private String successTime;
+    /**
+     * <pre>
+     * 字段名：退款入账账户
+     * 变量名：user_received_account
+     * 是否必填：是
+     * 类型：string[1,64]
+     * 描述：
+     *  取当前退款单的退款入账方。
+     *  1、退回银行卡：{银行名称}{卡类型}{卡尾号}
+     *  2、退回支付用户零钱: 支付用户零钱
+     *  3、退还商户: 商户基本账户、商户结算银行账户
+     *  4、退回支付用户零钱通：支付用户零钱通
+     *  示例值：招商银行信用卡0403
+     * </pre>
+     */
+    @SerializedName(value = "user_received_account")
+    private String userReceivedAccount;
+    /**
+     * <pre>
+     * 字段名：金额信息
+     * 变量名：amount
+     * 是否必填：是
+     * 类型：object
+     * 描述：
+     *  金额信息
+     * </pre>
+     */
+    @SerializedName(value = "amount")
+    private Amount amount;
+  }
+
+  @Data
+  @NoArgsConstructor
+  public static class Amount implements Serializable {
+    private static final long serialVersionUID = 1L;
+    /**
+     * <pre>
+     * 字段名：订单金额
+     * 变量名：total
+     * 是否必填：是
+     * 类型：int
+     * 描述：
+     *  订单总金额，单位为分，只能为整数，详见支付金额
+     *  示例值：999
+     * </pre>
+     */
+    @SerializedName(value = "total")
+    private Integer total;
+    /**
+     * <pre>
+     * 字段名：退款金额
+     * 变量名：refund
+     * 是否必填：是
+     * 类型：int
+     * 描述：
+     *  退款金额，币种的最小单位，只能为整数，不能超过原订单支付金额，如果有使用券，后台会按比例退。
+     *  示例值：999
+     * </pre>
+     */
+    @SerializedName(value = "refund")
+    private Integer refund;
+    /**
+     * <pre>
+     * 字段名：用户支付金额
+     * 变量名：payer_total
+     * 是否必填：是
+     * 类型：int
+     * 描述：
+     *  用户实际支付金额，单位为分，只能为整数，详见支付金额
+     *  示例值：999
+     * </pre>
+     */
+    @SerializedName(value = "payer_total")
+    private Integer payerTotal;
+    /**
+     * <pre>
+     * 字段名：用户退款金额
+     * 变量名：payer_refund
+     * 是否必填：是
+     * 类型：int
+     * 描述：
+     *  退款给用户的金额，不包含所有优惠券金额
+     *  示例值：999
+     * </pre>
+     */
+    @SerializedName(value = "payer_refund")
+    private Integer payerRefund;
+  }
+}
diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/WxPayRefundNotifyV3Result.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/WxPayRefundNotifyV3Result.java
index 976e7e2691..c3473ee465 100644
--- a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/WxPayRefundNotifyV3Result.java
+++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/WxPayRefundNotifyV3Result.java
@@ -14,7 +14,7 @@
  */
 @Data
 @NoArgsConstructor
-public class WxPayRefundNotifyV3Result implements Serializable {
+public class WxPayRefundNotifyV3Result implements Serializable, WxPayBaseNotifyV3Result<WxPayRefundNotifyV3Result.DecryptNotifyResult> {
   private static final long serialVersionUID = -1L;
   /**
    * 源数据
diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/request/WxPayPartnerRefundV3Request.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/request/WxPayPartnerRefundV3Request.java
new file mode 100644
index 0000000000..89d0e11f58
--- /dev/null
+++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/request/WxPayPartnerRefundV3Request.java
@@ -0,0 +1,55 @@
+package com.github.binarywang.wxpay.bean.request;
+
+import com.google.gson.annotations.SerializedName;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import lombok.experimental.Accessors;
+
+import java.io.Serializable;
+import java.util.List;
+
+/**
+ * 微信支付服务商退款请求
+ * 文档见：https://pay.weixin.qq.com/wiki/doc/apiv3_partner/apis/chapter4_1_9.shtml
+ *
+ * @author Guo Shuai
+ * @version 1.0
+ * @date 2023/3/2
+ */
+@Data
+@NoArgsConstructor
+@Accessors(chain = true)
+public class WxPayPartnerRefundV3Request extends WxPayRefundV3Request implements Serializable {
+  private static final long serialVersionUID = -1L;
+  /**
+   * <pre>
+   * 字段名：子商户的商户号
+   * 变量名：sub_mchid
+   * 是否必填：是
+   * 类型：string[1, 32]
+   * 描述：
+   *  子商户商户号，由微信支付生成并下发。
+   *  示例值：1230000109
+   * </pre>
+   */
+  @SerializedName(value = "sub_mchid")
+  private String subMchId;
+  /**
+   * <pre>
+   * 字段名：退款资金来源
+   * 变量名：funds_account
+   * 是否必填：否
+   * 类型：string[1, 32]
+   * 描述：
+   *  若传递此参数则使用对应的资金账户退款，否则默认使用未结算资金退款（仅对老资金流商户适用）
+   *  示例值：
+   *    UNSETTLED : 未结算资金
+   *    AVAILABLE : 可用余额
+   *    UNAVAILABLE : 不可用余额
+   *    OPERATION : 运营户
+   *    BASIC : 基本账户（含可用余额和不可用余额）
+   * </pre>
+   */
+  @SerializedName(value = "funds_account")
+  private String fundsAccount;
+}
diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/request/WxPayPartnerUnifiedOrderV3Request.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/request/WxPayPartnerUnifiedOrderV3Request.java
new file mode 100644
index 0000000000..4e60f0693d
--- /dev/null
+++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/request/WxPayPartnerUnifiedOrderV3Request.java
@@ -0,0 +1,610 @@
+package com.github.binarywang.wxpay.bean.request;
+
+import com.google.gson.annotations.SerializedName;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import lombok.experimental.Accessors;
+
+import java.io.Serializable;
+import java.util.List;
+
+/**
+ * 微信支付服务商下单请求对象
+ *
+ * @author Guo Shuai
+ * @version 1.0
+ * @date 2023/3/2
+ */
+@Data
+@NoArgsConstructor
+@Accessors(chain = true)
+public class WxPayPartnerUnifiedOrderV3Request implements Serializable {
+  private static final long serialVersionUID = 1L;
+  /**
+   * <pre>
+   * 字段名：服务商应用ID
+   * 变量名：spAppid
+   * 是否必填：是
+   * 类型：string[1,32]
+   * 描述：
+   *  由微信生成的应用ID，全局唯一。请求统一下单接口时请注意APPID的应用属性，例如公众号场景下，需使用应用属性为公众号的APPID
+   *  示例值：wxd678efh567hg6787
+   * </pre>
+   */
+  @SerializedName(value = "sp_appid")
+  protected String spAppid;
+  /**
+   * <pre>
+   * 字段名：服务商商户号
+   * 变量名：spMchid
+   * 是否必填：是
+   * 类型：string[1,32]
+   * 描述：
+   *  服务商商户号，由微信支付生成并下发。
+   *  示例值：1230000109
+   * </pre>
+   */
+  @SerializedName(value = "sp_mchid")
+  protected String spMchId;
+  /**
+   * <pre>
+   * 字段名：子商户应用ID
+   * 变量名：subAppid
+   * 是否必填：否
+   * 类型：string[1,32]
+   * 描述：
+   *  由微信生成的应用ID，全局唯一。请求统一下单接口时请注意APPID的应用属性，例如公众号场景下，需使用应用属性为公众号的APPID
+   *  示例值：wxd678efh567hg6787
+   * </pre>
+   */
+  @SerializedName(value = "sub_appid")
+  protected String subAppid;
+  /**
+   * <pre>
+   * 字段名：子商户商户号
+   * 变量名：subMchid
+   * 是否必填：是
+   * 类型：string[1,32]
+   * 描述：
+   *  子商户商户号，由微信支付生成并下发。
+   *  示例值：1230000109
+   * </pre>
+   */
+  @SerializedName(value = "sub_mchid")
+  protected String subMchId;
+  /**
+   * <pre>
+   * 字段名：商品描述
+   * 变量名：description
+   * 是否必填：是
+   * 类型：string[1,127]
+   * 描述：
+   *  商品描述
+   *  示例值：Image形象店-深圳腾大-QQ公仔
+   * </pre>
+   */
+  @SerializedName(value = "description")
+  protected String description;
+  /**
+   * <pre>
+   * 字段名：商户订单号
+   * 变量名：out_trade_no
+   * 是否必填：是
+   * 类型：string[6,32]
+   * 描述：
+   *  商户系统内部订单号，只能是数字、大小写字母_-*且在同一个商户号下唯一
+   *  示例值：1217752501201407033233368018
+   * </pre>
+   */
+  @SerializedName(value = "out_trade_no")
+  protected String outTradeNo;
+  /**
+   * <pre>
+   * 字段名：交易结束时间
+   * 变量名：time_expire
+   * 是否必填：是
+   * 类型：string[1,64]
+   * 描述：
+   *  订单失效时间，遵循rfc3339标准格式，格式为YYYY-MM-DDTHH:mm:ss+TIMEZONE，YYYY-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35+08:00表示，北京时间2015年5月20日 13点29分35秒。
+   *  示例值：2018-06-08T10:34:56+08:00
+   * </pre>
+   */
+  @SerializedName(value = "time_expire")
+  protected String timeExpire;
+  /**
+   * <pre>
+   * 字段名：附加数据
+   * 变量名：attach
+   * 是否必填：否
+   * 类型：string[1,128]
+   * 描述：
+   *  附加数据，在查询API和支付通知中原样返回，可作为自定义参数使用
+   *  示例值：自定义数据
+   * </pre>
+   */
+  @SerializedName(value = "attach")
+  protected String attach;
+  /**
+   * <pre>
+   * 字段名：通知地址
+   * 变量名：notify_url
+   * 是否必填：是
+   * 类型：string[1,256]
+   * 描述：
+   *  通知URL必须为直接可访问的URL，不允许携带查询串，要求必须为https地址。
+   *  格式：URL
+   *  示例值：https://www.weixin.qq.com/wxpay/pay.php
+   * </pre>
+   */
+  @SerializedName(value = "notify_url")
+  private String notifyUrl;
+  /**
+   * <pre>
+   * 字段名：订单优惠标记
+   * 变量名：goods_tag
+   * 是否必填：否
+   * 类型：string[1,256]
+   * 描述：
+   *  订单优惠标记
+   *  示例值：WXG
+   * </pre>
+   */
+  @SerializedName(value = "goods_tag")
+  private String goodsTag;
+  /**
+   * <pre>
+   * 字段名：电子发票入口开放标识
+   * 变量名：support_fapiao
+   * 是否必填：否
+   * 类型：boolean
+   * 描述：传入true时，支付成功消息和支付详情页将出现开票入口。需要在微信支付商户平台或微信公众平台开通电子发票功能，传此字段才可生效。
+   * </pre>
+   */
+  @SerializedName(value = "support_fapiao")
+  private Boolean supportFapiao;
+  /**
+   * <pre>
+   * 字段名：订单金额
+   * 变量名：amount
+   * 是否必填：是
+   * 类型：object
+   * 描述：
+   *  订单金额信息
+   * </pre>
+   */
+  @SerializedName(value = "amount")
+  private Amount amount;
+  /**
+   * <pre>
+   * 字段名：支付者
+   * 变量名：payer
+   * 是否必填：是
+   * 类型：object
+   * 描述：
+   *  支付者信息
+   * </pre>
+   */
+  @SerializedName(value = "payer")
+  private Payer payer;
+  /**
+   * <pre>
+   * 字段名：优惠功能
+   * 变量名：detail
+   * 是否必填：否
+   * 类型：object
+   * 描述：
+   *  优惠功能
+   * </pre>
+   */
+  @SerializedName(value = "detail")
+  private Discount detail;
+  /**
+   * <pre>
+   * 字段名：场景信息
+   * 变量名：scene_info
+   * 是否必填：否
+   * 类型：object
+   * 描述：
+   *  支付场景描述
+   * </pre>
+   */
+  @SerializedName(value = "scene_info")
+  private SceneInfo sceneInfo;
+  /**
+   * <pre>
+   * 字段名：结算信息
+   * 变量名：settle_info
+   * 是否必填：否
+   * 类型：Object
+   * 描述：结算信息
+   * </pre>
+   */
+  @SerializedName(value = "settle_info")
+  private SettleInfo settleInfo;
+
+  @Data
+  @NoArgsConstructor
+  public static class Amount implements Serializable {
+    private static final long serialVersionUID = 1L;
+    /**
+     * <pre>
+     * 字段名：总金额
+     * 变量名：total
+     * 是否必填：是
+     * 类型：int
+     * 描述：
+     *  订单总金额，单位为分。
+     *  示例值：100
+     * </pre>
+     */
+    @SerializedName(value = "total")
+    private Integer total;
+    /**
+     * <pre>
+     * 字段名：币类型
+     * 变量名：currency
+     * 是否必填：否
+     * 类型：string[1,16]
+     * 描述：
+     *  CNY：人民币，境内商户号仅支持人民币。
+     *  示例值：CNY
+     * </pre>
+     */
+    @SerializedName(value = "currency")
+    private String currency;
+  }
+
+  @Data
+  @NoArgsConstructor
+  public static class Payer implements Serializable {
+    private static final long serialVersionUID = -1L;
+    /**
+     * <pre>
+     * spOpenid 和 subOpenid二选一 参考官网
+     * 字段名：服务商用户标识
+     * 变量名：spOpenid
+     * 是否必填：是
+     * 类型：string[1,128]
+     * 描述：
+     *  用户在服务商appid下的唯一标识。
+     *  示例值：oUpF8uMuAJO_M2pxb1Q9zNjWeS6o
+     * </pre>
+     */
+    @SerializedName(value = "sp_openid")
+    private String spOpenid;
+    /**
+     * <pre>
+     * 字段名：子商户应用用户标识
+     * 变量名：subOpenid
+     * 是否必填：是
+     * 类型：string[1,128]
+     * 描述：
+     *  用户在子商户appid下的唯一标识。
+     *  示例值：oUpF8uMuAJO_M2pxb1Q9zNjWeS6o
+     * </pre>
+     */
+    @SerializedName(value = "sub_openid")
+    private String subOpenid;
+  }
+
+  @Data
+  @NoArgsConstructor
+  public static class Discount implements Serializable {
+    private static final long serialVersionUID = 1L;
+    /**
+     * <pre>
+     * 字段名：订单原价
+     * 变量名：cost_price
+     * 是否必填：否
+     * 类型：int
+     * 描述：
+     *  1、商户侧一张小票订单可能被分多次支付，订单原价用于记录整张小票的交易金额。
+     *  2、当订单原价与支付金额不相等，则不享受优惠。
+     *  3、该字段主要用于防止同一张小票分多次支付，以享受多次优惠的情况，正常支付订单不必上传此参数。
+     *  示例值：608800
+     * </pre>
+     */
+    @SerializedName(value = "cost_price")
+    private Integer costPrice;
+    /**
+     * <pre>
+     * 字段名：商品小票ID
+     * 变量名：invoice_id
+     * 是否必填：否
+     * 类型：string[1,32]
+     * 描述：
+     *  商品小票ID
+     *  示例值：微信123
+     * </pre>
+     */
+    @SerializedName(value = "invoice_id")
+    private String invoiceId;
+    /**
+     * <pre>
+     * 字段名：单品列表
+     * 变量名：goods_detail
+     * 是否必填：否
+     * 类型：array
+     * 描述：
+     *  单品列表信息
+     *  条目个数限制：【1，6000】
+     * </pre>
+     */
+    @SerializedName(value = "goods_detail")
+    private List<GoodsDetail> goodsDetails;
+  }
+
+  @Data
+  @NoArgsConstructor
+  public static class GoodsDetail implements Serializable {
+    private static final long serialVersionUID = -1L;
+    /**
+     * <pre>
+     * 字段名：商户侧商品编码
+     * 变量名：merchant_goods_id
+     * 是否必填：是
+     * 类型：string[1,32]
+     * 描述：
+     *  由半角的大小写字母、数字、中划线、下划线中的一种或几种组成。
+     *  示例值：商品编码
+     * </pre>
+     */
+    @SerializedName(value = "merchant_goods_id")
+    private String merchantGoodsId;
+    /**
+     * <pre>
+     * 字段名：微信侧商品编码
+     * 变量名：wechatpay_goods_id
+     * 是否必填：否
+     * 类型：string[1,32]
+     * 描述：
+     *  微信支付定义的统一商品编号（没有可不传）
+     *  示例值：1001
+     * </pre>
+     */
+    @SerializedName(value = "wechatpay_goods_id")
+    private String wechatpayGoodsId;
+    /**
+     * <pre>
+     * 字段名：商品名称
+     * 变量名：goods_name
+     * 是否必填：否
+     * 类型：string[1,256]
+     * 描述：
+     *  商品的实际名称
+     *  示例值：iPhoneX 256G
+     * </pre>
+     */
+    @SerializedName(value = "goods_name")
+    private String goodsName;
+    /**
+     * <pre>
+     * 字段名：商品数量
+     * 变量名：quantity
+     * 是否必填：是
+     * 类型：int
+     * 描述：
+     *  用户购买的数量
+     *  示例值：1
+     * </pre>
+     */
+    @SerializedName(value = "quantity")
+    private Integer quantity;
+    /**
+     * <pre>
+     * 字段名：商品单价
+     * 变量名：unit_price
+     * 是否必填：是
+     * 类型：int
+     * 描述：
+     *  商品单价，单位为分
+     *  示例值：828800
+     * </pre>
+     */
+    @SerializedName(value = "unit_price")
+    private Integer unitPrice;
+  }
+
+  @Data
+  @NoArgsConstructor
+  public static class SceneInfo implements Serializable {
+    private static final long serialVersionUID = 1L;
+    /**
+     * <pre>
+     * 字段名：用户终端IP
+     * 变量名：payer_client_ip
+     * 是否必填：是
+     * 类型：string[1,45]
+     * 描述：
+     *  用户的客户端IP，支持IPv4和IPv6两种格式的IP地址。
+     *  示例值：14.23.150.211
+     * </pre>
+     */
+    @SerializedName(value = "payer_client_ip")
+    private String payerClientIp;
+    /**
+     * <pre>
+     * 字段名：商户端设备号
+     * 变量名：device_id
+     * 是否必填：否
+     * 类型：string[1,32]
+     * 描述：
+     *  商户端设备号（门店号或收银设备ID）。
+     *  示例值：013467007045764
+     * </pre>
+     */
+    @SerializedName(value = "device_id")
+    private String deviceId;
+    /**
+     * <pre>
+     * 字段名：商户门店信息
+     * 变量名：store_info
+     * 是否必填：否
+     * 类型：object
+     * 描述：
+     *  商户门店信息
+     * </pre>
+     */
+    @SerializedName(value = "store_info")
+    private StoreInfo storeInfo;
+    /**
+     * <pre>
+     * 字段名：H5场景信息
+     * 变量名：h5_info
+     * 是否必填：否(H5支付必填)
+     * 类型：object
+     * 描述：
+     *  H5场景信息
+     * </pre>
+     */
+    @SerializedName(value = "h5_info")
+    private H5Info h5Info;
+  }
+
+  @Data
+  @NoArgsConstructor
+  public static class StoreInfo implements Serializable {
+    private static final long serialVersionUID = -1L;
+    /**
+     * <pre>
+     * 字段名：门店编号
+     * 变量名：id
+     * 是否必填：是
+     * 类型：string[1,32]
+     * 描述：
+     *  商户侧门店编号
+     *  示例值：0001
+     * </pre>
+     */
+    @SerializedName(value = "id")
+    private String id;
+    /**
+     * <pre>
+     * 字段名：门店名称
+     * 变量名：name
+     * 是否必填：否
+     * 类型：string[1,256]
+     * 描述：
+     *  商户侧门店名称
+     *  示例值：腾讯大厦分店
+     * </pre>
+     */
+    @SerializedName(value = "name")
+    private String name;
+    /**
+     * <pre>
+     * 字段名：地区编码
+     * 变量名：area_code
+     * 是否必填：否
+     * 类型：string[1,32]
+     * 描述： 地区编码, <a href="https://pay.weixin.qq.com/wiki/doc/apiv3/wxpay/ecommerce/applyments/chapter4_1.shtml">详细请见省市区编号对照表</a>。
+     * 示例值：440305
+     * </pre>
+     */
+    @SerializedName(value = "area_code")
+    private String areaCode;
+    /**
+     * <pre>
+     * 字段名：详细地址
+     * 变量名：address
+     * 是否必填：是
+     * 类型：string[1,512]
+     * 描述：
+     *  详细的商户门店地址
+     *  示例值：广东省深圳市南山区科技中一道10000号
+     * </pre>
+     */
+    @SerializedName(value = "address")
+    private String address;
+  }
+
+  @Data
+  @NoArgsConstructor
+  public static class H5Info implements Serializable {
+    private static final long serialVersionUID = -1L;
+    /**
+     * <pre>
+     * 字段名：场景类型
+     * 变量名：type
+     * 是否必填：是
+     * 类型：string[1,32]
+     * 描述：
+     *  场景类型
+     *  示例值：iOS, Android, Wap
+     * </pre>
+     */
+    @SerializedName(value = "type")
+    private String type;
+    /**
+     * <pre>
+     * 字段名：应用名称
+     * 变量名：app_name
+     * 是否必填：否
+     * 类型：string[1,64]
+     * 描述：
+     *  应用名称
+     *  示例值：王者荣耀
+     * </pre>
+     */
+    @SerializedName(value = "app_name")
+    private String appName;
+    /**
+     * <pre>
+     * 字段名：网站URL
+     * 变量名：app_url
+     * 是否必填：否
+     * 类型：string[1,128]
+     * 描述：
+     *  网站URL
+     *  示例值：https://pay.qq.com
+     * </pre>
+     */
+    @SerializedName(value = "app_url")
+    private String appUrl;
+    /**
+     * <pre>
+     * 字段名：iOS平台BundleID
+     * 变量名：bundle_id
+     * 是否必填：否
+     * 类型：string[1,128]
+     * 描述：
+     *  iOS平台BundleID
+     *  示例值：com.tencent.wzryiOS
+     * </pre>
+     */
+    @SerializedName(value = "bundle_id")
+    private String bundleId;
+    /**
+     * <pre>
+     * 字段名：Android平台PackageName
+     * 变量名：package_name
+     * 是否必填：否
+     * 类型：string[1,128]
+     * 描述：
+     *  Android平台PackageName
+     *  示例值：com.tencent.tmgp.sgame
+     * </pre>
+     */
+    @SerializedName(value = "package_name")
+    private String packageName;
+  }
+
+  @Data
+  @NoArgsConstructor
+  public static class SettleInfo implements Serializable {
+    private static final long serialVersionUID = 1L;
+    /**
+     * <pre>
+     * 字段名：是否指定分账
+     * 变量名：profit_sharing
+     * 是否必填：否
+     * 类型：boolean
+     * 描述：
+     *  是否指定分账
+     *  示例值：false
+     * </pre>
+     */
+    @SerializedName(value = "profit_sharing")
+    private Boolean profitSharing;
+  }
+}
diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/WxPayService.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/WxPayService.java
index 442c90afad..fd889cf601 100644
--- a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/WxPayService.java
+++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/WxPayService.java
@@ -169,7 +169,7 @@ public interface WxPayService {
    * <p>
    * 部分字段会包含敏感信息，所以在提交前需要在请求头中会包含"Wechatpay-Serial"信息
    *
-   * @param url        请求地址
+   * @param url 请求地址
    * @return 返回请求结果字符串 string
    * @throws WxPayException the wx pay exception
    */
@@ -550,6 +550,27 @@ public interface WxPayService {
    */
   <T> T createOrderV3(TradeTypeEnum tradeType, WxPayUnifiedOrderV3Request request) throws WxPayException;
 
+  /**
+   * 服务商模式调用统一下单接口，并组装生成支付所需参数对象.
+   *
+   * @param <T>       请使用{@link com.github.binarywang.wxpay.bean.result.WxPayUnifiedOrderV3Result}里的内部类或字段
+   * @param tradeType the trade type
+   * @param request   统一下单请求参数
+   * @return 返回 {@link com.github.binarywang.wxpay.bean.result.WxPayUnifiedOrderV3Result}里的内部类或字段
+   * @throws WxPayException the wx pay exception
+   */
+  <T> T createPartnerOrderV3(TradeTypeEnum tradeType, WxPayPartnerUnifiedOrderV3Request request) throws WxPayException;
+
+  /**
+   * 在发起微信支付前，需要调用统一下单接口，获取"预支付交易会话标识"
+   *
+   * @param tradeType the trade type
+   * @param request   请求对象，注意一些参数如spAppid、spMchid等不用设置，方法内会自动从配置对象中获取到（前提是对应配置中已经设置）
+   * @return the wx pay unified order result
+   * @throws WxPayException the wx pay exception
+   */
+  WxPayUnifiedOrderV3Result unifiedPartnerOrderV3(TradeTypeEnum tradeType, WxPayPartnerUnifiedOrderV3Request request) throws WxPayException;
+
   /**
    * 在发起微信支付前，需要调用统一下单接口，获取"预支付交易会话标识"
    *
@@ -802,15 +823,39 @@ WxPayRefundQueryResult refundQuery(String transactionId, String outTradeNo, Stri
   WxPayOrderNotifyResult parseOrderNotifyResult(String xmlData, String signType) throws WxPayException;
 
   /**
-   * 解析支付结果v3通知.
+   * 解析支付结果v3通知. 直连商户模式
+   * 详见https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_1_5.shtml
+   *
+   * @param notifyData 通知数据
+   * @param header     通知头部数据，不传则表示不校验头
+   * @return the wx pay order notify result
+   * @throws WxPayException the wx pay exception
+   */
+  WxPayNotifyV3Result parseOrderNotifyV3Result(String notifyData, SignatureHeader header) throws WxPayException;
+
+  /**
+   * 服务商模式解析支付结果v3通知.
+   * 详见https://pay.weixin.qq.com/wiki/doc/apiv3_partner/apis/chapter4_1_5.shtml
+   *
+   * @param notifyData 通知数据
+   * @param header     通知头部数据，不传则表示不校验头
+   * @return the wx pay order notify result
+   * @throws WxPayException the wx pay exception
+   */
+  WxPayPartnerNotifyV3Result parsePartnerOrderNotifyV3Result(String notifyData, SignatureHeader header) throws WxPayException;
+
+  /**
+   * 支付服务商和直连商户两种模式
    * 详见https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_1_5.shtml
    *
    * @param notifyData 通知数据
    * @param header     通知头部数据，不传则表示不校验头
+   * @param resultType 结果类型
+   * @param dataType   结果数据类型
    * @return the wx pay order notify result
    * @throws WxPayException the wx pay exception
    */
-  WxPayOrderNotifyV3Result parseOrderNotifyV3Result(String notifyData, SignatureHeader header) throws WxPayException;
+  <T extends WxPayBaseNotifyV3Result<E>, E> T baseParseOrderNotifyV3Result(String notifyData, SignatureHeader header, Class<T> resultType, Class<E> dataType) throws WxPayException;
 
   /**
    * <pre>
@@ -836,7 +881,7 @@ WxPayRefundQueryResult refundQuery(String transactionId, String outTradeNo, Stri
   WxPayRefundNotifyResult parseRefundNotifyResult(String xmlData) throws WxPayException;
 
   /**
-   * 解析退款结果通知
+   * 解析直连商户退款结果通知
    * 详见https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_16&index=9
    *
    * @param notifyData 通知数据
@@ -846,6 +891,17 @@ WxPayRefundQueryResult refundQuery(String transactionId, String outTradeNo, Stri
    */
   WxPayRefundNotifyV3Result parseRefundNotifyV3Result(String notifyData, SignatureHeader header) throws WxPayException;
 
+  /**
+   * 解析服务商模式退款结果通知
+   * 详见https://pay.weixin.qq.com/wiki/doc/apiv3_partner/apis/chapter4_1_11.shtml
+   *
+   * @param notifyData 通知数据
+   * @param header     通知头部数据，不传则表示不校验头
+   * @return the wx pay refund notify result
+   * @throws WxPayException the wx pay exception
+   */
+  WxPayPartnerRefundNotifyV3Result parsePartnerRefundNotifyV3Result(String notifyData, SignatureHeader header) throws WxPayException;
+
   /**
    * 解析扫码支付回调通知
    * 详见https://pay.weixin.qq.com/wiki/doc/api/native.php?chapter=6_4
@@ -1380,6 +1436,7 @@ WxPayRefundQueryResult refundQuery(String transactionId, String outTradeNo, Stri
 
   /**
    * 获取服务商支付分服务类
+   *
    * @return the partner pay score service
    */
   PartnerPayScoreService getPartnerPayScoreService();
diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/impl/BaseWxPayServiceImpl.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/impl/BaseWxPayServiceImpl.java
index 728707af0f..a749f51fd9 100644
--- a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/impl/BaseWxPayServiceImpl.java
+++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/impl/BaseWxPayServiceImpl.java
@@ -31,6 +31,7 @@
 import lombok.Setter;
 import me.chanjar.weixin.common.error.WxRuntimeException;
 import org.apache.commons.lang3.StringUtils;
+import org.apache.commons.lang3.reflect.ConstructorUtils;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
@@ -343,7 +344,17 @@ private boolean verifyNotifySign(SignatureHeader header, String data) {
   }
 
   @Override
-  public WxPayOrderNotifyV3Result parseOrderNotifyV3Result(String notifyData, SignatureHeader header) throws WxPayException {
+  public WxPayNotifyV3Result parseOrderNotifyV3Result(String notifyData, SignatureHeader header) throws WxPayException {
+    return baseParseOrderNotifyV3Result(notifyData, header, WxPayNotifyV3Result.class, WxPayNotifyV3Result.DecryptNotifyResult.class);
+  }
+
+  @Override
+  public WxPayPartnerNotifyV3Result parsePartnerOrderNotifyV3Result(String notifyData, SignatureHeader header) throws WxPayException {
+    return this.baseParseOrderNotifyV3Result(notifyData, header, WxPayPartnerNotifyV3Result.class, WxPayPartnerNotifyV3Result.DecryptNotifyResult.class);
+  }
+
+  @Override
+  public <T extends WxPayBaseNotifyV3Result<E>, E> T baseParseOrderNotifyV3Result(String notifyData, SignatureHeader header, Class<T> resultType, Class<E> dataType) throws WxPayException {
     if (Objects.nonNull(header) && !this.verifyNotifySign(header, notifyData)) {
       throw new WxPayException("非法请求，头部信息验证失败");
     }
@@ -355,12 +366,12 @@ public WxPayOrderNotifyV3Result parseOrderNotifyV3Result(String notifyData, Sign
     String apiV3Key = this.getConfig().getApiV3Key();
     try {
       String result = AesUtils.decryptToString(associatedData, nonce, cipherText, apiV3Key);
-      WxPayOrderNotifyV3Result.DecryptNotifyResult decryptNotifyResult = GSON.fromJson(result, WxPayOrderNotifyV3Result.DecryptNotifyResult.class);
-      WxPayOrderNotifyV3Result notifyResult = new WxPayOrderNotifyV3Result();
+      E decryptNotifyResult = GSON.fromJson(result, dataType);
+      T notifyResult = ConstructorUtils.invokeConstructor(resultType);
       notifyResult.setRawData(response);
       notifyResult.setResult(decryptNotifyResult);
       return notifyResult;
-    } catch (GeneralSecurityException | IOException e) {
+    } catch (Exception e) {
       throw new WxPayException("解析报文异常！", e);
     }
   }
@@ -409,25 +420,12 @@ public WxPayRefundNotifyResult parseRefundNotifyResult(String xmlData) throws Wx
 
   @Override
   public WxPayRefundNotifyV3Result parseRefundNotifyV3Result(String notifyData, SignatureHeader header) throws WxPayException {
-    if (Objects.nonNull(header) && !this.verifyNotifySign(header, notifyData)) {
-      throw new WxPayException("非法请求，头部信息验证失败");
-    }
-    OriginNotifyResponse response = GSON.fromJson(notifyData, OriginNotifyResponse.class);
-    OriginNotifyResponse.Resource resource = response.getResource();
-    String cipherText = resource.getCiphertext();
-    String associatedData = resource.getAssociatedData();
-    String nonce = resource.getNonce();
-    String apiV3Key = this.getConfig().getApiV3Key();
-    try {
-      String result = AesUtils.decryptToString(associatedData, nonce, cipherText, apiV3Key);
-      WxPayRefundNotifyV3Result.DecryptNotifyResult decryptNotifyResult = GSON.fromJson(result, WxPayRefundNotifyV3Result.DecryptNotifyResult.class);
-      WxPayRefundNotifyV3Result notifyResult = new WxPayRefundNotifyV3Result();
-      notifyResult.setRawData(response);
-      notifyResult.setResult(decryptNotifyResult);
-      return notifyResult;
-    } catch (GeneralSecurityException | IOException e) {
-      throw new WxPayException("解析报文异常！", e);
-    }
+    return this.baseParseOrderNotifyV3Result(notifyData, header, WxPayRefundNotifyV3Result.class, WxPayRefundNotifyV3Result.DecryptNotifyResult.class);
+  }
+
+  @Override
+  public WxPayPartnerRefundNotifyV3Result parsePartnerRefundNotifyV3Result(String notifyData, SignatureHeader header) throws WxPayException {
+    return this.baseParseOrderNotifyV3Result(notifyData, header, WxPayPartnerRefundNotifyV3Result.class, WxPayPartnerRefundNotifyV3Result.DecryptNotifyResult.class);
   }
 
   @Override
@@ -665,6 +663,37 @@ public <T> T createOrderV3(TradeTypeEnum tradeType, WxPayUnifiedOrderV3Request r
     return result.getPayInfo(tradeType, request.getAppid(), request.getMchid(), this.getConfig().getPrivateKey());
   }
 
+  @Override
+  public <T> T createPartnerOrderV3(TradeTypeEnum tradeType, WxPayPartnerUnifiedOrderV3Request request) throws WxPayException {
+    WxPayUnifiedOrderV3Result result = this.unifiedPartnerOrderV3(tradeType, request);
+    //获取应用ID
+    String appId = StringUtils.isBlank(request.getSubAppid()) ? request.getSpAppid() : request.getSubAppid();
+    return result.getPayInfo(tradeType, appId, request.getSubMchId(), this.getConfig().getPrivateKey());
+  }
+
+  @Override
+  public WxPayUnifiedOrderV3Result unifiedPartnerOrderV3(TradeTypeEnum tradeType, WxPayPartnerUnifiedOrderV3Request request) throws WxPayException {
+    if (StringUtils.isBlank(request.getSpAppid())) {
+      request.setSpAppid(this.getConfig().getAppId());
+    }
+    if (StringUtils.isBlank(request.getSpMchId())) {
+      request.setSpMchId(this.getConfig().getMchId());
+    }
+    if (StringUtils.isBlank(request.getNotifyUrl())) {
+      request.setNotifyUrl(this.getConfig().getNotifyUrl());
+    }
+    if (StringUtils.isBlank(request.getSubAppid())) {
+      request.setSubAppid(this.getConfig().getSubAppId());
+    }
+    if (StringUtils.isBlank(request.getSubMchId())) {
+      request.setSubMchId(this.getConfig().getSubMchId());
+    }
+
+    String url = this.getPayBaseUrl() + tradeType.getPartnerUrl();
+    String response = this.postV3(url, GSON.toJson(request));
+    return GSON.fromJson(response, WxPayUnifiedOrderV3Result.class);
+  }
+
   @Override
   public WxPayUnifiedOrderV3Result unifiedOrderV3(TradeTypeEnum tradeType, WxPayUnifiedOrderV3Request request) throws WxPayException {
     if (StringUtils.isBlank(request.getAppid())) {
diff --git a/weixin-java-pay/src/test/java/com/github/binarywang/wxpay/service/impl/BaseWxPayServiceImplTest.java b/weixin-java-pay/src/test/java/com/github/binarywang/wxpay/service/impl/BaseWxPayServiceImplTest.java
index ad4a36962b..2effc6260a 100644
--- a/weixin-java-pay/src/test/java/com/github/binarywang/wxpay/service/impl/BaseWxPayServiceImplTest.java
+++ b/weixin-java-pay/src/test/java/com/github/binarywang/wxpay/service/impl/BaseWxPayServiceImplTest.java
@@ -796,7 +796,7 @@ public String testParseOrderNotifyV3Result(HttpServletRequest request, HttpServl
     log.info("请求头参数为：timestamp:{} nonce:{} serialNo:{} signature:{}", timestamp, nonce, serialNo, signature);
 
     // V2版本请参考com.github.binarywang.wxpay.bean.notify.WxPayRefundNotifyResultTest里的单元测试
-    final WxPayOrderNotifyV3Result wxPayOrderNotifyV3Result = this.payService.parseOrderNotifyV3Result(RequestUtils.readData(request),
+    final WxPayNotifyV3Result wxPayOrderNotifyV3Result = this.payService.parseOrderNotifyV3Result(RequestUtils.readData(request),
       new SignatureHeader(timestamp, nonce, signature, serialNo));
     log.info(GSON.toJson(wxPayOrderNotifyV3Result));
 

From af13bb7114bd1af0743788ee30e67b72dc38c189 Mon Sep 17 00:00:00 2001
From: 13294258710 <guoshuai19971210@163.com>
Date: Fri, 16 Jun 2023 10:10:28 +0800
Subject: [PATCH 2/5] =?UTF-8?q?=E4=BC=98=E5=8C=96=E6=94=AF=E4=BB=98/?=
 =?UTF-8?q?=E9=80=80=E6=AC=BE=E7=BB=93=E6=9E=9C=E8=A7=A3=E6=9E=90=EF=BC=8C?=
 =?UTF-8?q?=E5=A2=9E=E5=8A=A0=E5=AF=B9V3=E7=89=88=E6=9C=AC=E6=9C=8D?=
 =?UTF-8?q?=E5=8A=A1=E5=95=86=E7=9A=84=E4=B8=8B=E5=8D=95/=E9=80=80?=
 =?UTF-8?q?=E6=AC=BE=E6=94=AF=E6=8C=81?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../binarywang/wxpay/bean/notify/WxPayBaseNotifyV3Result.java | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/WxPayBaseNotifyV3Result.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/WxPayBaseNotifyV3Result.java
index 41d6ab4273..86915d0956 100644
--- a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/WxPayBaseNotifyV3Result.java
+++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/WxPayBaseNotifyV3Result.java
@@ -12,7 +12,6 @@ public interface WxPayBaseNotifyV3Result<T> {
    * 设置原始数据
    *
    * @param rawData 原始数据
-   * @return void
    * @author Pursuer
    * @date 2023/6/15
    * @since 1.0
@@ -22,8 +21,7 @@ public interface WxPayBaseNotifyV3Result<T> {
   /**
    * 解密后的数据
    *
-   * @param data
-   * @return void
+   * @param data 解密后的数据
    * @author Pursuer
    * @date 2023/6/15
    * @since 1.0

From 84591b15de3eb75ad672a82c1f89f25143aeffcf Mon Sep 17 00:00:00 2001
From: 13294258710 <guoshuai19971210@163.com>
Date: Wed, 21 Jun 2023 10:29:03 +0800
Subject: [PATCH 3/5] =?UTF-8?q?=E6=9C=8D=E5=8A=A1=E5=95=86=E6=A8=A1?=
 =?UTF-8?q?=E5=BC=8FURL=E4=BF=AE=E6=94=B9=EF=BC=8C=E5=A2=9E=E5=8A=A0?=
 =?UTF-8?q?=E6=9C=8D=E5=8A=A1=E5=95=86=E6=A8=A1=E5=BC=8F=E5=85=B3=E9=97=AD?=
 =?UTF-8?q?=E8=AE=A2=E5=8D=95=E6=96=B9=E6=B3=95?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../WxPayPartnerOrderCloseV3Request.java      | 61 +++++++++++++++++++
 .../request/WxPayPartnerRefundV3Request.java  | 13 ----
 .../bean/request/WxPayRefundV3Request.java    | 11 ++++
 .../result/WxPayUnifiedOrderV3Result.java     | 29 +++++++++
 .../result/enums/PartnerTradeTypeEnum.java    | 40 ++++++++++++
 .../wxpay/service/WxPayService.java           | 39 +++++++++++-
 .../service/impl/BaseWxPayServiceImpl.java    | 29 ++++++++-
 7 files changed, 204 insertions(+), 18 deletions(-)
 create mode 100644 weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/request/WxPayPartnerOrderCloseV3Request.java
 create mode 100644 weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/result/enums/PartnerTradeTypeEnum.java

diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/request/WxPayPartnerOrderCloseV3Request.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/request/WxPayPartnerOrderCloseV3Request.java
new file mode 100644
index 0000000000..7a62629fb4
--- /dev/null
+++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/request/WxPayPartnerOrderCloseV3Request.java
@@ -0,0 +1,61 @@
+package com.github.binarywang.wxpay.bean.request;
+
+import com.google.gson.annotations.SerializedName;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import lombok.experimental.Accessors;
+
+import java.io.Serializable;
+
+/**
+ * 服务商关闭订单请求对象类
+ * 文档见：https://pay.weixin.qq.com/wiki/doc/apiv3_partner/apis/chapter4_1_3.shtml
+ *
+ * @author Guo Shuai
+ * @version 1.0
+ * @date 2023/3/2
+ */
+@Data
+@NoArgsConstructor
+@Accessors(chain = true)
+public class WxPayPartnerOrderCloseV3Request implements Serializable {
+  private static final long serialVersionUID = 1L;
+  /**
+   * <pre>
+   * 字段名：服务商商户号
+   * 变量名：sp_mchid
+   * 是否必填：是
+   * 类型：string[1,32]
+   * 描述：
+   *  服务商商户号，由微信支付生成并下发。
+   *  示例值：1230000109
+   * </pre>
+   */
+  @SerializedName(value = "sp_mchid")
+  private String spMchId;
+  /**
+   * <pre>
+   * 字段名：特约商户商户号
+   * 变量名：sp_mchid
+   * 是否必填：是
+   * 类型：string[1,32]
+   * 描述：
+   *  特约商户商户号，由微信支付生成并下发。
+   *  示例值：1230000109
+   * </pre>
+   */
+  @SerializedName(value = "sub_mchid")
+  private String subMchId;
+  /**
+   * <pre>
+   * 字段名：商户订单号
+   * 变量名：out_trade_no
+   * 是否必填：是
+   * 类型：string[6,32]
+   * 描述：
+   *  商户系统内部订单号，只能是数字、大小写字母_-*且在同一个商户号下唯一
+   *  示例值：1217752501201407033233368018
+   * </pre>
+   */
+  private transient String outTradeNo;
+}
diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/request/WxPayPartnerRefundV3Request.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/request/WxPayPartnerRefundV3Request.java
index 89d0e11f58..299cf2a94b 100644
--- a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/request/WxPayPartnerRefundV3Request.java
+++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/request/WxPayPartnerRefundV3Request.java
@@ -21,19 +21,6 @@
 @Accessors(chain = true)
 public class WxPayPartnerRefundV3Request extends WxPayRefundV3Request implements Serializable {
   private static final long serialVersionUID = -1L;
-  /**
-   * <pre>
-   * 字段名：子商户的商户号
-   * 变量名：sub_mchid
-   * 是否必填：是
-   * 类型：string[1, 32]
-   * 描述：
-   *  子商户商户号，由微信支付生成并下发。
-   *  示例值：1230000109
-   * </pre>
-   */
-  @SerializedName(value = "sub_mchid")
-  private String subMchId;
   /**
    * <pre>
    * 字段名：退款资金来源
diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/request/WxPayRefundV3Request.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/request/WxPayRefundV3Request.java
index 31a41d9222..e9f1f3b140 100644
--- a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/request/WxPayRefundV3Request.java
+++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/request/WxPayRefundV3Request.java
@@ -238,6 +238,17 @@ public static class GoodsDetail implements Serializable {
     private Integer refundQuantity;
   }
 
+  /**
+   * <pre>
+   * 字段名：子商户的商户号
+   * 变量名：sub_mchid
+   * 是否必填：是
+   * 类型：string[1, 32]
+   * 描述：
+   *  子商户商户号，由微信支付生成并下发。
+   *  示例值：1230000109
+   * </pre>
+   */
   @SerializedName(value = "sub_mchid")
   private String subMchid;
 }
diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/result/WxPayUnifiedOrderV3Result.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/result/WxPayUnifiedOrderV3Result.java
index 309fb8e752..f37d268739 100644
--- a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/result/WxPayUnifiedOrderV3Result.java
+++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/result/WxPayUnifiedOrderV3Result.java
@@ -1,5 +1,6 @@
 package com.github.binarywang.wxpay.bean.result;
 
+import com.github.binarywang.wxpay.bean.result.enums.PartnerTradeTypeEnum;
 import com.github.binarywang.wxpay.bean.result.enums.TradeTypeEnum;
 import com.github.binarywang.wxpay.v3.util.SignUtils;
 import com.google.gson.annotations.SerializedName;
@@ -132,4 +133,32 @@ public <T> T getPayInfo(TradeTypeEnum tradeType, String appId, String mchId, Pri
         throw new WxRuntimeException("不支持的支付类型");
     }
   }
+
+  public <T> T getPartnerPayInfo(PartnerTradeTypeEnum tradeType, String appId, String mchId, PrivateKey privateKey) {
+    String timestamp = String.valueOf(System.currentTimeMillis() / 1000);
+    String nonceStr = SignUtils.genRandomStr();
+    switch (tradeType) {
+      case JSAPI:
+        JsapiResult jsapiResult = new JsapiResult();
+        jsapiResult.setAppId(appId).setTimeStamp(timestamp)
+          .setPackageValue("prepay_id=" + this.prepayId).setNonceStr(nonceStr)
+          //签名类型，默认为RSA，仅支持RSA。
+          .setSignType("RSA").setPaySign(SignUtils.sign(jsapiResult.getSignStr(), privateKey));
+        return (T) jsapiResult;
+      case H5:
+        return (T) this.h5Url;
+      case APP:
+        AppResult appResult = new AppResult();
+        appResult.setAppid(appId).setPrepayId(this.prepayId).setPartnerId(mchId)
+          .setNoncestr(nonceStr).setTimestamp(timestamp)
+          //暂填写固定值Sign=WXPay
+          .setPackageValue("Sign=WXPay")
+          .setSign(SignUtils.sign(appResult.getSignStr(), privateKey));
+        return (T) appResult;
+      case NATIVE:
+        return (T) this.codeUrl;
+      default:
+        throw new WxRuntimeException("不支持的支付类型");
+    }
+  }
 }
diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/result/enums/PartnerTradeTypeEnum.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/result/enums/PartnerTradeTypeEnum.java
new file mode 100644
index 0000000000..7704bf7d25
--- /dev/null
+++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/result/enums/PartnerTradeTypeEnum.java
@@ -0,0 +1,40 @@
+package com.github.binarywang.wxpay.bean.result.enums;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+/**
+ * 支付方式
+ *
+ * @author thinsstar
+ */
+@Getter
+@AllArgsConstructor
+public enum PartnerTradeTypeEnum {
+  /**
+   * APP
+   */
+  APP("/v3/pay/partner/transactions/app", "/v3/combine-transactions/app"),
+  /**
+   * JSAPI 或 小程序
+   */
+  JSAPI("/v3/pay/partner/transactions/jsapi", "/v3/combine-transactions/jsapi"),
+  /**
+   * NATIVE
+   */
+  NATIVE("/v3/pay/partner/transactions/native", "/v3/combine-transactions/native"),
+  /**
+   * H5
+   */
+  H5("/v3/pay/partner/transactions/h5", "/v3/combine-transactions/h5");
+
+  /**
+   * 单独下单url
+   */
+  private final String partnerUrl;
+
+  /**
+   * 合并下单url
+   */
+  private final String combineUrl;
+}
diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/WxPayService.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/WxPayService.java
index fd889cf601..0ac0c43cc9 100644
--- a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/WxPayService.java
+++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/WxPayService.java
@@ -5,6 +5,7 @@
 import com.github.binarywang.wxpay.bean.notify.*;
 import com.github.binarywang.wxpay.bean.request.*;
 import com.github.binarywang.wxpay.bean.result.*;
+import com.github.binarywang.wxpay.bean.result.enums.PartnerTradeTypeEnum;
 import com.github.binarywang.wxpay.bean.result.enums.TradeTypeEnum;
 import com.github.binarywang.wxpay.config.WxPayConfig;
 import com.github.binarywang.wxpay.constant.WxPayConstants;
@@ -477,6 +478,23 @@ public interface WxPayService {
    */
   void closeOrderV3(String outTradeNo) throws WxPayException;
 
+  /**
+   * <pre>
+   * 服务商关闭订单
+   * 应用场景
+   * 以下情况需要调用关单接口：
+   * 1、商户订单支付失败需要生成新单号重新发起支付，要对原订单号调用关单，避免重复支付；
+   * 2、系统下单后，用户支付超时，系统退出不再受理，避免用户继续，请调用关单接口。
+   * 注意：关单没有时间限制，建议在订单生成后间隔几分钟（最短5分钟）再调用关单接口，避免出现订单状态同步不及时导致关单失败。
+   * 接口地址：https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_1_3.shtml
+   * </pre>
+   *
+   * @param outTradeNo 商户系统内部的订单号
+   * @return the wx pay order close result
+   * @throws WxPayException the wx pay exception
+   */
+  void closePartnerOrderV3(String outTradeNo) throws WxPayException;
+
   /**
    * <pre>
    * 关闭订单
@@ -494,6 +512,23 @@ public interface WxPayService {
    */
   void closeOrderV3(WxPayOrderCloseV3Request request) throws WxPayException;
 
+  /**
+   * <pre>
+   * 服务商关闭订单
+   * 应用场景
+   * 以下情况需要调用关单接口：
+   * 1、商户订单支付失败需要生成新单号重新发起支付，要对原订单号调用关单，避免重复支付；
+   * 2、系统下单后，用户支付超时，系统退出不再受理，避免用户继续，请调用关单接口。
+   * 注意：关单没有时间限制，建议在订单生成后间隔几分钟（最短5分钟）再调用关单接口，避免出现订单状态同步不及时导致关单失败。
+   * 接口地址：https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_1_3.shtml
+   * </pre>
+   *
+   * @param request 关闭订单请求对象
+   * @return the wx pay order close result
+   * @throws WxPayException the wx pay exception
+   */
+  void closePartnerOrderV3(WxPayPartnerOrderCloseV3Request request) throws WxPayException;
+
   /**
    * <pre>
    * 合单关闭订单API
@@ -559,7 +594,7 @@ public interface WxPayService {
    * @return 返回 {@link com.github.binarywang.wxpay.bean.result.WxPayUnifiedOrderV3Result}里的内部类或字段
    * @throws WxPayException the wx pay exception
    */
-  <T> T createPartnerOrderV3(TradeTypeEnum tradeType, WxPayPartnerUnifiedOrderV3Request request) throws WxPayException;
+  <T> T createPartnerOrderV3(PartnerTradeTypeEnum tradeType, WxPayPartnerUnifiedOrderV3Request request) throws WxPayException;
 
   /**
    * 在发起微信支付前，需要调用统一下单接口，获取"预支付交易会话标识"
@@ -569,7 +604,7 @@ public interface WxPayService {
    * @return the wx pay unified order result
    * @throws WxPayException the wx pay exception
    */
-  WxPayUnifiedOrderV3Result unifiedPartnerOrderV3(TradeTypeEnum tradeType, WxPayPartnerUnifiedOrderV3Request request) throws WxPayException;
+  WxPayUnifiedOrderV3Result unifiedPartnerOrderV3(PartnerTradeTypeEnum tradeType, WxPayPartnerUnifiedOrderV3Request request) throws WxPayException;
 
   /**
    * 在发起微信支付前，需要调用统一下单接口，获取"预支付交易会话标识"
diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/impl/BaseWxPayServiceImpl.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/impl/BaseWxPayServiceImpl.java
index a749f51fd9..588b8a66f3 100644
--- a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/impl/BaseWxPayServiceImpl.java
+++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/impl/BaseWxPayServiceImpl.java
@@ -10,6 +10,7 @@
 import com.github.binarywang.wxpay.bean.order.WxPayNativeOrderResult;
 import com.github.binarywang.wxpay.bean.request.*;
 import com.github.binarywang.wxpay.bean.result.*;
+import com.github.binarywang.wxpay.bean.result.enums.PartnerTradeTypeEnum;
 import com.github.binarywang.wxpay.bean.result.enums.TradeTypeEnum;
 import com.github.binarywang.wxpay.config.WxPayConfig;
 import com.github.binarywang.wxpay.config.WxPayConfigHolder;
@@ -538,6 +539,16 @@ public void closeOrderV3(String outTradeNo) throws WxPayException {
     this.closeOrderV3(request);
   }
 
+  @Override
+  public void closePartnerOrderV3(String outTradeNo) throws WxPayException {
+    if (StringUtils.isBlank(outTradeNo)) {
+      throw new WxPayException("out_trade_no不能为空");
+    }
+    WxPayPartnerOrderCloseV3Request request = new WxPayPartnerOrderCloseV3Request();
+    request.setOutTradeNo(StringUtils.trimToNull(outTradeNo));
+    this.closePartnerOrderV3(request);
+  }
+
   @Override
   public void closeOrderV3(WxPayOrderCloseV3Request request) throws WxPayException {
     if (StringUtils.isBlank(request.getMchid())) {
@@ -547,6 +558,18 @@ public void closeOrderV3(WxPayOrderCloseV3Request request) throws WxPayException
     this.postV3(url, GSON.toJson(request));
   }
 
+  @Override
+  public void closePartnerOrderV3(WxPayPartnerOrderCloseV3Request request) throws WxPayException {
+    if (StringUtils.isBlank(request.getSpMchId())) {
+      request.setSpMchId(this.getConfig().getMchId());
+    }
+    if (StringUtils.isBlank(request.getSubMchId())) {
+      request.setSubMchId(this.getConfig().getSubMchId());
+    }
+    String url = String.format("%s/v3/pay/partner/transactions/out-trade-no/%s/close", this.getPayBaseUrl(), request.getOutTradeNo());
+    this.postV3(url, GSON.toJson(request));
+  }
+
   @Override
   public void closeCombine(CombineCloseRequest request) throws WxPayException {
     String url = String.format("%s/v3/combine-transactions/out-trade-no/%s/close", this.getPayBaseUrl(), request.getCombineOutTradeNo());
@@ -664,15 +687,15 @@ public <T> T createOrderV3(TradeTypeEnum tradeType, WxPayUnifiedOrderV3Request r
   }
 
   @Override
-  public <T> T createPartnerOrderV3(TradeTypeEnum tradeType, WxPayPartnerUnifiedOrderV3Request request) throws WxPayException {
+  public <T> T createPartnerOrderV3(PartnerTradeTypeEnum tradeType, WxPayPartnerUnifiedOrderV3Request request) throws WxPayException {
     WxPayUnifiedOrderV3Result result = this.unifiedPartnerOrderV3(tradeType, request);
     //获取应用ID
     String appId = StringUtils.isBlank(request.getSubAppid()) ? request.getSpAppid() : request.getSubAppid();
-    return result.getPayInfo(tradeType, appId, request.getSubMchId(), this.getConfig().getPrivateKey());
+    return result.getPartnerPayInfo(tradeType, appId, request.getSubMchId(), this.getConfig().getPrivateKey());
   }
 
   @Override
-  public WxPayUnifiedOrderV3Result unifiedPartnerOrderV3(TradeTypeEnum tradeType, WxPayPartnerUnifiedOrderV3Request request) throws WxPayException {
+  public WxPayUnifiedOrderV3Result unifiedPartnerOrderV3(PartnerTradeTypeEnum tradeType, WxPayPartnerUnifiedOrderV3Request request) throws WxPayException {
     if (StringUtils.isBlank(request.getSpAppid())) {
       request.setSpAppid(this.getConfig().getAppId());
     }

From c4f0a4ae548d968d0b5c01df62b0095269c047d0 Mon Sep 17 00:00:00 2001
From: 13294258710 <guoshuai19971210@163.com>
Date: Sun, 25 Jun 2023 16:57:08 +0800
Subject: [PATCH 4/5] =?UTF-8?q?=E8=A7=A3=E5=86=B3V3=E6=9C=8D=E5=8A=A1?=
 =?UTF-8?q?=E5=95=86=E6=A8=A1=E5=BC=8F=E4=B8=8B=E5=8D=95BUG=EF=BC=8C?=
 =?UTF-8?q?=E5=A2=9E=E5=8A=A0=E6=9C=8D=E5=8A=A1=E5=95=86=E6=A8=A1=E5=BC=8F?=
 =?UTF-8?q?V3=E8=AE=A2=E5=8D=95=E6=9F=A5=E8=AF=A2?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../notify/WxPayPartnerNotifyV3Result.java    |   2 +-
 .../WxPayPartnerRefundNotifyV3Result.java     |   2 +-
 .../WxPayPartnerOrderCloseV3Request.java      |   4 +-
 .../WxPayPartnerOrderQueryV3Request.java      |  76 +++
 .../request/WxPayPartnerRefundV3Request.java  |   2 +-
 .../WxPayPartnerUnifiedOrderV3Request.java    |   2 +-
 .../WxPayPartnerOrderQueryV3Result.java       | 555 ++++++++++++++++++
 .../result/WxPayUnifiedOrderV3Result.java     |  28 -
 .../result/enums/PartnerTradeTypeEnum.java    |  13 +-
 .../wxpay/service/WxPayService.java           |  48 +-
 .../service/impl/BaseWxPayServiceImpl.java    |  54 +-
 11 files changed, 742 insertions(+), 44 deletions(-)
 create mode 100644 weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/request/WxPayPartnerOrderQueryV3Request.java
 create mode 100644 weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/result/WxPayPartnerOrderQueryV3Result.java

diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/WxPayPartnerNotifyV3Result.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/WxPayPartnerNotifyV3Result.java
index 2a33910fd5..58f3dbb2a1 100644
--- a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/WxPayPartnerNotifyV3Result.java
+++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/WxPayPartnerNotifyV3Result.java
@@ -11,7 +11,7 @@
  * 微信支付服务商下单回调
  * 文档见：https://pay.weixin.qq.com/wiki/doc/apiv3_partner/apis/chapter4_1_5.shtml
  *
- * @author Guo Shuai
+ * @author Pursuer
  * @version 1.0
  * @date 2023/3/2
  */
diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/WxPayPartnerRefundNotifyV3Result.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/WxPayPartnerRefundNotifyV3Result.java
index f3dcf168b1..fc0007565d 100644
--- a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/WxPayPartnerRefundNotifyV3Result.java
+++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/WxPayPartnerRefundNotifyV3Result.java
@@ -10,7 +10,7 @@
  * 微信支付服务商退款回调
  * 文档见：https://pay.weixin.qq.com/wiki/doc/apiv3_partner/apis/chapter4_1_11.shtml
  *
- * @author Guo Shuai
+ * @author Pursuer
  * @version 1.0
  * @date 2023/3/2
  */
diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/request/WxPayPartnerOrderCloseV3Request.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/request/WxPayPartnerOrderCloseV3Request.java
index 7a62629fb4..2696bcf60a 100644
--- a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/request/WxPayPartnerOrderCloseV3Request.java
+++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/request/WxPayPartnerOrderCloseV3Request.java
@@ -11,9 +11,9 @@
  * 服务商关闭订单请求对象类
  * 文档见：https://pay.weixin.qq.com/wiki/doc/apiv3_partner/apis/chapter4_1_3.shtml
  *
- * @author Guo Shuai
+ * @author Pursuer
  * @version 1.0
- * @date 2023/3/2
+ * @date 2023/6/21
  */
 @Data
 @NoArgsConstructor
diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/request/WxPayPartnerOrderQueryV3Request.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/request/WxPayPartnerOrderQueryV3Request.java
new file mode 100644
index 0000000000..d22fcf395d
--- /dev/null
+++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/request/WxPayPartnerOrderQueryV3Request.java
@@ -0,0 +1,76 @@
+package com.github.binarywang.wxpay.bean.request;
+
+import com.google.gson.annotations.SerializedName;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import lombok.experimental.Accessors;
+
+import java.io.Serializable;
+
+/**
+ * 服务商查询订单请求对象类
+ * 文档见：https://pay.weixin.qq.com/wiki/doc/apiv3_partner/apis/chapter4_1_2.shtml
+ *
+ * @author Pursuer
+ * @version 1.0
+ * @date 2023/6/25
+ */
+@Data
+@NoArgsConstructor
+@Accessors(chain = true)
+public class WxPayPartnerOrderQueryV3Request implements Serializable {
+  private static final long serialVersionUID = 1L;
+  /**
+   * <pre>
+   * 字段名：服务商商户号
+   * 变量名：sp_mchid
+   * 是否必填：是
+   * 类型：string[1,32]
+   * 描述：
+   *  服务商商户号，由微信支付生成并下发。
+   *  示例值：1230000109
+   * </pre>
+   */
+  @SerializedName(value = "sp_mchid")
+  private String spMchId;
+  /**
+   * <pre>
+   * 字段名：特约商户商户号
+   * 变量名：sp_mchid
+   * 是否必填：是
+   * 类型：string[1,32]
+   * 描述：
+   *  特约商户商户号，由微信支付生成并下发。
+   *  示例值：1230000109
+   * </pre>
+   */
+  @SerializedName(value = "sub_mchid")
+  private String subMchId;
+  /**
+   * <pre>
+   * 字段名：微信支付订单号
+   * 变量名：transaction_id
+   * 是否必填：是
+   * 类型：string[1,32]
+   * 描述：
+   *  微信支付系统生成的订单号
+   *  示例值：1217752501201407033233368018
+   * </pre>
+   */
+  @SerializedName(value = "transaction_id")
+  private String transactionId;
+  /**
+   * <pre>
+   * 字段名：商户订单号
+   * 变量名：out_trade_no
+   * 是否必填：是
+   * 类型：string[1,32]
+   * 描述：
+   *  商户系统内部订单号，只能是数字、大小写字母_-*且在同一个商户号下唯一。
+   *  特殊规则：最小字符长度为6
+   *  示例值：1217752501201407033233368018
+   * </pre>
+   */
+  @SerializedName(value = "out_trade_no")
+  private String outTradeNo;
+}
diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/request/WxPayPartnerRefundV3Request.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/request/WxPayPartnerRefundV3Request.java
index 299cf2a94b..c522c90d88 100644
--- a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/request/WxPayPartnerRefundV3Request.java
+++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/request/WxPayPartnerRefundV3Request.java
@@ -12,7 +12,7 @@
  * 微信支付服务商退款请求
  * 文档见：https://pay.weixin.qq.com/wiki/doc/apiv3_partner/apis/chapter4_1_9.shtml
  *
- * @author Guo Shuai
+ * @author Pursuer
  * @version 1.0
  * @date 2023/3/2
  */
diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/request/WxPayPartnerUnifiedOrderV3Request.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/request/WxPayPartnerUnifiedOrderV3Request.java
index 4e60f0693d..b121170c31 100644
--- a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/request/WxPayPartnerUnifiedOrderV3Request.java
+++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/request/WxPayPartnerUnifiedOrderV3Request.java
@@ -11,7 +11,7 @@
 /**
  * 微信支付服务商下单请求对象
  *
- * @author Guo Shuai
+ * @author Pursuer
  * @version 1.0
  * @date 2023/3/2
  */
diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/result/WxPayPartnerOrderQueryV3Result.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/result/WxPayPartnerOrderQueryV3Result.java
new file mode 100644
index 0000000000..4c540638c9
--- /dev/null
+++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/result/WxPayPartnerOrderQueryV3Result.java
@@ -0,0 +1,555 @@
+package com.github.binarywang.wxpay.bean.result;
+
+import com.google.gson.annotations.SerializedName;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.io.Serializable;
+import java.util.List;
+
+/**
+ * 服务商查询订单返回结果对象类
+ * 文档见：https://pay.weixin.qq.com/wiki/doc/apiv3_partner/apis/chapter4_1_2.shtml
+ *
+ * @author Pursuer
+ * @version 1.0
+ * @date 2023/6/25
+ */
+@Data
+@NoArgsConstructor
+public class WxPayPartnerOrderQueryV3Result implements Serializable {
+  private static final long serialVersionUID = 1L;
+  /**
+   * <pre>
+   * 字段名：服务商应用ID
+   * 变量名：appid
+   * 是否必填：是
+   * 类型：string[1,32]
+   * 描述：
+   *  服务商申请的公众号或移动应用appid。
+   *  示例值：wxd678efh567hg6787
+   * </pre>
+   */
+  @SerializedName(value = "sp_appid")
+  private String spAppid;
+  /**
+   * <pre>
+   * 字段名：服务商户号
+   * 变量名：mchid
+   * 是否必填：是
+   * 类型：string[1,32]
+   * 描述：
+   *  服务商户号，由微信支付生成并下发
+   *  示例值：1230000109
+   * </pre>
+   */
+  @SerializedName(value = "sp_mchid")
+  private String spMchId;
+  /**
+   * <pre>
+   * 字段名：子商户应用ID
+   * 变量名：appid
+   * 是否必填：是
+   * 类型：string[1,32]
+   * 描述：
+   *  子商户申请的公众号或移动应用appid。
+   *  示例值：wxd678efh567hg6787
+   * </pre>
+   */
+  @SerializedName(value = "sub_appid")
+  private String subAppid;
+  /**
+   * <pre>
+   * 字段名：子商户商户号
+   * 变量名：mchid
+   * 是否必填：是
+   * 类型：string[1,32]
+   * 描述：
+   *  子商户的商户号，由微信支付生成并下发。
+   *  示例值：1230000109
+   * </pre>
+   */
+  @SerializedName(value = "sub_mchid")
+  private String subMchId;
+  /**
+   * <pre>
+   * 字段名：商户订单号
+   * 变量名：out_trade_no
+   * 是否必填：是
+   * 类型：string[6,32]
+   * 描述：
+   *  商户系统内部订单号，只能是数字、大小写字母_-*且在同一个商户号下唯一，详见【商户订单号】。
+   *  示例值：1217752501201407033233368018
+   * </pre>
+   */
+  @SerializedName(value = "out_trade_no")
+  private String outTradeNo;
+  /**
+   * <pre>
+   * 字段名：微信支付订单号
+   * 变量名：transaction_id
+   * 是否必填：否
+   * 类型：string[1,32]
+   * 描述：
+   *  微信支付系统生成的订单号。
+   *  示例值：1217752501201407033233368018
+   * </pre>
+   */
+  @SerializedName(value = "transaction_id")
+  private String transactionId;
+  /**
+   * <pre>
+   * 字段名：交易类型
+   * 变量名：trade_type
+   * 是否必填：否
+   * 类型：string[1,16]
+   * 描述：
+   *  交易类型，枚举值：
+   *  JSAPI：公众号支付
+   *  NATIVE：扫码支付
+   *  APP：APP支付
+   *  MICROPAY：付款码支付
+   *  MWEB：H5支付
+   *  FACEPAY：刷脸支付
+   *  示例值：MICROPAY
+   * </pre>
+   */
+  @SerializedName(value = "trade_type")
+  private String tradeType;
+  /**
+   * <pre>
+   * 字段名：交易状态
+   * 变量名：trade_state
+   * 是否必填：是
+   * 类型：string[1,32]
+   * 描述：
+   *  交易状态，枚举值：
+   *  SUCCESS：支付成功
+   *  REFUND：转入退款
+   *  NOTPAY：未支付
+   *  CLOSED：已关闭
+   *  REVOKED：已撤销（付款码支付）
+   *  USERPAYING：用户支付中（付款码支付）
+   *  PAYERROR：支付失败(其他原因，如银行返回失败)
+   *  ACCEPT：已接收，等待扣款
+   *  示例值：SUCCESS
+   * </pre>
+   */
+  @SerializedName(value = "trade_state")
+  private String tradeState;
+  /**
+   * <pre>
+   * 字段名：交易状态描述
+   * 变量名：trade_state_desc
+   * 是否必填：是
+   * 类型：string[1,256]
+   * 描述：
+   *  交易状态描述
+   *  示例值：支付成功
+   * </pre>
+   */
+  @SerializedName(value = "trade_state_desc")
+  private String tradeStateDesc;
+  /**
+   * <pre>
+   * 字段名：付款银行
+   * 变量名：bank_type
+   * 是否必填：否
+   * 类型：string[1,16]
+   * 描述：
+   *  银行类型，采用字符串类型的银行标识。银行标识请参考《银行类型对照表》https://pay.weixin.qq.com/wiki/doc/apiv3/terms_definition/chapter1_1_3.shtml#part-6
+   *  示例值：CMC
+   * </pre>
+   */
+  @SerializedName(value = "bank_type")
+  private String bankType;
+  /**
+   * <pre>
+   * 字段名：附加数据
+   * 变量名：attach
+   * 是否必填：否
+   * 类型：string[1,128]
+   * 描述：
+   *  附加数据，在查询API和支付通知中原样返回，可作为自定义参数使用
+   *  示例值：自定义数据
+   * </pre>
+   */
+  @SerializedName(value = "attach")
+  private String attach;
+  /**
+   * <pre>
+   * 字段名：支付完成时间
+   * 变量名：success_time
+   * 是否必填：否
+   * 类型：string[1,64]
+   * 描述：
+   *  支付完成时间，遵循rfc3339标准格式，格式为YYYY-MM-DDTHH:mm:ss+TIMEZONE，YYYY-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35+08:00表示，北京时间2015年5月20日 13点29分35秒。
+   *  示例值：2018-06-08T10:34:56+08:00
+   * </pre>
+   */
+  @SerializedName(value = "success_time")
+  private String successTime;
+  /**
+   * <pre>
+   * 字段名：支付者
+   * 变量名：payer
+   * 是否必填：是
+   * 类型：object
+   * 描述：
+   *  支付者信息
+   * </pre>
+   */
+  private Payer payer;
+  /**
+   * <pre>
+   * 字段名：订单金额
+   * 变量名：amount
+   * 是否必填：否
+   * 类型：object
+   * 描述：
+   *  订单金额信息，当支付成功时返回该字段。
+   * </pre>
+   */
+  @SerializedName(value = "amount")
+  private Amount amount;
+  /**
+   * <pre>
+   * 字段名：场景信息
+   * 变量名：scene_info
+   * 是否必填：否
+   * 类型：object
+   * 描述：
+   *  支付场景描述
+   * </pre>
+   */
+  @SerializedName(value = "scene_info")
+  private SceneInfo sceneInfo;
+  /**
+   * <pre>
+   * 字段名：优惠功能
+   * 变量名：promotion_detail
+   * 是否必填：否
+   * 类型：array
+   * 描述：
+   *  优惠功能，享受优惠时返回该字段。
+   * </pre>
+   */
+  @SerializedName(value = "promotion_detail")
+  private List<PromotionDetail> promotionDetails;
+
+  @Data
+  @NoArgsConstructor
+  public static class Payer implements Serializable {
+    private static final long serialVersionUID = 1L;
+    /**
+     * <pre>
+     * 字段名：用户标识
+     * 变量名：openid
+     * 是否必填：是
+     * 类型：string[1,128]
+     * 描述：
+     *  用户在直连商户appid下的唯一标识。
+     *  示例值：oUpF8uMuAJO_M2pxb1Q9zNjWeS6o
+     * </pre>
+     */
+    @SerializedName(value = "openid")
+    private String openid;
+  }
+
+  @Data
+  @NoArgsConstructor
+  public static class Amount implements Serializable {
+    private static final long serialVersionUID = 1L;
+    /**
+     * <pre>
+     * 字段名：总金额
+     * 变量名：total
+     * 是否必填：否
+     * 类型：int
+     * 描述：
+     *  订单总金额，单位为分。
+     *  示例值：100
+     * </pre>
+     */
+    @SerializedName(value = "total")
+    private Integer total;
+    /**
+     * <pre>
+     * 字段名：用户支付金额
+     * 变量名：payer_total
+     * 是否必填：否
+     * 类型：int
+     * 描述：
+     *  用户支付金额，单位为分。
+     *  示例值：100
+     * </pre>
+     */
+    @SerializedName(value = "payer_total")
+    private Integer payerTotal;
+    /**
+     * <pre>
+     * 字段名：货币类型
+     * 变量名：currency
+     * 是否必填：否
+     * 类型：string[1,16]
+     * 描述：
+     *  CNY：人民币，境内商户号仅支持人民币。
+     *  示例值：CNY
+     * </pre>
+     */
+    @SerializedName(value = "currency")
+    private String currency;
+    /**
+     * <pre>
+     * 字段名：用户支付币种
+     * 变量名：payer_currency
+     * 是否必填：否
+     * 类型：string[1,16]
+     * 描述：
+     *  用户支付币种
+     *  示例值： CNY
+     * </pre>
+     */
+    @SerializedName(value = "payer_currency")
+    private String payerCurrency;
+  }
+
+  @Data
+  @NoArgsConstructor
+  public static class SceneInfo implements Serializable {
+    private static final long serialVersionUID = 1L;
+    /**
+     * <pre>
+     * 字段名：商户端设备号
+     * 变量名：device_id
+     * 是否必填：否
+     * 类型：string[1,32]
+     * 描述：
+     *  商户端设备号（发起扣款请求的商户服务器设备号）。
+     *  示例值：013467007045764
+     * </pre>
+     */
+    @SerializedName(value = "device_id")
+    private String deviceId;
+  }
+
+  @Data
+  @NoArgsConstructor
+  public static class PromotionDetail implements Serializable {
+    /**
+     * <pre>
+     * 字段名：券ID
+     * 变量名：coupon_id
+     * 是否必填：是
+     * 类型：string[1,32]
+     * 描述：
+     *  券ID
+     *  示例值：109519
+     * </pre>
+     */
+    @SerializedName(value = "coupon_id")
+    private String couponId;
+    /**
+     * <pre>
+     * 字段名：优惠名称
+     * 变量名：name
+     * 是否必填：否
+     * 类型：string[1,64]
+     * 描述：
+     *  优惠名称
+     *  示例值：单品惠-6
+     * </pre>
+     */
+    @SerializedName(value = "name")
+    private String name;
+    /**
+     * <pre>
+     * 字段名：优惠范围
+     * 变量名：scope
+     * 是否必填：否
+     * 类型：string[1,32]
+     * 描述：
+     *  GLOBAL：全场代金券
+     *  SINGLE：单品优惠
+     *  示例值：GLOBAL
+     * </pre>
+     */
+    @SerializedName(value = "scope")
+    private String scope;
+    /**
+     * <pre>
+     * 字段名：优惠类型
+     * 变量名：type
+     * 是否必填：否
+     * 类型：string[1,32]
+     * 描述：
+     *  CASH：充值
+     *  NOCASH：预充值
+     *  示例值：CASH
+     * </pre>
+     */
+    @SerializedName(value = "type")
+    private String type;
+    /**
+     * <pre>
+     * 字段名：优惠券面额
+     * 变量名：amount
+     * 是否必填：是
+     * 类型：int
+     * 描述：
+     *  优惠券面额
+     *  示例值：100
+     * </pre>
+     */
+    @SerializedName(value = "amount")
+    private Integer amount;
+    /**
+     * <pre>
+     * 字段名：活动ID
+     * 变量名：stock_id
+     * 是否必填：否
+     * 类型：string[1,32]
+     * 描述：
+     *  活动ID
+     *  示例值：931386
+     * </pre>
+     */
+    @SerializedName(value = "stock_id")
+    private String stockId;
+    /**
+     * <pre>
+     * 字段名：微信出资
+     * 变量名：wechatpay_contribute
+     * 是否必填：否
+     * 类型：int
+     * 描述：
+     *  微信出资，单位为分
+     *  示例值：0
+     * </pre>
+     */
+    @SerializedName(value = "wechatpay_contribute")
+    private Integer wechatpayContribute;
+    /**
+     * <pre>
+     * 字段名：商户出资
+     * 变量名：merchant_contribute
+     * 是否必填：否
+     * 类型：int
+     * 描述：
+     *  商户出资，单位为分
+     *  示例值：0
+     * </pre>
+     */
+    @SerializedName(value = "merchant_contribute")
+    private Integer merchantContribute;
+    /**
+     * <pre>
+     * 字段名：其他出资
+     * 变量名：other_contribute
+     * 是否必填：否
+     * 类型：int
+     * 描述：
+     *  其他出资，单位为分
+     *  示例值：0
+     * </pre>
+     */
+    @SerializedName(value = "other_contribute")
+    private Integer otherContribute;
+    /**
+     * <pre>
+     * 字段名：优惠币种
+     * 变量名：currency
+     * 是否必填：否
+     * 类型：string[1,16]
+     * 描述：
+     *  CNY：人民币，境内商户号仅支持人民币。
+     *  示例值：CNY
+     * </pre>
+     */
+    @SerializedName(value = "currency")
+    private String currency;
+    /**
+     * <pre>
+     * 字段名：单品列表
+     * 变量名：goods_detail
+     * 是否必填：否
+     * 类型：array
+     * 描述：
+     *  单品列表信息
+     * </pre>
+     */
+    @SerializedName(value = "goods_detail")
+    private List<GoodsDetail> goodsDetails;
+  }
+
+  @Data
+  @NoArgsConstructor
+  public static class GoodsDetail implements Serializable {
+    private static final long serialVersionUID = 1L;
+    /**
+     * <pre>
+     * 字段名：商品编码
+     * 变量名：goods_id
+     * 是否必填：是
+     * 类型：string[1,32]
+     * 描述：
+     *  商品编码
+     *  示例值：M1006
+     * </pre>
+     */
+    @SerializedName(value = "goods_id")
+    private String goodsId;
+    /**
+     * <pre>
+     * 字段名：商品数量
+     * 变量名：quantity
+     * 是否必填：是
+     * 类型：int
+     * 描述：
+     *  用户购买的数量
+     *  示例值：1
+     * </pre>
+     */
+    @SerializedName(value = "quantity")
+    private Integer quantity;
+    /**
+     * <pre>
+     * 字段名：商品单价
+     * 变量名：unit_price
+     * 是否必填：是
+     * 类型：int
+     * 描述：
+     *  商品单价，单位为分
+     *  示例值：100
+     * </pre>
+     */
+    @SerializedName(value = "unit_price")
+    private Integer unitPrice;
+    /**
+     * <pre>
+     * 字段名：商品优惠金额
+     * 变量名：discount_amount
+     * 是否必填：是
+     * 类型：int
+     * 描述：
+     *  商品优惠金额
+     *  示例值：0
+     * </pre>
+     */
+    @SerializedName(value = "discount_amount")
+    private Integer discountAmount;
+    /**
+     * <pre>
+     * 字段名：商品备注
+     * 变量名：goods_remark
+     * 是否必填：否
+     * 类型：string[1,128]
+     * 描述：
+     *  商品备注信息
+     *  示例值：商品备注信息
+     * </pre>
+     */
+    @SerializedName(value = "goods_remark")
+    private String goodsRemark;
+  }
+}
diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/result/WxPayUnifiedOrderV3Result.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/result/WxPayUnifiedOrderV3Result.java
index f37d268739..ba5d1c6a1d 100644
--- a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/result/WxPayUnifiedOrderV3Result.java
+++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/result/WxPayUnifiedOrderV3Result.java
@@ -133,32 +133,4 @@ public <T> T getPayInfo(TradeTypeEnum tradeType, String appId, String mchId, Pri
         throw new WxRuntimeException("不支持的支付类型");
     }
   }
-
-  public <T> T getPartnerPayInfo(PartnerTradeTypeEnum tradeType, String appId, String mchId, PrivateKey privateKey) {
-    String timestamp = String.valueOf(System.currentTimeMillis() / 1000);
-    String nonceStr = SignUtils.genRandomStr();
-    switch (tradeType) {
-      case JSAPI:
-        JsapiResult jsapiResult = new JsapiResult();
-        jsapiResult.setAppId(appId).setTimeStamp(timestamp)
-          .setPackageValue("prepay_id=" + this.prepayId).setNonceStr(nonceStr)
-          //签名类型，默认为RSA，仅支持RSA。
-          .setSignType("RSA").setPaySign(SignUtils.sign(jsapiResult.getSignStr(), privateKey));
-        return (T) jsapiResult;
-      case H5:
-        return (T) this.h5Url;
-      case APP:
-        AppResult appResult = new AppResult();
-        appResult.setAppid(appId).setPrepayId(this.prepayId).setPartnerId(mchId)
-          .setNoncestr(nonceStr).setTimestamp(timestamp)
-          //暂填写固定值Sign=WXPay
-          .setPackageValue("Sign=WXPay")
-          .setSign(SignUtils.sign(appResult.getSignStr(), privateKey));
-        return (T) appResult;
-      case NATIVE:
-        return (T) this.codeUrl;
-      default:
-        throw new WxRuntimeException("不支持的支付类型");
-    }
-  }
 }
diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/result/enums/PartnerTradeTypeEnum.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/result/enums/PartnerTradeTypeEnum.java
index 7704bf7d25..4d69b9240e 100644
--- a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/result/enums/PartnerTradeTypeEnum.java
+++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/result/enums/PartnerTradeTypeEnum.java
@@ -14,19 +14,19 @@ public enum PartnerTradeTypeEnum {
   /**
    * APP
    */
-  APP("/v3/pay/partner/transactions/app", "/v3/combine-transactions/app"),
+  APP("/v3/pay/partner/transactions/app", "/v3/combine-transactions/app", TradeTypeEnum.APP),
   /**
    * JSAPI 或 小程序
    */
-  JSAPI("/v3/pay/partner/transactions/jsapi", "/v3/combine-transactions/jsapi"),
+  JSAPI("/v3/pay/partner/transactions/jsapi", "/v3/combine-transactions/jsapi", TradeTypeEnum.JSAPI),
   /**
    * NATIVE
    */
-  NATIVE("/v3/pay/partner/transactions/native", "/v3/combine-transactions/native"),
+  NATIVE("/v3/pay/partner/transactions/native", "/v3/combine-transactions/native", TradeTypeEnum.NATIVE),
   /**
    * H5
    */
-  H5("/v3/pay/partner/transactions/h5", "/v3/combine-transactions/h5");
+  H5("/v3/pay/partner/transactions/h5", "/v3/combine-transactions/h5", TradeTypeEnum.H5);
 
   /**
    * 单独下单url
@@ -37,4 +37,9 @@ public enum PartnerTradeTypeEnum {
    * 合并下单url
    */
   private final String combineUrl;
+
+  /**
+   * 直连支付枚举
+   */
+  private final TradeTypeEnum directConnTrade;
 }
diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/WxPayService.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/WxPayService.java
index 0ac0c43cc9..aa20645a31 100644
--- a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/WxPayService.java
+++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/WxPayService.java
@@ -412,6 +412,53 @@ public interface WxPayService {
    */
   WxPayOrderQueryV3Result queryOrderV3(WxPayOrderQueryV3Request request) throws WxPayException;
 
+  /**
+   * <pre>
+   * 服务商模式查询订单
+   * 详见 <a href="https://pay.weixin.qq.com/wiki/doc/apiv3_partner/apis/chapter4_1_2.shtml">https://pay.weixin.qq.com/wiki/doc/apiv3_partner/apis/chapter4_1_2.shtml</a>
+   * 商户可以通过查询订单接口主动查询订单状态，完成下一步的业务逻辑。查询订单状态可通过微信支付订单号或商户订单号两种方式查询
+   * 注意：
+   *  查询订单可通过微信支付订单号和商户订单号两种方式查询，两种查询方式返回结果相同
+   * 需要调用查询接口的情况：
+   * ◆ 当商户后台、网络、服务器等出现异常，商户系统最终未接收到支付通知。
+   * ◆ 调用支付接口后，返回系统错误或未知交易状态情况。
+   * ◆ 调用付款码支付API，返回USERPAYING的状态。
+   * ◆ 调用关单或撤销接口API之前，需确认支付状态。
+   * 接口地址：
+   *  https://api.mch.weixin.qq.com/v3/pay/partner/transactions/id/{transaction_id}
+   *  https://api.mch.weixin.qq.com/v3/pay/partner/transactions/out-trade-no/{out_trade_no}
+   * </pre>
+   *
+   * @param transactionId 微信订单号
+   * @param outTradeNo    商户系统内部的订单号，当没提供transactionId时需要传这个。
+   * @return the wx pay order query result
+   * @throws WxPayException the wx pay exception
+   */
+  WxPayPartnerOrderQueryV3Result queryPartnerOrderV3(String transactionId, String outTradeNo) throws WxPayException;
+
+  /**
+   * <pre>
+   * 服务商模式查询订单
+   * 详见 <a href="https://pay.weixin.qq.com/wiki/doc/apiv3_partner/apis/chapter4_1_2.shtml">https://pay.weixin.qq.com/wiki/doc/apiv3_partner/apis/chapter4_1_2.shtml</a>
+   * 商户可以通过查询订单接口主动查询订单状态，完成下一步的业务逻辑。查询订单状态可通过微信支付订单号或商户订单号两种方式查询
+   * 注意：
+   *  查询订单可通过微信支付订单号和商户订单号两种方式查询，两种查询方式返回结果相同
+   * 需要调用查询接口的情况：
+   * ◆ 当商户后台、网络、服务器等出现异常，商户系统最终未接收到支付通知。
+   * ◆ 调用支付接口后，返回系统错误或未知交易状态情况。
+   * ◆ 调用付款码支付API，返回USERPAYING的状态。
+   * ◆ 调用关单或撤销接口API之前，需确认支付状态。
+   * 接口地址：
+   *  https://api.mch.weixin.qq.com/v3/pay/partner/transactions/id/{transaction_id}
+   *  https://api.mch.weixin.qq.com/v3/pay/partner/transactions/out-trade-no/{out_trade_no}
+   * </pre>
+   *
+   * @param request 查询订单请求对象
+   * @return the wx pay order query result
+   * @throws WxPayException the wx pay exception
+   */
+  WxPayPartnerOrderQueryV3Result queryPartnerOrderV3(WxPayPartnerOrderQueryV3Request request) throws WxPayException;
+
   /**
    * <pre>
    * 合单查询订单API
@@ -602,7 +649,6 @@ public interface WxPayService {
    * @param tradeType the trade type
    * @param request   请求对象，注意一些参数如spAppid、spMchid等不用设置，方法内会自动从配置对象中获取到（前提是对应配置中已经设置）
    * @return the wx pay unified order result
-   * @throws WxPayException the wx pay exception
    */
   WxPayUnifiedOrderV3Result unifiedPartnerOrderV3(PartnerTradeTypeEnum tradeType, WxPayPartnerUnifiedOrderV3Request request) throws WxPayException;
 
diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/impl/BaseWxPayServiceImpl.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/impl/BaseWxPayServiceImpl.java
index 4cc2fc3c1c..aaa377c9b1 100644
--- a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/impl/BaseWxPayServiceImpl.java
+++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/impl/BaseWxPayServiceImpl.java
@@ -498,6 +498,31 @@ public WxPayOrderQueryV3Result queryOrderV3(WxPayOrderQueryV3Request request) th
     return GSON.fromJson(response, WxPayOrderQueryV3Result.class);
   }
 
+  @Override
+  public WxPayPartnerOrderQueryV3Result queryPartnerOrderV3(String transactionId, String outTradeNo) throws WxPayException {
+    WxPayPartnerOrderQueryV3Request request = new WxPayPartnerOrderQueryV3Request();
+    request.setOutTradeNo(StringUtils.trimToNull(outTradeNo));
+    request.setTransactionId(StringUtils.trimToNull(transactionId));
+    return this.queryPartnerOrderV3(request);
+  }
+
+  @Override
+  public WxPayPartnerOrderQueryV3Result queryPartnerOrderV3(WxPayPartnerOrderQueryV3Request request) throws WxPayException {
+    if (StringUtils.isBlank(request.getSpMchId())) {
+      request.setSpMchId(this.getConfig().getMchId());
+    }
+    if (StringUtils.isBlank(request.getSubMchId())) {
+      request.setSubMchId(this.getConfig().getSubMchId());
+    }
+    String url = String.format("%s/v3/pay/partner/transactions/out-trade-no/%s", this.getPayBaseUrl(), request.getOutTradeNo());
+    if (Objects.isNull(request.getOutTradeNo())) {
+      url = String.format("%s/v3/pay/partner/transactions/id/%s", this.getPayBaseUrl(), request.getTransactionId());
+    }
+    String query = String.format("?sp_mchid=%s&sub_mchid=%s", request.getSpMchId(), request.getSubMchId());
+    String response = this.getV3(url + query);
+    return GSON.fromJson(response, WxPayPartnerOrderQueryV3Result.class);
+  }
+
   @Override
   public CombineQueryResult queryCombine(String combineOutTradeNo) throws WxPayException {
     String url = String.format("%s/v3/combine-transactions/out-trade-no/%s", this.getPayBaseUrl(), combineOutTradeNo);
@@ -691,15 +716,34 @@ public <T> T createPartnerOrderV3(PartnerTradeTypeEnum tradeType, WxPayPartnerUn
     WxPayUnifiedOrderV3Result result = this.unifiedPartnerOrderV3(tradeType, request);
     //获取应用ID
     String appId = StringUtils.isBlank(request.getSubAppid()) ? request.getSpAppid() : request.getSubAppid();
-    return result.getPartnerPayInfo(tradeType, appId, request.getSubMchId(), this.getConfig().getPrivateKey());
+    return result.getPayInfo(tradeType.getDirectConnTrade(), appId, request.getSubMchId(), this.getConfig().getPrivateKey());
   }
 
   @Override
   public WxPayUnifiedOrderV3Result unifiedPartnerOrderV3(PartnerTradeTypeEnum tradeType, WxPayPartnerUnifiedOrderV3Request request) throws WxPayException {
-    WxPayUnifiedOrderV3Result result = this.unifiedPartnerOrderV3(tradeType, request);
-    //获取应用ID
-    String appId = StringUtils.isBlank(request.getSubAppid()) ? request.getSpAppid() : request.getSubAppid();
-    return result.getPartnerPayInfo(tradeType, appId, request.getSubMchId(), this.getConfig().getPrivateKey());
+    if (StringUtils.isBlank(request.getSpAppid())) {
+      request.setSpAppid(this.getConfig().getAppId());
+    }
+
+    if (StringUtils.isBlank(request.getSpMchId())) {
+      request.setSpMchId(this.getConfig().getMchId());
+    }
+
+    if (StringUtils.isBlank(request.getNotifyUrl())) {
+      request.setNotifyUrl(this.getConfig().getNotifyUrl());
+    }
+
+    if (StringUtils.isBlank(request.getSubAppid())) {
+      request.setSubAppid(this.getConfig().getSubAppId());
+    }
+
+    if (StringUtils.isBlank(request.getSubMchId())) {
+      request.setSubMchId(this.getConfig().getSubMchId());
+    }
+
+    String url = this.getPayBaseUrl() + tradeType.getPartnerUrl();
+    String response = this.postV3(url, GSON.toJson(request));
+    return GSON.fromJson(response, WxPayUnifiedOrderV3Result.class);
   }
 
   @Override

From 6964eac94d965092a7f7ec753891a4e4d5bbad89 Mon Sep 17 00:00:00 2001
From: 13294258710 <guoshuai19971210@163.com>
Date: Fri, 30 Jun 2023 09:36:44 +0800
Subject: [PATCH 5/5] =?UTF-8?q?=E4=BC=98=E5=8C=96=E6=9C=8D=E5=8A=A1?=
 =?UTF-8?q?=E5=95=86=E4=B8=8B=E5=8D=95=E4=BB=A3=E7=A0=81?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../bean/notify/CombineNotifyResult.java      | 28 ++++++++++
 .../request/CombineTransactionsRequest.java   | 56 +++++++++++++++++++
 .../result/WxPayUnifiedOrderV3Result.java     | 29 ----------
 .../result/enums/PartnerTradeTypeEnum.java    | 45 ---------------
 .../bean/result/enums/TradeTypeEnum.java      | 13 +++--
 .../wxpay/service/WxPayService.java           |  7 +--
 .../service/impl/BaseWxPayServiceImpl.java    |  9 ++-
 7 files changed, 100 insertions(+), 87 deletions(-)
 delete mode 100644 weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/result/enums/PartnerTradeTypeEnum.java

diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/CombineNotifyResult.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/CombineNotifyResult.java
index 111deedb19..aba11d2dc0 100644
--- a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/CombineNotifyResult.java
+++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/CombineNotifyResult.java
@@ -250,6 +250,34 @@ public static class SubOrders implements Serializable {
      */
     @SerializedName(value = "out_trade_no")
     private String outTradeNo;
+    /**
+     * <pre>
+     * 字段名：子商户应用ID
+     * 变量名：sub_appid
+     * 是否必填：是
+     * 类型：string[1,32]
+     * 描述：
+     *  子商户申请的应用ID，全局唯一。请求基础下单接口时请注意APPID的应用属性，例如公众号场景下，
+     *  需使用应用属性为公众号的APPID 若sub_openid有传的情况下，
+     *  sub_appid必填，且sub_appid需与sub_openid对应
+     *  示例值：wxd678efh567hg6999
+     * </pre>
+     */
+    @SerializedName(value = "sub_appid")
+    private String subAppid;
+    /**
+     * <pre>
+     * 字段名：二级商户号
+     * 变量名：sub_mchid
+     * 是否必填：是
+     * 类型：string[1,32]
+     * 描述：
+     *  二级商户商户号，由微信支付生成并下发。服务商子商户的商户号，被合单方。直连商户不用传二级商户号。
+     *  示例值：1900000109
+     * </pre>
+     */
+    @SerializedName(value = "sub_mchid")
+    private String subMchid;
     /**
      * <pre>
      * 字段名：订单金额
diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/request/CombineTransactionsRequest.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/request/CombineTransactionsRequest.java
index 036cfe9872..721d9a39e5 100644
--- a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/request/CombineTransactionsRequest.java
+++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/request/CombineTransactionsRequest.java
@@ -240,6 +240,32 @@ public static class SubOrders implements Serializable {
      */
     @SerializedName(value = "out_trade_no")
     private String outTradeNo;
+    /**
+     * <pre>
+     * 字段名：订单优惠标记
+     * 变量名：goods_tag
+     * 是否必填：是
+     * 类型：string[1,32]
+     * 描述：
+     *  订单优惠标记，使用代金券或立减优惠功能时需要的参数，说明详见代金券或立减优惠
+     *  示例值：WXG
+     * </pre>
+     */
+    @SerializedName(value = "goods_tag")
+    private String goodsTag;
+    /**
+     * <pre>
+     * 字段名：二级商户号
+     * 变量名：sub_mchid
+     * 是否必填：是
+     * 类型：string[1,32]
+     * 描述：
+     *  二级商户商户号，由微信支付生成并下发。服务商子商户的商户号，被合单方。直连商户不用传二级商户号。
+     *  示例值：1900000109
+     * </pre>
+     */
+    @SerializedName(value = "sub_mchid")
+    private String subMchid;
     /**
      * <pre>
      * 字段名：商品描述
@@ -264,6 +290,21 @@ public static class SubOrders implements Serializable {
      */
     @SerializedName(value = "settle_info")
     private SettleInfo settleInfo;
+    /**
+     * <pre>
+     * 字段名：子商户应用ID
+     * 变量名：sub_appid
+     * 是否必填：是
+     * 类型：string[1,32]
+     * 描述：
+     *  子商户申请的应用ID，全局唯一。请求基础下单接口时请注意APPID的应用属性，例如公众号场景下，
+     *  需使用应用属性为公众号的APPID 若sub_openid有传的情况下，
+     *  sub_appid必填，且sub_appid需与sub_openid对应
+     *  示例值：wxd678efh567hg6999
+     * </pre>
+     */
+    @SerializedName(value = "sub_appid")
+    private String subAppid;
   }
 
   @Data
@@ -283,6 +324,21 @@ public static class CombinePayerInfo implements Serializable {
      */
     @SerializedName(value = "openid")
     private String openid;
+    /**
+     * <pre>
+     * 字段名：子用户标识
+     * 变量名：sub_openid
+     * 是否必填：是
+     * 类型：string[1,128]
+     * 描述：
+     *  服务商模式下，使用某个子商户的Appid获取的对应用户Openid，
+     *  是用户在该子商户Appid下的唯一标识。openid和sub_openid可以选传其中之一，
+     *  如果选择传sub_openid，则必须传sub_appid。
+     *  示例值：oUpF8uMuAJO_M2pxb1Q9zNjWeS6o
+     * </pre>
+     */
+    @SerializedName(value = "sub_openid")
+    private String subOpenid;
   }
 
   @Data
diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/result/WxPayUnifiedOrderV3Result.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/result/WxPayUnifiedOrderV3Result.java
index f37d268739..309fb8e752 100644
--- a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/result/WxPayUnifiedOrderV3Result.java
+++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/result/WxPayUnifiedOrderV3Result.java
@@ -1,6 +1,5 @@
 package com.github.binarywang.wxpay.bean.result;
 
-import com.github.binarywang.wxpay.bean.result.enums.PartnerTradeTypeEnum;
 import com.github.binarywang.wxpay.bean.result.enums.TradeTypeEnum;
 import com.github.binarywang.wxpay.v3.util.SignUtils;
 import com.google.gson.annotations.SerializedName;
@@ -133,32 +132,4 @@ public <T> T getPayInfo(TradeTypeEnum tradeType, String appId, String mchId, Pri
         throw new WxRuntimeException("不支持的支付类型");
     }
   }
-
-  public <T> T getPartnerPayInfo(PartnerTradeTypeEnum tradeType, String appId, String mchId, PrivateKey privateKey) {
-    String timestamp = String.valueOf(System.currentTimeMillis() / 1000);
-    String nonceStr = SignUtils.genRandomStr();
-    switch (tradeType) {
-      case JSAPI:
-        JsapiResult jsapiResult = new JsapiResult();
-        jsapiResult.setAppId(appId).setTimeStamp(timestamp)
-          .setPackageValue("prepay_id=" + this.prepayId).setNonceStr(nonceStr)
-          //签名类型，默认为RSA，仅支持RSA。
-          .setSignType("RSA").setPaySign(SignUtils.sign(jsapiResult.getSignStr(), privateKey));
-        return (T) jsapiResult;
-      case H5:
-        return (T) this.h5Url;
-      case APP:
-        AppResult appResult = new AppResult();
-        appResult.setAppid(appId).setPrepayId(this.prepayId).setPartnerId(mchId)
-          .setNoncestr(nonceStr).setTimestamp(timestamp)
-          //暂填写固定值Sign=WXPay
-          .setPackageValue("Sign=WXPay")
-          .setSign(SignUtils.sign(appResult.getSignStr(), privateKey));
-        return (T) appResult;
-      case NATIVE:
-        return (T) this.codeUrl;
-      default:
-        throw new WxRuntimeException("不支持的支付类型");
-    }
-  }
 }
diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/result/enums/PartnerTradeTypeEnum.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/result/enums/PartnerTradeTypeEnum.java
deleted file mode 100644
index 4d69b9240e..0000000000
--- a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/result/enums/PartnerTradeTypeEnum.java
+++ /dev/null
@@ -1,45 +0,0 @@
-package com.github.binarywang.wxpay.bean.result.enums;
-
-import lombok.AllArgsConstructor;
-import lombok.Getter;
-
-/**
- * 支付方式
- *
- * @author thinsstar
- */
-@Getter
-@AllArgsConstructor
-public enum PartnerTradeTypeEnum {
-  /**
-   * APP
-   */
-  APP("/v3/pay/partner/transactions/app", "/v3/combine-transactions/app", TradeTypeEnum.APP),
-  /**
-   * JSAPI 或 小程序
-   */
-  JSAPI("/v3/pay/partner/transactions/jsapi", "/v3/combine-transactions/jsapi", TradeTypeEnum.JSAPI),
-  /**
-   * NATIVE
-   */
-  NATIVE("/v3/pay/partner/transactions/native", "/v3/combine-transactions/native", TradeTypeEnum.NATIVE),
-  /**
-   * H5
-   */
-  H5("/v3/pay/partner/transactions/h5", "/v3/combine-transactions/h5", TradeTypeEnum.H5);
-
-  /**
-   * 单独下单url
-   */
-  private final String partnerUrl;
-
-  /**
-   * 合并下单url
-   */
-  private final String combineUrl;
-
-  /**
-   * 直连支付枚举
-   */
-  private final TradeTypeEnum directConnTrade;
-}
diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/result/enums/TradeTypeEnum.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/result/enums/TradeTypeEnum.java
index d22b94801e..18f78c4287 100644
--- a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/result/enums/TradeTypeEnum.java
+++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/result/enums/TradeTypeEnum.java
@@ -14,19 +14,19 @@ public enum TradeTypeEnum {
   /**
    * APP
    */
-  APP("/v3/pay/transactions/app", "/v3/combine-transactions/app"),
+  APP("/v3/pay/transactions/app", "/v3/combine-transactions/app", "/v3/pay/partner/transactions/app"),
   /**
    * JSAPI 或 小程序
    */
-  JSAPI("/v3/pay/transactions/jsapi", "/v3/combine-transactions/jsapi"),
+  JSAPI("/v3/pay/transactions/jsapi", "/v3/combine-transactions/jsapi", "/v3/pay/partner/transactions/jsapi"),
   /**
    * NATIVE
    */
-  NATIVE("/v3/pay/transactions/native", "/v3/combine-transactions/native"),
+  NATIVE("/v3/pay/transactions/native", "/v3/combine-transactions/native", "/v3/pay/partner/transactions/native"),
   /**
    * H5
    */
-  H5("/v3/pay/transactions/h5", "/v3/combine-transactions/h5");
+  H5("/v3/pay/transactions/h5", "/v3/combine-transactions/h5", "/v3/pay/partner/transactions/native");
 
   /**
    * 单独下单url
@@ -37,4 +37,9 @@ public enum TradeTypeEnum {
    * 合并下单url
    */
   private final String combineUrl;
+
+  /**
+   * 服务商下单
+   */
+  private final String basePartnerUrl;
 }
diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/WxPayService.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/WxPayService.java
index aa20645a31..4384f46fa7 100644
--- a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/WxPayService.java
+++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/WxPayService.java
@@ -5,14 +5,12 @@
 import com.github.binarywang.wxpay.bean.notify.*;
 import com.github.binarywang.wxpay.bean.request.*;
 import com.github.binarywang.wxpay.bean.result.*;
-import com.github.binarywang.wxpay.bean.result.enums.PartnerTradeTypeEnum;
 import com.github.binarywang.wxpay.bean.result.enums.TradeTypeEnum;
 import com.github.binarywang.wxpay.config.WxPayConfig;
 import com.github.binarywang.wxpay.constant.WxPayConstants;
 import com.github.binarywang.wxpay.exception.WxPayException;
 import org.apache.http.client.methods.HttpPost;
 import org.apache.http.client.methods.HttpRequestBase;
-
 import java.io.File;
 import java.io.InputStream;
 import java.util.Date;
@@ -641,7 +639,7 @@ public interface WxPayService {
    * @return 返回 {@link com.github.binarywang.wxpay.bean.result.WxPayUnifiedOrderV3Result}里的内部类或字段
    * @throws WxPayException the wx pay exception
    */
-  <T> T createPartnerOrderV3(PartnerTradeTypeEnum tradeType, WxPayPartnerUnifiedOrderV3Request request) throws WxPayException;
+  <T> T createPartnerOrderV3(TradeTypeEnum tradeType, WxPayPartnerUnifiedOrderV3Request request) throws WxPayException;
 
   /**
    * 在发起微信支付前，需要调用统一下单接口，获取"预支付交易会话标识"
@@ -649,8 +647,9 @@ public interface WxPayService {
    * @param tradeType the trade type
    * @param request   请求对象，注意一些参数如spAppid、spMchid等不用设置，方法内会自动从配置对象中获取到（前提是对应配置中已经设置）
    * @return the wx pay unified order result
+   * @throws WxPayException the wx pay exception
    */
-  WxPayUnifiedOrderV3Result unifiedPartnerOrderV3(PartnerTradeTypeEnum tradeType, WxPayPartnerUnifiedOrderV3Request request) throws WxPayException;
+  WxPayUnifiedOrderV3Result unifiedPartnerOrderV3(TradeTypeEnum tradeType, WxPayPartnerUnifiedOrderV3Request request) throws WxPayException;
 
   /**
    * 在发起微信支付前，需要调用统一下单接口，获取"预支付交易会话标识"
diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/impl/BaseWxPayServiceImpl.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/impl/BaseWxPayServiceImpl.java
index aaa377c9b1..845103c0da 100644
--- a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/impl/BaseWxPayServiceImpl.java
+++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/impl/BaseWxPayServiceImpl.java
@@ -10,7 +10,6 @@
 import com.github.binarywang.wxpay.bean.order.WxPayNativeOrderResult;
 import com.github.binarywang.wxpay.bean.request.*;
 import com.github.binarywang.wxpay.bean.result.*;
-import com.github.binarywang.wxpay.bean.result.enums.PartnerTradeTypeEnum;
 import com.github.binarywang.wxpay.bean.result.enums.TradeTypeEnum;
 import com.github.binarywang.wxpay.config.WxPayConfig;
 import com.github.binarywang.wxpay.config.WxPayConfigHolder;
@@ -712,15 +711,15 @@ public <T> T createOrderV3(TradeTypeEnum tradeType, WxPayUnifiedOrderV3Request r
   }
 
   @Override
-  public <T> T createPartnerOrderV3(PartnerTradeTypeEnum tradeType, WxPayPartnerUnifiedOrderV3Request request) throws WxPayException {
+  public <T> T createPartnerOrderV3(TradeTypeEnum tradeType, WxPayPartnerUnifiedOrderV3Request request) throws WxPayException {
     WxPayUnifiedOrderV3Result result = this.unifiedPartnerOrderV3(tradeType, request);
     //获取应用ID
     String appId = StringUtils.isBlank(request.getSubAppid()) ? request.getSpAppid() : request.getSubAppid();
-    return result.getPayInfo(tradeType.getDirectConnTrade(), appId, request.getSubMchId(), this.getConfig().getPrivateKey());
+    return result.getPayInfo(tradeType, appId, request.getSubMchId(), this.getConfig().getPrivateKey());
   }
 
   @Override
-  public WxPayUnifiedOrderV3Result unifiedPartnerOrderV3(PartnerTradeTypeEnum tradeType, WxPayPartnerUnifiedOrderV3Request request) throws WxPayException {
+  public WxPayUnifiedOrderV3Result unifiedPartnerOrderV3(TradeTypeEnum tradeType, WxPayPartnerUnifiedOrderV3Request request) throws WxPayException {
     if (StringUtils.isBlank(request.getSpAppid())) {
       request.setSpAppid(this.getConfig().getAppId());
     }
@@ -741,7 +740,7 @@ public WxPayUnifiedOrderV3Result unifiedPartnerOrderV3(PartnerTradeTypeEnum trad
       request.setSubMchId(this.getConfig().getSubMchId());
     }
 
-    String url = this.getPayBaseUrl() + tradeType.getPartnerUrl();
+    String url = this.getPayBaseUrl() + tradeType.getBasePartnerUrl();
     String response = this.postV3(url, GSON.toJson(request));
     return GSON.fromJson(response, WxPayUnifiedOrderV3Result.class);
   }