开发接入准备

更新时间:2026.07.22
||

1、接入流程

2、步骤说明

2.1 权限申请

权限申请分为【申请国家局机构测试环境接入】和【微信医保一码付接入立项】两部分,详细指引见申请一码付权限

2.2 接口对接

2.2.1 医院信息系统(HIS)需与省级医保中台完成2个接口的对接改造。

2.2.2 医院端对自费下单功能做适配(自费下单接口保持原有逻辑)。

  • 微信直连商户场景下,调用微信付款码支付接口。

  • 微信间连商户场景下,调用收单机构支持的微信付款码支付接口。

2.3 测试

2.3.1 向微信侧提供用于测试的医保用户账号/信息。

2.3.2 医院使用国家局下发的测试参数,模拟完整业务流程进行测试。

  • 测试环境流程验证通过后,医院录制全流程操作视频。

  • 将录屏文件提交至省级医保部门,再由省局提交国家医保局审核。

  • 国家医保局完成审核并确认通过。

  • 国国家医保局下发正式环境所需的接入参数。

2.2.3 微信侧解除测试用户的测试权限。

  • 医院向微信侧提供之前的全流程测试录屏(用于核验)。

2.2.4 医院使用国家局下发的正式生产参数,再次模拟全流程业务验证。

2.4 正式上线

验证通过后,正式在生产环境(真实业务环境)启用“微信医保码一码付”功能。

3、分工说明

配合方

涉及工作

地方电子凭证中台

1. 向国家医保局申请医保一码付开通需求;

2. 向国家医保局申请医院密钥,为定点医院下发密钥,开通相关权限;

3. 与定点机构联调相关接口(查询一码付签约状态、获取一码付付款凭据);

4. 与微信侧调试微信医保一码付相关接口。

微信

1. 为用户提供微信医保码一码付签约解约服务;

2. 为医院提供自费支付服务;

3. 与医保电子凭证中台调试微信医保一码付相关接口。

定点机构(未对接过一码付)

1. 向医保局申请微信医保码一码付接入;

2. 向微信申请接入一码付立项;

3. 对接电子凭证中台相关接口(查询一码付签约状态、获取一码付付款凭据)

4. 对接微信渠道的自费支付服务。

定点机构(对接过其余渠道一码付)

1. 向医保局申请微信医保码一码付接入;

2. 向微信申请接入一码付立项;

3. 电子凭证中台接口复用(无需改造)

4. 对接微信渠道的自费支付服务。

4、其他参数准备

获取微信支付通用开发参数详见开发必要参数说明

注意:

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