开发前准备

更新时间:2026.05.14
||

1、授权、预结算接口接入

1.1 用户授权接入(医保信息授权)——必需

用户授权接入文档见链接:用户授权接入文档

1.2 医保预结算接口对接——必需

各省市接口存在差异,请联系医保中台完成对接

1.3 模板消息接口文档接入——如需

2、联调测试环境准备

2.1 电子凭证测试环境参保人准备——必需

当测试环境联调通过后,方可进入生产环境调试。因此为确保测试流程顺利进行,医院测试人员需先在电子凭证测试环境中配置对应的参保人信息。

若当前环境中暂无相应参保信息,可整理以下所需测试人员信息,提交给微信联调人员或对应省份中台工作人员。如果各省份城市有对应的工作群,也可直接在群内提交,由地市医保/中台负责人统一上报至省级处理。

【电子凭证测试环境信息模板】

  • 姓名:

  • 证件号码:

  • 证件类型:01(身份证)

  • 参保地代码:

  • 参保地名称:

2.2 微信测试环境测试人员准备——必需

在微信测试环境中进行电子凭证激活与医保移动支付前,需完成以下操作:测试人员请先解绑微信正式环境中的电子凭证,随后将个人信息按以下模板提交给微信联调人员,以便添加至测试环境。完成添加后,方可在微信测试环境中使用。若后续需恢复正式环境使用,请联系微信联调人员解除测试环境配置。

提交信息模板:​

  • 姓名:

  • 身份证:

  • 手机号:

  • 微信号:

2.3 授权小程序体验者权限添加——必需

为在测试环境中调试医保移动支付授权流程,若医院通过微信小程序接入,需将体验者微信号提交给微信联调人员。添加后,该体验者可打开授权小程序的联调环境进行测试。体验者权限在医院的微信小程序正式上线医保移动支付后,定时进行删除。

【授权小程序体验者权限添加模板】

  • 微信号:

  • 调试医院:

注意

若通过微信小程序的提示页直接申请体验者权限,请在申请时务必填写清楚所调试的医院名称,便于确认添加。

3、其它重要事项

3.1 设置安全联系人

微信支付日常安全监测发现技术异常时,会向安全联系人和超级管理员发送风险提醒。请商户超级管理员尽快设置技术同事为安全联系人,确保能及时接收异常信息评估业务风险,详见安全联系人设置指引

3.2 熟悉微信支付接口规则

正式进入开发前,开发者需要先阅读基本规则mchid与appid申请了解调用微信支付接口的基本规则和签名规则。

3.3 准备开发参数

在发起接口请求时,开发者还需传入一些必要参数,如服务商商户号、子商户号(也叫特约商户号)、sp_appid、证书私钥、公钥等,获取方式详见:开发必要参数说明

注意

在开发的过程中,请将应答的HTTP头Request-ID值打印到日志中。Request-ID作为请求的唯一标识,在调用接口遇到问题时,可向微信侧提供该值用于快速定位到请求记录,协助排查问题原因。