常见问题
更新时间：2026.05.11一、新老接口切换
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：需要调用两次：
先调用自费下单接口（JSAPI/小程序统一下单），获取
prepay_id；再调用医保自费混合收款下单接口，传入
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：可按如下方式处理：
自费退款：服务商调用微信支付申请退款接口发起；
医保退款：从业机构/医疗机构向医保局发起冲正（退费），冲正成功后调用医保退款通知接口（ 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 秒内会有最终结果。如超时仍为结算中，可等待补偿后再次查单。
