feat(微信支付): 医保自费混合收款下单

Author: xgl6

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

@@ -0,0 +1,28 @@
+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/MedInsOrdersResult.java

@@ -0,0 +1,43 @@
+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,43 @@
+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,38 @@
+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,40 @@
+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
+
+
+}

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

@@ -0,0 +1,86 @@
+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
+ */
+public enum OrderTypeEnum {
+
+  /**
+   * 未知类型，会被拦截
+   */
+  @SerializedName("UNKNOWN_ORDER_TYPE")
+  UNKNOWN_ORDER_TYPE,
+
+  /**
+   * 挂号支付
+   */
+  @SerializedName("REG_PAY")
+  REG_PAY,
+
+  /**
+   * 诊间支付
+   */
+  @SerializedName("DIAG_PAY")
+  DIAG_PAY,
+
+  /**
+   * 新冠检测费用（核酸）
+   */
+  @SerializedName("COVID_EXAM_PAY")
+  COVID_EXAM_PAY,
+
+  /**
+   * 住院费支付
+   */
+  @SerializedName("IN_HOSP_PAY")
+  IN_HOSP_PAY,
+
+  /**
+   * 药店支付
+   */
+  @SerializedName("PHARMACY_PAY")
+  PHARMACY_PAY,
+
+  /**
+   * 保险费支付
+   */
+  @SerializedName("INSURANCE_PAY")
+  INSURANCE_PAY,
+
+  /**
+   * 互联网医院挂号支付
+   */
+  @SerializedName("INT_REG_PAY")
+  INT_REG_PAY,
+
+  /**
+   * 互联网医院复诊支付
+   */
+  @SerializedName("INT_RE_DIAG_PAY")
+  INT_RE_DIAG_PAY,
+
+  /**
+   * 互联网医院处方支付
+   */
+  @SerializedName("INT_RX_PAY")
+  INT_RX_PAY,
+
+  /**
+   * 新冠抗原检测
+   */
+  @SerializedName("COVID_ANTIGEN_PAY")
+  COVID_ANTIGEN_PAY,
+
+  /**
+   * 药费支付
+   */
+  @SerializedName("MED_PAY")
+  MED_PAY
+}

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

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

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

@@ -0,0 +1,53 @@
+package com.github.binarywang.wxpay.bean.mipay.enums;
+
+import com.google.gson.annotations.SerializedName;
+
+/**
+ * 用户证件类型枚举
+ * <p>
+ * 描述医保自费混合支付中用户的证件类型
+ * @author xgl
+ * @date 2025/12/20
+ */
+public enum UserCardTypeEnum {
+  /**
+   * 未知的用户证件类型
+   */
+  @SerializedName("UNKNOWN_USER_CARD_TYPE")
+  UNKNOWN_USER_CARD_TYPE,
+  /**
+   * 居民身份证
+   */
+  @SerializedName("ID_CARD")
+  ID_CARD,
+  /**
+   * 户口本
+   */
+  @SerializedName("HOUSEHOLD_REGISTRATION")
+  HOUSEHOLD_REGISTRATION,
+  /**
+   * 外国护照
+   */
+  @SerializedName("FOREIGNER_PASSPORT")
+  FOREIGNER_PASSPORT,
+  /**
+   * 台湾居民来往大陆通行证
+   */
+  @SerializedName("MAINLAND_TRAVEL_PERMIT_FOR_TW")
+  MAINLAND_TRAVEL_PERMIT_FOR_TW,
+  /**
+   * 澳门居民来往大陆通行证
+   */
+  @SerializedName("MAINLAND_TRAVEL_PERMIT_FOR_MO")
+  MAINLAND_TRAVEL_PERMIT_FOR_MO,
+  /**
+   * 香港居民来往大陆通行证
+   */
+  @SerializedName("MAINLAND_TRAVEL_PERMIT_FOR_HK")
+  MAINLAND_TRAVEL_PERMIT_FOR_HK,
+  /**
+   * 外国人永久居留身份证
+   */
+  @SerializedName("FOREIGN_PERMANENT_RESIDENT")
+  FOREIGN_PERMANENT_RESIDENT
+}