🆕 #3816 【微信支付】增加 V3 医保相关接口的完整支持

Author: xgl6

weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/mipay/MedInsOrdersRequest.java

@@ -0,0 +1,116 @@
+package com.github.binarywang.wxpay.bean.mipay;
+
+import com.google.gson.annotations.SerializedName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+/**
+ * 医保退款通知请求
+ * <p>
+ * 从业机构调用该接口向微信医保后台通知医保订单的退款成功结果
+ * 文档地址：https://pay.weixin.qq.com/doc/v3/partner/4012166534
+ * @author xgl
+ * @date 2025/12/20
+ */
+@Data
+@Builder(builderMethodName = "newBuilder")
+@NoArgsConstructor
+@AllArgsConstructor
+public class MedInsRefundNotifyRequest {
+
+  /**
+   * <pre>
+   * 字段名：医保自费混合订单号
+   * 必填：是
+   * 类型：string(32)
+   * 描述：医保自费混合订单号
+   * </pre>
+   */
+  private String mixTradeNo;
+
+  /**
+   * <pre>
+   * 字段名：医疗机构的商户号
+   * 变量名：sub_mchid
+   * 必填：是
+   * 类型：string(32)
+   * 描述：医疗机构的商户号
+   * </pre>
+   */
+  @SerializedName("sub_mchid")
+  private String subMchid;
+
+  /**
+   * <pre>
+   * 字段名：医保退款的总金额
+   * 变量名：med_refund_total_fee
+   * 必填：是
+   * 类型：integer
+   * 描述：单位分，医保退款的总金额。
+   * </pre>
+   */
+  @SerializedName("med_refund_total_fee")
+  private Integer medRefundTotalFee;
+
+  /**
+   * <pre>
+   * 字段名：医保统筹退款金额
+   * 变量名：med_refund_gov_fee
+   * 必填：是
+   * 类型：integer
+   * 描述：单位分，医保统筹退款金额。
+   * </pre>
+   */
+  @SerializedName("med_refund_gov_fee")
+  private Integer medRefundGovFee;
+
+  /**
+   * <pre>
+   * 字段名：医保个账退款金额
+   * 变量名：med_refund_self_fee
+   * 必填：是
+   * 类型：integer
+   * 描述：单位分，医保个账退款金额。
+   * </pre>
+   */
+  @SerializedName("med_refund_self_fee")
+  private Integer medRefundSelfFee;
+
+  /**
+   * <pre>
+   * 字段名：医保其他退款金额
+   * 变量名：med_refund_other_fee
+   * 必填：是
+   * 类型：integer
+   * 描述：单位分，医保其他退款金额。
+   * </pre>
+   */
+  @SerializedName("med_refund_other_fee")
+  private Integer medRefundOtherFee;
+
+  /**
+   * <pre>
+   * 字段名：医保退款成功时间
+   * 变量名：refund_time
+   * 必填：是
+   * 类型：string(64)
+   * 描述：遵循rfc3339标准格式，格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE。
+   * </pre>
+   */
+  @SerializedName("refund_time")
+  private String refundTime;
+
+  /**
+   * <pre>
+   * 字段名：从业机构\服务商退款单号
+   * 变量名：out_refund_no
+   * 必填：是
+   * 类型：string(64)
+   * 描述：有自费单时，从业机构\服务商应填与自费退款申请处一致的out_refund_no。否则从业机构透传医疗机构退款单号即可。
+   * </pre>
+   */
+  @SerializedName("out_refund_no")
+  private String outRefundNo;
+}

weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/mipay/MedInsOrdersResult.java

@@ -0,0 +1,29 @@
+package com.github.binarywang.wxpay.bean.mipay.enums;
+
+import com.google.gson.annotations.SerializedName;
+
+/**
+ * 现金增加类型枚举
+ * <p>
+ * 描述医保自费混合支付中现金增加的类型
+ *
+ * @author xgl
+ * @date 2025/12/20
+ */
+public enum CashAddTypeEnum {
+  /**
+   * 默认增加类型
+   */
+  @SerializedName("DEFAULT_ADD_TYPE")
+  DEFAULT_ADD_TYPE,
+  /**
+   * 运费
+   */
+  @SerializedName("FREIGHT")
+  FREIGHT,
+  /**
+   * 其他医疗费用
+   */
+  @SerializedName("OTHER_MEDICAL_EXPENSES")
+  OTHER_MEDICAL_EXPENSES
+}

weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/mipay/MedInsRefundNotifyRequest.java

@@ -0,0 +1,44 @@
+package com.github.binarywang.wxpay.bean.mipay.enums;
+
+import com.google.gson.annotations.SerializedName;
+
+/**
+ * 现金减少类型枚举
+ * <p>
+ * 描述医保自费混合支付中现金减少的类型
+ *
+ * @author xgl
+ * @date 2025/12/20
+ */
+public enum CashReduceTypeEnum {
+  /**
+   * 默认减少类型
+   */
+  @SerializedName("DEFAULT_REDUCE_TYPE")
+  DEFAULT_REDUCE_TYPE,
+  /**
+   * 医院减免
+   */
+  @SerializedName("HOSPITAL_REDUCE")
+  HOSPITAL_REDUCE,
+  /**
+   * 药店折扣
+   */
+  @SerializedName("PHARMACY_DISCOUNT")
+  PHARMACY_DISCOUNT,
+  /**
+   * 折扣优惠
+   */
+  @SerializedName("DISCOUNT")
+  DISCOUNT,
+  /**
+   * 预付费抵扣
+   */
+  @SerializedName("PRE_PAYMENT")
+  PRE_PAYMENT,
+  /**
+   * 押金扣除
+   */
+  @SerializedName("DEPOSIT_DEDUCTION")
+  DEPOSIT_DEDUCTION
+}

weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/mipay/enums/CashAddTypeEnum.java

@@ -0,0 +1,44 @@
+package com.github.binarywang.wxpay.bean.mipay.enums;
+
+import com.google.gson.annotations.SerializedName;
+
+/**
+ * 医保支付状态枚举
+ * <p>
+ * 描述医保自费混合支付中医保部分的支付状态
+ *
+ * @author xgl
+ * @date 2025/12/20
+ */
+public enum MedInsPayStatusEnum {
+  /**
+   * 未知的医保支付状态
+   */
+  @SerializedName("UNKNOWN_MED_INS_PAY_STATUS")
+  UNKNOWN_MED_INS_PAY_STATUS,
+  /**
+   * 医保支付已创建
+   */
+  @SerializedName("MED_INS_PAY_CREATED")
+  MED_INS_PAY_CREATED,
+  /**
+   * 医保支付成功
+   */
+  @SerializedName("MED_INS_PAY_SUCCESS")
+  MED_INS_PAY_SUCCESS,
+  /**
+   * 医保支付已退款
+   */
+  @SerializedName("MED_INS_PAY_REFUND")
+  MED_INS_PAY_REFUND,
+  /**
+   * 医保支付失败
+   */
+  @SerializedName("MED_INS_PAY_FAIL")
+  MED_INS_PAY_FAIL,
+  /**
+   * 无需医保支付
+   */
+  @SerializedName("NO_MED_INS_PAY")
+  NO_MED_INS_PAY
+}

weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/mipay/enums/CashReduceTypeEnum.java

@@ -0,0 +1,39 @@
+package com.github.binarywang.wxpay.bean.mipay.enums;
+
+import com.google.gson.annotations.SerializedName;
+
+/**
+ * 混合支付状态枚举
+ * <p>
+ * 描述医保自费混合支付的整体状态
+ *
+ * @author xgl
+ * @date 2025/12/20
+ */
+public enum MixPayStatusEnum {
+  /**
+   * 未知的混合支付状态
+   */
+  @SerializedName("UNKNOWN_MIX_PAY_STATUS")
+  UNKNOWN_MIX_PAY_STATUS,
+  /**
+   * 混合支付已创建
+   */
+  @SerializedName("MIX_PAY_CREATED")
+  MIX_PAY_CREATED,
+  /**
+   * 混合支付成功
+   */
+  @SerializedName("MIX_PAY_SUCCESS")
+  MIX_PAY_SUCCESS,
+  /**
+   * 混合支付已退款
+   */
+  @SerializedName("MIX_PAY_REFUND")
+  MIX_PAY_REFUND,
+  /**
+   * 混合支付失败
+   */
+  @SerializedName("MIX_PAY_FAIL")
+  MIX_PAY_FAIL
+}

weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/mipay/enums/MedInsPayStatusEnum.java

@@ -0,0 +1,41 @@
+package com.github.binarywang.wxpay.bean.mipay.enums;
+
+import com.google.gson.annotations.SerializedName;
+
+/**
+ * 混合支付类型枚举
+ * <p>
+ * 描述医保自费混合支付的类型
+ * 文档地址：https://pay.weixin.qq.com/doc/v3/partner/4012503131
+ *
+ * @author xgl
+ * @date 2025/12/20 09:21
+ */
+public enum MixPayTypeEnum {
+
+  /**
+   * 未知的混合支付类型，会被拦截。
+   */
+  @SerializedName("UNKNOWN_MIX_PAY_TYPE")
+  UNKNOWN_MIX_PAY_TYPE,
+
+  /**
+   * 只向微信支付下单，没有向医保局下单。包括没有向医保局上传费用明细、预结算。
+   */
+  @SerializedName("CASH_ONLY")
+  CASH_ONLY,
+
+  /**
+   * 只向医保局下单，没有向微信支付下单。如果医保局分账结果中有自费部份，但由于有减免抵扣，没有向微信支付下单，也是纯医保。
+   */
+  @SerializedName("INSURANCE_ONLY")
+  INSURANCE_ONLY,
+
+  /**
+   * 向医保局下单，也向微信支付下单。如果医保预结算全部需自费，也属于混合类型。
+   */
+  @SerializedName("CASH_AND_INSURANCE")
+  CASH_AND_INSURANCE
+
+
+}