---
url: "https://pay.weixin.qq.com/doc/v3/merchant/4016781479.md"
title: "使用医保自费混合订单号查看下单结果"
doc_id: 4016781479
---

>更新时间：2025.12.04

商户使用混合下单订单号，通过该接口主动查询订单状态，完成下一步的业务逻辑。




## 接口说明

支持商户：【普通商户】

请求方式：【GET】 `/v3/med-ins/orders/mix-trade-no/{mix_trade_no}`

请求域名：【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

　　　　　【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点，指引[点击查看](https://pay.weixin.qq.com/doc/v3/merchant/4012075113.md)

## 请求参数

### Header 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| Authorization | string | true | 请参考 [签名认证](https://pay.weixin.qq.com/doc/v3/merchant/4012365342.md#%E8%AF%B7%E6%B1%82%E6%8E%A5%E5%8F%A3%E5%90%8E%E7%AB%AF%E7%AD%BE%E5%90%8D) 生成认证信息 |
| Accept | string | true | 请设置为 `application/json` |
### Path 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| mix_trade_no | string(32) | true | 【医保自费混合订单号】 医保自费混合订单号 |
## 应答参数

200 OK

| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| mix_trade_no | string(32) | true | 【医保自费混合订单号】 唯一定义此资源的标识 |
| mix_pay_status | string | true | 【医保自费混合订单支付状态】 医保自费混合订单支付状态<br>可选取值<br><ul><li>`UNKNOWN_MIX_PAY_STATUS`:  未知类型，需报错</li><li>`MIX_PAY_CREATED`:  等待支付</li><li>`MIX_PAY_SUCCESS`:  支付成功</li><li>`MIX_PAY_REFUND`:  自费和医保均已退款</li><li>`MIX_PAY_FAIL`:  支付失败</li></ul> |
| self_pay_status | string | true | 【混合订单中自费部分的支付状态】 混合订单中自费部分的支付状态<br>可选取值<br><ul><li>`UNKNOWN_SELF_PAY_STATUS`:  未知类型，需报错</li><li>`SELF_PAY_CREATED`:  等待支付</li><li>`SELF_PAY_SUCCESS`:  支付成功</li><li>`SELF_PAY_REFUND`:  已退款</li><li>`SELF_PAY_FAIL`:  支付失败</li><li>`NO_SELF_PAY`:  订单不含自费部分</li></ul> |
| med_ins_pay_status | string | true | 【混合订单中医保部分的支付状态】 混合订单中医保部分的支付状态<br>可选取值<br><ul><li>`UNKNOWN_MED_INS_PAY_STATUS`:  未知类型，需报错</li><li>`MED_INS_PAY_CREATED`:  等待支付</li><li>`MED_INS_PAY_SUCCESS`:  支付成功</li><li>`MED_INS_PAY_REFUND`:  已退款</li><li>`MED_INS_PAY_FAIL`:  支付失败</li><li>`NO_MED_INS_PAY`:  订单不含医保部分</li></ul> |
| paid_time | string(64) | false | 【订单支付时间】 遵循rfc3339标准格式，格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE |
| passthrough_response_content | string(2048) | false | 【支付完成后医保局返回内容】 支付完成后医保局返回内容（透传给医疗机构） |
| mix_pay_type | string | true | 【混合支付类型】 混合支付类型<br>可选取值<br><ul><li>`UNKNOWN_MIX_PAY_TYPE`:  未知的混合支付类型，会被拦截。</li><li>`CASH_ONLY`:  只向微信支付下单，没有向医保局下单。包括没有向医保局上传费用明细、预结算。<br>- `med_ins_gov_fee`、 `med_ins_self_fee`、 `med_ins_other_fee`、 `med_ins_cash_fee` 之和一定为0。<br>- `wechat_pay_cash_fee` 一定不为0。<br>- `cash_add_detail` 可以不为0， `cash_add_detail` 可以不为0。</li><li>`med_ins_gov_fee`、 `med_ins_self_fee`、 `med_ins_other_fee`、 `med_ins_cash_fee` 之和一定为0。</li><li>`wechat_pay_cash_fee` 一定不为0。</li><li>`cash_add_detail` 可以不为0， `cash_add_detail` 可以不为0。</li><li>`INSURANCE_ONLY`:  只向医保局下单，没有向微信支付下单。如果医保局分账结果中有自费部份，但由于有减免抵扣，没有向微信支付下单，也是纯医保。<br>- `med_ins_gov_fee`、 `med_ins_self_fee`、 `med_ins_other_fee`、 `med_ins_cash_fee` 之和可以为0。<br>- `wechat_pay_cash_fee` 一定为0。<br>- `cash_add_detail` 可以不为0， `cash_add_detail` 可以不为0。</li><li>`med_ins_gov_fee`、 `med_ins_self_fee`、 `med_ins_other_fee`、 `med_ins_cash_fee` 之和可以为0。</li><li>`wechat_pay_cash_fee` 一定为0。</li><li>`cash_add_detail` 可以不为0， `cash_add_detail` 可以不为0。</li><li>`CASH_AND_INSURANCE`:  向医保局下单，也向微信支付下单。如果医保预结算全部需自费，也属于混合类型。<br>- `med_ins_gov_fee`、 `med_ins_self_fee`、 `med_ins_other_fee`、 `med_ins_cash_fee` 之和一定不为0。<br>- `wechat_pay_cash_fee` 一定不为0。<br>- `cash_add_detail` 可以不为0， `cash_add_detail` 可以不为0。</li><li>`med_ins_gov_fee`、 `med_ins_self_fee`、 `med_ins_other_fee`、 `med_ins_cash_fee` 之和一定不为0。</li><li>`wechat_pay_cash_fee` 一定不为0。</li><li>`cash_add_detail` 可以不为0， `cash_add_detail` 可以不为0。</li></ul> |
| order_type | string | true | 【订单类型】 订单类型<br>可选取值<br><ul><li>`UNKNOWN_ORDER_TYPE`:  未知类型，会被拦截</li><li>`REG_PAY`:  挂号支付</li><li>`DIAG_PAY`:  诊间支付</li><li>`COVID_EXAM_PAY`:  新冠检测费用（核酸）</li><li>`IN_HOSP_PAY`:  住院费支付</li><li>`PHARMACY_PAY`:  药店支付</li><li>`INSURANCE_PAY`:  保险费支付</li><li>`INT_REG_PAY`:  互联网医院挂号支付</li><li>`INT_RE_DIAG_PAY`:  互联网医院复诊支付</li><li>`INT_RX_PAY`:  互联网医院处方支付</li><li>`COVID_ANTIGEN_PAY`:  新冠抗原检测</li><li>`MED_PAY`:  药费支付</li></ul> |
| appid | string(32) | true | 【医疗机构的公众号ID】 医疗机构的公众号ID |
| openid | string(128) | true | 【用户在appid下的唯一标识】 用户在appid下的唯一标识 |
| pay_for_relatives | boolean | false | 【是否代亲属支付】 不传默认替本人支付<br><ul><li>代亲属支付：true</li><li>本人支付：false</li></ul> |
| out_trade_no | string(64) | true | 【商户订单号】 纯自费支付和医保自费混合支付场景均涉及向微信支付下单，商户需要调两次接口：<br><ol><li>商户向微信支付下单获取微信支付凭证，请求中会带上out\_trade\_no。</li><li>下单成功后，商户调用混合下单的接口（即该接口），请求中也会带上out\_trade\_no。</li></ol><br>需要注意：<br><ol><li>1和2请求中的out\_trade\_no应该一致，不要更改。</li></ol><br>多个out\_trade\_no可以对应同一个serial\_no。比如用户第一次下单漏算了快递费，导致实际需要用户微信支付的金额（wechat\_pay\_cash\_fee）填错了。此时需要商户关掉自费单，再重新下单，新订单的out\_trade\_no会变化，但serial\_no不变。 |
| serial_no | string(40) | true | 【医疗机构订单号】 例如医院HIS系统订单号。传与【6201】费用明细上传中medOrgOrd字段一样的值，局端会校验，不一致将会支付失败。<br>多个out\_trade\_no可以对应同一个serial\_no。比如用户第一次下单漏算了快递费，导致实际需要用户微信支付的金额（wechat\_pay\_cash\_fee）填错了。此时需要先取消前一笔订单再重新下单，新订单out\_trade\_no会变化，但serial\_no不变。 |
| pay_order_id | string(64) | false | 【医保局返回的支付单ID】 含医保下单时，医保局返回的支付单ID。<br>纯医保支付或医保自费混合支付时该字段必填，纯自费支付时禁止填写。 |
| pay_auth_no | string(40) | false | 【医保局返回的支付授权码】 含医保下单时，医保局返回的支付授权码。<br>纯医保支付或医保自费混合支付时该字段必填，纯自费支付时禁止填写。 |
| geo_location | string(40) | false | 【用户定位信息】 含医保下单时必填，用户定位信息，经纬度。格式：经度,纬度。<br>纯医保支付或医保自费混合支付时该字段必填，纯自费支付时禁止填写。 |
| city_id | string(8) | true | 【城市ID】 一般为申请接入城市的编码，由腾讯侧对接时提供，部分地区与标准地区编码有差异。<br>详细城市ID可查看 [微信医保移动支付接口文档](https://yb.qq.com/yibao-payment/doc?nodeId=83680041366614016)，附录-统一下单接口城市ID。 |
| med_inst_name | string(128) | true | 【医疗机构名称】 医疗机构名称 |
| med_inst_no | string(32) | true | 【医疗机构编码】 医保局提供的医疗机构编码 |
| med_ins_order_create_time | string(64) | false | 【医保下单时间】 医保下单必填，遵循rfc3339标准格式，格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE。<br>纯医保支付或医保自费混合支付时该字段必填，纯自费支付时禁止填写。 |
| total_fee | integer | true | 【使用该接口下单的总金额】 单位分，使用该接口下单的总金额。<br>订单总金额（total\_fee） = 医保统筹支付金额（med\_ins\_gov\_fee）+ 医保个账支付金额（med\_ins\_self\_fee）+ 医保其他支付金额（med\_ins\_other\_fee） + 需要微信支付的金额（wechat\_pay\_cash\_fee）+ 现金减免金额（cash\_reduce\_detail） |
| med_ins_gov_fee | integer | false | 【医保局结算后，医保统筹支付金额】 单位分，医保局结算后，医保统筹支付金额，结算后金额为0也需要填写。<br>纯医保支付或医保自费混合支付时该字段必填，纯自费支付时禁止填写。 |
| med_ins_self_fee | integer | false | 【医保局结算后，医保个账支付金额】 单位分，医保局结算后，医保个账支付金额，结算后金额为0也需要填写。<br>纯医保支付或医保自费混合支付时该字段必填，纯自费支付时禁止填写。 |
| med_ins_other_fee | integer | false | 【医保局结算后，医保其他支付金额】 单位分，医保局结算后，医保统筹、个账之外的其他津贴支付金额，结算后金额为0也需要填写。<br>纯医保支付或医保自费混合支付时该字段必填，纯自费支付时禁止填写。 |
| med_ins_cash_fee | integer | false | 【医保局结算后，需要自费的金额】 单位分，医保局结算后，需要自费的金额，结算后金额为0也需要填写。<br>纯医保支付或医保自费混合支付时该字段必填，纯自费支付时禁止填写。 |
| wechat_pay_cash_fee | integer | false | 【实际需要用户微信支付的金额】 单位分，实际需要用户微信支付的金额。<br>纯自费支付或医保自费混合支付时必填，纯医保支付时禁止填写。<br>实际需要用户微信支付的金额（wechat\_pay\_cash\_fee）= 医保结算后需要自费的金额（med\_ins\_cash\_fee）+ 现金补充金额（cash\_add\_detail） - 现金减免金额（cash\_reduce\_detail） |
| cash_add_detail | array[object] | false | 【现金补充列表】 有运费等医保订单外加收的费用时必填。在接口说明示例中，该值为快递费20元。 |
| cash_add_detail.cash_add_fee | integer | true | 【现金补充金额】 单位分，现金补充金额 |
| cash_add_detail.cash_add_type | string | true | 【现金补充类型】 现金补充类型<br>可选取值<br><ul><li>`DEFAULT_ADD_TYPE`:  默认显示“机构加收费用”</li><li>`FREIGHT`:  运费</li><li>`OTHER_MEDICAL_EXPENSES`:  其他医疗费用</li></ul> |
| cash_reduce_detail | array[object] | false | 【现金减免列表】 有预交金等医保订单外减免的费用时必填。在接口说明示例中，该值为预存款100元。 |
| cash_reduce_detail.cash_reduce_fee | integer | true | 【现金减免金额】 现金减免金额 |
| cash_reduce_detail.cash_reduce_type | string | true | 【现金减免类型】 现金减免类型<br>可选取值<br><ul><li>`DEFAULT_REDUCE_TYPE`:  默认为“机构优惠金额”</li><li>`HOSPITAL_REDUCE`:  医院减免</li><li>`PHARMACY_DISCOUNT`:  药店优惠</li><li>`DISCOUNT`:  优惠金</li><li>`PRE_PAYMENT`:  预缴金</li><li>`DEPOSIT_DEDUCTION`:  押金抵扣</li></ul> |
| callback_url | string(256) | true | 【回调通知URL】 通知URL必须为直接可访问的URL，不允许携带查询串，要求必须为HTTPS地址。 |
| prepay_id | string(64) | false | 【自费预下单ID】 微信支付预支付交易会话标识。用于后续接口调用中使用，该值有效期为2小时 |
| passthrough_request_content | string(2048) | false | 【医疗机构透传给医保的数据】 沿用地方医保局定义，不包含 `pay_auth_no`、 `pay_ord_id`、 `setl_latlnt` |
| extends | string(512) | false | 【扩展字段】 医疗机构与微信医保约定的扩展字段 |
| attach | string(128) | false | 【附加数据】 查询与通知中返回，医疗机构可用于自定义业务逻辑 |
| channel_no | string(32) | false | 【渠道号】 由腾讯工程师分配的渠道号，给医疗机构使用，标记医保支付渠道信息。 |
| med_ins_test_env | boolean | false | 【是否到医保局测试环境下单】<br><ul><li>true：到医保局测试环境下医保单</li><li>false或不填：到医保局正式环境下医保单</li></ul><br>该字段主要为了方便接入。医疗机构在联调阶段：<br><ol><li>医疗机构可能在微信支付正式环境下自费单。</li><li>医疗机构只能在医保局测试环境下医保单。</li></ol><br>如果此字段为true，即使医疗机构在微信支付正式环境下自费单，仍然到医保局的测试环境下医保单。 |
| med_ins_fail_reason | string(2048) | false | 【医保支付失败原因】 仅在医保支付状态为MED\_INS\_PAY\_FAIL时返回，描述医保支付失败的原因。 |
## 错误码

以下是本接口返回的错误码列表。详细错误码规则，请参考[微信支付接口规则-错误码和错误提示](https://pay.weixin.qq.com/doc/v3/merchant/4012081709.md#%E9%94%99%E8%AF%AF%E7%A0%81%E5%92%8C%E9%94%99%E8%AF%AF%E6%8F%90%E7%A4%BA)

| 状态码 | 错误码 | 描述 | 解决方案 |
| --- | --- | --- | --- |
| 400 | PARAM\_ERROR | 参数错误 | 请根据错误提示正确传入参数 |
| 400 | INVALID\_REQUEST | HTTP 请求不符合微信支付 APIv3 接口规则 | 请参阅 [接口规则](https://pay.weixin.qq.com/doc/v3/merchant/4012081709.md) |
| 401 | SIGN\_ERROR | 验证不通过 | 请参阅 [签名常见问题](https://pay.weixin.qq.com/doc/v3/merchant/4012072670.md) |
| 500 | SYSTEM\_ERROR | 系统异常，请稍后重试 | 请稍后重试 |
| 400 | PARAM\_ERROR | 金额计算出现溢出，请检查填写的金额是否正确。 | 请检查填写的金额是否正确 |
| 403 | RULE\_LIMIT | 请求次数超过限制，请稍后重试。 | 请稍后重试 |
| 404 | NOT\_FOUND | 未找到订单，请确认订单号是否正确。 | 请确认订单号是否正确 |

请求示例

- [curl 示例](https://pay.weixin.qq.com/doc/v3/merchant/4016781479-curl.md)
- [Java 示例](https://pay.weixin.qq.com/doc/v3/merchant/4016781479-java.md)
- [Go 示例](https://pay.weixin.qq.com/doc/v3/merchant/4016781479-go.md)


应答示例

> 200 OK

```
{
  "mix_trade_no" : "1217752501201407033233368318",
  "mix_pay_status" : "MIX_PAY_SUCCESS",
  "self_pay_status" : "SELF_PAY_SUCCESS",
  "med_ins_pay_status" : "MED_INS_PAY_SUCCESS",
  "paid_time" : "2018-06-08T10:34:56+08:00",
  "passthrough_response_content" : "{\"payAuthNo\":\"AUTH530100202204022006310000034\",\"payOrdId\":\"ORD530100202204022006350000021\",\"setlLatlnt\":\"102.682296,25.054260\"}",
  "mix_pay_type" : "CASH_AND_INSURANCE",
  "order_type" : "REG_PAY",
  "appid" : "wxdace645e0bc2cXXX",
  "openid" : "o4GgauInH_RCEdvrrNGrntXDuXXX",
  "pay_for_relatives" : false,
  "out_trade_no" : "202204022005169952975171534816",
  "serial_no" : "1217752501201",
  "pay_order_id" : "ORD530100202204022006350000021",
  "pay_auth_no" : "AUTH530100202204022006310000034",
  "geo_location" : "102.682296,25.054260",
  "city_id" : "530100",
  "med_inst_name" : "北大医院",
  "med_inst_no" : "1217752501201407033233368318",
  "med_ins_order_create_time" : "2015-05-20T13:29:35+08:00",
  "total_fee" : 202000,
  "med_ins_gov_fee" : 100000,
  "med_ins_self_fee" : 45000,
  "med_ins_other_fee" : 5000,
  "med_ins_cash_fee" : 50000,
  "wechat_pay_cash_fee" : 42000,
  "cash_add_detail" : [
    {
      "cash_add_fee" : 2000,
      "cash_add_type" : "FREIGHT"
    }
  ],
  "cash_reduce_detail" : [
    {
      "cash_reduce_fee" : 10000,
      "cash_reduce_type" : "DEFAULT_REDUCE_TYPE"
    }
  ],
  "callback_url" : "https://www.weixin.qq.com/wxpay/pay.php",
  "prepay_id" : "wx201410272009395522657a690389285100",
  "passthrough_request_content" : "{\"payAuthNo\":\"AUTH****\",\"payOrdId\":\"ORD****\",\"setlLatlnt\":\"118.096435,24.485407\"}",
  "extends" : "{}",
  "attach" : "{}",
  "channel_no" : "AAGN9uhZc5EGyRdairKW7Qnu",
  "med_ins_test_env" : false,
  "med_ins_fail_reason" : "订单自费同步流水号与渠道查询交易传入不一致，请调用方确认数据"
}

```
