---
url: "https://pay.weixin.qq.com/doc/v3/merchant/4017415831.md"
title: "业务&接口规则类问题"
doc_id: 4017415831
---

>更新时间：2026.05.14

## 一、新老接口切换

### Q：新接口和旧接口有什么区别

A：新接口在性能上有较大提升，如支持鸿蒙支付，且支持直连、间连两种模式接入。目前产品能力仍在持续迭代中。

### Q：切换新接口会影响旧接口的正常使用吗？

A：不会。新接口和旧接口是两套独立的接口，互不影响。切换时机由服务商/商户自己控制，完成新接口调试后即可切换。

### Q：公众号 H5 和小程序走的接口一样吗？

A：是的，无论 H5 还是小程序，都是调同一套接口。

## 二、权限申请

### Q：接入微信移动医保支付新接口需要申请哪些权限？

A：详情见产品文档「权限申请」，内有详细指引。若为首次接入微信移动医保支付，注意不要遗漏立项流程。

### Q：历史未接入过老接口的移动医保支付，接入新接口可以通过邮件申请权限吗？

A：不可以。自 2026 年 4 月 8 日起，新增商户（历史未接入过微信医保移动支付）的权限申请已切换为线上申请流程，原邮件申请流程停止使用。仅存量已接入的商户权限申请（如迁移、接口切换）可使用原邮件流程。

### Q：医院商户是直连服务商/间连模式下的子商户号，能走独立模式接入吗？

A：可以。按照独立模式产品文档指引和开发对接即可。

### Q：申请新接口权限提交的医保审批证明截图，只需要市医保审批通过就可以吗？

A：是的，市医保审批通过即可申请，不需要等国家层级审批完成。

### Q：服务商模式/间连模式下，新增商户权限的申请涉及医院超管登录授权，不知道超管是谁，或者超管离职了该怎么办？

A：联系对接运营处理。

### Q：服务商模式/间连模式下，新增商户权限的申请涉及医院超管登录授权，发起邀请后医院更换了超管或者超管没收到邀请提醒怎么办？

A：联系对接运营处理。

### Q：服务商/间连模式下，线上申请需要子商户超管操作，医院超管不配合怎么办？

A：从合规角度，接入移动医保支付必须获得子商户授权，这一步无法省略，服务商无法代替子商户提交。

### Q：商户收付款功能受限（如提现受限），是否影响医保支付权限申请？

A：权限申请本身不受影响，但建议同步处理风险记录，因为如果影响到支付收款/退款功能则会影响实际交易。

### Q：appid和商户号没有绑定关系，怎么操作？

A：联系对接运营处理。

### Q：区域平台（如卫健委）下有很多基卫机构，批量申请权限怎么操作？

A：将卫健委 appid 绑定各医院的商户号，申请表格中子商户的 appid 填卫健委 appid，其他字段正常填写即可批量申请。

### Q：若报名移动医保支付接入激励政策，物料（易拉宝、海报等）什么时候申请？

A：物料制作周期较长，尽早申请，避免等待物料耽误上线。

### Q：APPID 可以绑定多少个商户号？

A：APPID 可绑定多个商户号，暂无上限。商户号维度：纯直连商户绑定 APPID 上限 50 个，特约商户上限 10 个。

## 三、测试环境控制

### Q：新接口如何区分测试环境和正式环境？是否需要发邮件申请？

A：新接口中，微信侧接口不区分正式环境和测试环境，亦无联调环节，下单时，服务商/商户通过下单参数 `med_ins_test_env` 字段控制：

- `med_ins_test_env=true`：走测试环境（医保局测试）

- `med_ins_test_env=false` 或不传：走正式环境


注意：授权和下单必须保持环境一致，测试授权对应测试下单，正式授权对应正式下单，否则会报错「未找到对应授权信息」。

## 四、下单接口

### Q：医保+自费混合支付需要调用几次下单接口？

A：需要调用两次：

1. 先调用自费下单接口（JSAPI/小程序统一下单），获取 `prepay_id`；

2. 再调用医保自费混合收款下单接口，传入 `prepay_id` \+ `pay_auth_no` \+ `pay_order_id`， `mix_pay_type` 填 `CASH_AND_INSURANCE`。


两次请求的 `out_trade_no` 必须保持一致。

### Q：纯自费场景需要调用医保接口吗？

A：不需要。纯自费场景直接走基础支付（JSAPI/小程序下单），查询和退款也调用基础支付接口，无需调用医保相关接口。

### Q：prepay\_id 从哪个接口获取？

A：通过微信支付基础支付的统一下单接口获取（JSAPI、小程序、APP 均可），支持 V2 和 V3 接口。

### Q：纯医保支付如何调起支付？不调用自费下单接口时怎么构造支付控件参数？

A：纯医保支付（ `mix_pay_type=INSURANCE_ONLY`）不需要调用自费下单接口，也不需要 `prepay_id`。只需调用医保自费混合收款下单接口，返回 `mix_trade_no` 等参数后，直接用 `mix_trade_no` 拉起医保支付控件。自费相关字段（ `wechat_pay_cash_fee`、 `prepay_id`）不填。

### Q：纯自费订单可以走医保混合收款下单接口吗？

A：可以。 `mix_pay_type` 设置为 `CASH_ONLY` 即可走纯自费路径，也可以直接用原来的基础支付流程。

### Q：openid 和 sub\_openid 怎么传？

A： `openid` 对应 `appid`， `sub_openid` 对应 `sub_appid`。如果传 `openid` 就必须从 `appid` 对应的公众号/小程序获取；如果传 `sub_openid` 就必须从 `sub_appid` 获取。不能混用。

### Q：普通商户（非服务商模式）怎么传参？需要传 sub 字段吗？

A：普通商户不传 sub 字段（ `sub_mchid`、 `sub_appid`、 `sub_openid`），下单和查询都只传单号即可。

### Q：代亲属支付时 payer 节点传谁的信息？

A：传当前绑卡人（付款人）的信息。即张三用自己的医保为亲属李四支付，payer 传张三的信息。

### Q：新接口支持港澳台通行证/回乡证吗？

A：暂不支持，迭代中。仅支持身份证（card\_type: ID\_CARD）。

### Q：下单时，只需要在医保自费混合收款下单接口传 callback\_url，自费下单的 callback\_url 也需要填吗？

A：有自费的情况下，两个通知都会发，两个 `callback_url` 都需要填写，都要监听。混合支付成功后，自费通知和医保自费混合通知各发一次，两个通知都需要处理。

### Q：下单请求中是否可以有空字段？

A：不可以。请求体中不能包含空字段，如果某字段没有值请直接去掉该字段，不要传空字符串或 null。

### Q：sub\_mchid 和 sub\_appid 不绑定会影响什么？

A：医保混合下单接口会校验 `sub_mchid` 与 `sub_appid` 的绑定关系。不绑定可能导致下单报错。建议提前在商户平台完成绑定。

### Q：服务商模式中，签名证书用服务商的还是子商户的？

A：服务商模式统一使用服务商的 API 证书，独立商户使用各自独立商户的 API 证书。

## 五、拉起收银台

### Q：收银台对微信版本有什么要求？

A：拉起医保支付收银台，对不同平台的微信客户端版本有最低要求：

- Android：微信 ≥ 8.0.44

- iOS：微信 ≥ 8.0.44

- 鸿蒙：微信 ≥ 8.0.13


低于以上版本用户无法拉起医保支付收银台，建议商户前端提示用户升级微信。

### Q：收银台订单有有效期吗？

A：没有单独的有效期限制，取决于自费单和医保单各自的有效期。推荐商户做超时主动关单处理。

### Q：新医保的接口支持小程序和公众号拉起支付结算吗

A：支持，医保支付拉起支付是这两个接口”JSAPI调起医保自费混合支付“和”小程序调起医保自费混合支付“。

## 六、支付结果与回调

### Q：医保混合支付有几个支付结果通知？以哪个为准判断支付完成？

A：在有自费的情况下有两个通知：自费支付成功通知和医保自费混合收款成功通知。以医保混合的通知和查询为准做 HIS 结算，不能只看自费通知。

### Q：查单时应用哪个接口？

A：优先使用医保自费混合订单号（ `mix_trade_no`）查单，如果没有 `mix_trade_no` 再用商户订单号。不能直接查医保局接口，混合单结果必须查微信混合单查询接口，否则可能导致资损。

### Q：医保混合收款成功通知里没有 transaction\_id，怎么拿到 transaction\_id？

A：这是正常现象。医保混合收款成功通知接口本身不包含 `transaction_id`。如需获取，可通过基础支付查询订单接口或自费支付结果通知来拿到 `transaction_id`。

### Q：医保结算成功但收不到混合通知怎么办？

A：如果长时间收不到通知，建议主动调用查单接口确认订单状态，不要仅依赖通知。

### Q：应该以微信支付还是医保局的状态为准？

A：以微信支付的医保混合查单接口返回的状态为准，医保局状态不一定是最终态。不要直接调医保局接口判断支付结果。

### Q：混合支付会收到几次回调通知？以哪次为准？

A：会收到两次回调通知。第一次是自费支付成功后，微信支付发到自费下单时传的 notify\_url；第二次是医保结算完成后，发到混合单下单时传的 notify\_url。以第二次混合单回调中的 mix\_pay\_status = MIX\_PAY\_SUCCESS 作为整笔订单最终成功的依据，不要仅凭第一次自费回调判断订单完成。

## 七、对账

### Q：新接口（V3）如何对账？

A：自费部分和医保部分需分开对账。自费部分在微信支付服务商平台（服务商模式）或商户平台（直连模式）下载交易账单，也可调用微信支付V3「申请交易账单」接口获取。医保部分在医保局侧下载医保结算账单，微信支付侧不提供医保部分的对账文件，医保结算明细以医保局为准。

## 八、退款

### Q：退款时，自费退款和医保退款分别怎么处理？

A：可按如下方式处理：

- 自费退款：服务商调用微信支付申请退款接口发起；

- 医保退款：从业机构/医疗机构向医保局发起冲正（退费），冲正成功后调用医保退款通知接口（ ⁠POST /v3/med-ins/refunds/notify⁠ ）将医保退款结果同步给微信支付，完成退款闭环。


两者独立处理，互不干扰。医保退款通知接口不需要等自费退款完成才调用。

### Q：如果自费金额为 0（纯医保或减免后为 0），退款时还需要调用自费退款接口吗？

A：不需要。没有自费部分，不调用自费退款接口。纯医保订单直接在医保局侧退款，退款成功后再调用医保退款通知接口通知微信支付即可。

### Q：混合支付 MIX\_PAY\_FAIL 的单子，自费现金部分会自动退回吗？自费支付成功、医保支付失败，自费部分微信侧会自动冲正吗？

A：新接口不会。需要服务商或商户主动调用自费退款接口发起退款。

### Q：纯医保订单也需要发退款通知吗？

A：是的。有医保结算的订单退款时都需要发退款通知。纯现金（无医保）的不需要。

## 九、冲正与异常

### Q：冲正机制能关闭吗？

A：不可以。

### Q：自费成功、医保显示已结算，但后来触发冲正，怎么处理？

A：这是因为未按正确方式判断支付结果导致的。正确做法是调用微信支付的医保混合查单接口确认最终状态，不能仅凭自费通知 \+ 医保局查询就进行 HIS 结算。

### Q：医保结算中的订单怎么处理？

A：系统有 MQ 补偿查单机制，一般 30 秒内会有最终结果。如超时仍为结算中，可等待补偿后再次查单。