feat: 添加小程序微信虚拟支付退款通知事件(xpay_refund_notify)相关字段

Co-authored-by: binarywang <1343140+binarywang@users.noreply.github.com>

Author: Copilot

weixin-java-miniapp/src/main/java/cn/binarywang/wx/miniapp/bean/WxMaMessage.java

@@ -1,5 +1,6 @@
 package cn.binarywang.wx.miniapp.bean;
 
+import cn.binarywang.wx.miniapp.bean.xpay.WxMaXPayTeamInfo;
 import cn.binarywang.wx.miniapp.config.WxMaConfig;
 import cn.binarywang.wx.miniapp.util.crypt.WxMaCryptUtils;
 import cn.binarywang.wx.miniapp.json.WxMaGsonBuilder;
@@ -313,6 +314,110 @@ public class WxMaMessage implements Serializable {
   @XStreamAlias("settlement_time")
   private Long settlementTime;
 
+  // xpay_refund_notify 退款推送字段
+
+  /**
+   * 微信退款单号.
+   * xpay_refund_notify
+   */
+  @SerializedName("WxRefundId")
+  @XStreamAlias("WxRefundId")
+  @XStreamConverter(value = XStreamCDataConverter.class)
+  private String wxRefundId;
+
+  /**
+   * 商户退款单号.
+   * xpay_refund_notify
+   */
+  @SerializedName("MchRefundId")
+  @XStreamAlias("MchRefundId")
+  @XStreamConverter(value = XStreamCDataConverter.class)
+  private String mchRefundId;
+
+  /**
+   * 退款单对应支付单的微信单号.
+   * xpay_refund_notify
+   */
+  @SerializedName("WxOrderId")
+  @XStreamAlias("WxOrderId")
+  @XStreamConverter(value = XStreamCDataConverter.class)
+  private String wxOrderId;
+
+  /**
+   * 退款单对应支付单的商户单号.
+   * xpay_refund_notify
+   */
+  @SerializedName("MchOrderId")
+  @XStreamAlias("MchOrderId")
+  @XStreamConverter(value = XStreamCDataConverter.class)
+  private String mchOrderId;
+
+  /**
+   * 退款金额，单位分.
+   * xpay_refund_notify
+   */
+  @SerializedName("RefundFee")
+  @XStreamAlias("RefundFee")
+  private Integer refundFee;
+
+  /**
+   * 退款结果，0为成功，非0为失败.
+   * xpay_refund_notify
+   */
+  @SerializedName("RetCode")
+  @XStreamAlias("RetCode")
+  private Integer retCode;
+
+  /**
+   * 退款结果详情，失败时为退款失败的原因.
+   * xpay_refund_notify
+   */
+  @SerializedName("RetMsg")
+  @XStreamAlias("RetMsg")
+  @XStreamConverter(value = XStreamCDataConverter.class)
+  private String retMsg;
+
+  /**
+   * 开始退款时间，秒级时间戳.
+   * xpay_refund_notify
+   */
+  @SerializedName("RefundStartTimestamp")
+  @XStreamAlias("RefundStartTimestamp")
+  private Long refundStartTimestamp;
+
+  /**
+   * 结束退款时间，秒级时间戳.
+   * xpay_refund_notify
+   */
+  @SerializedName("RefundSuccTimestamp")
+  @XStreamAlias("RefundSuccTimestamp")
+  private Long refundSuccTimestamp;
+
+  /**
+   * 退款单的微信支付单号.
+   * xpay_refund_notify
+   */
+  @SerializedName("WxpayRefundTransactionId")
+  @XStreamAlias("WxpayRefundTransactionId")
+  @XStreamConverter(value = XStreamCDataConverter.class)
+  private String wxpayRefundTransactionId;
+
+  /**
+   * 重试次数，从0开始，重试间隔为2 4 8 16...最多15次.
+   * xpay_refund_notify
+   */
+  @SerializedName("RetryTimes")
+  @XStreamAlias("RetryTimes")
+  private Integer retryTimes;
+
+  /**
+   * 拼团信息.
+   * xpay_goods_deliver_notify, xpay_refund_notify
+   */
+  @SerializedName("TeamInfo")
+  @XStreamAlias("TeamInfo")
+  private WxMaXPayTeamInfo teamInfo;
+
   /**
    * 不要直接使用这个字段，
    * 这个字段只是为了适配 SubscribeMsgPopupEvent SubscribeMsgChangeEvent SubscribeMsgSentEvent

weixin-java-miniapp/src/main/java/cn/binarywang/wx/miniapp/bean/xpay/WxMaXPayTeamInfo.java

@@ -0,0 +1,48 @@
+package cn.binarywang.wx.miniapp.bean.xpay;
+
+import com.google.gson.annotations.SerializedName;
+import com.thoughtworks.xstream.annotations.XStreamAlias;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.io.Serializable;
+
+/**
+ * 虚拟支付拼团信息.
+ * 用于 xpay_goods_deliver_notify、xpay_refund_notify 等推送事件
+ */
+@Data
+@NoArgsConstructor
+@XStreamAlias("TeamInfo")
+public class WxMaXPayTeamInfo implements Serializable {
+  private static final long serialVersionUID = 1L;
+
+  /**
+   * 活动id.
+   */
+  @SerializedName("ActivityId")
+  @XStreamAlias("ActivityId")
+  private String activityId;
+
+  /**
+   * 团id.
+   */
+  @SerializedName("TeamId")
+  @XStreamAlias("TeamId")
+  private String teamId;
+
+  /**
+   * 团类型.
+   * 1-支付全部，拼成退款
+   */
+  @SerializedName("TeamType")
+  @XStreamAlias("TeamType")
+  private Integer teamType;
+
+  /**
+   * 0-创团 1-参团.
+   */
+  @SerializedName("TeamAction")
+  @XStreamAlias("TeamAction")
+  private Integer teamAction;
+}

weixin-java-miniapp/src/main/java/cn/binarywang/wx/miniapp/constant/WxMaConstants.java

@@ -263,6 +263,7 @@ public static final class XPayOrderStatus {
   public static final class XPayNotifyEvent {
     public static String COIN_PAY = "xpay_coin_pay_notify";
     public static String GOODS_DELIVER = "xpay_goods_deliver_notify";
+    public static String REFUND = "xpay_refund_notify";
 
   }
   @UtilityClass