微信医保支付能力

一、能力背景

传统就医流程中,涉及“三长一短”的难题。与就医不相关的缴费环节,也是造成三长一短的原因。因此根据国家政策及互联网的引导支持,微信推出了“智慧医院”方案,从挂号、缴费、报告等环节,解决线下排队、必须线下办理的问题。

随着微信智慧医院方案覆盖的医院越来越多,根据调研、观察及数据发现,在缴费支付环节,依然有较多用户存在排队等待。

智慧医院线上流程:

微信医保支付能力

三长一短及对应的全流程解决方案:

微信医保支付能力

从解决方案中退出,医保支付结算的通路,也需要打通,才能更便捷的为用户提供服务。因此:

腾讯与人社部门联合开展了“基于微信,进行医保移动支付结算”的能力。用户在微信上绑定社保卡之后,无需在医院窗口排队,即可通过微信缴纳医保挂号或医保门诊费用,优化了传统的就医流程。为用户提供便捷的医保结算就医方式。

传统的医保就医流程,与微信医保支付优化后的就医流程对比如下:

微信医保支付能力

从一定程度上,缓解了医保挂号、医保门诊缴费的排队问题。

二、能力架构

微信医保支付的业务的整体架构,可以类比微信支付,涉及的最基本的模块有三方:社保卡绑卡类比银行卡绑卡,人社局类比银行,医院类比商户。对应的类比架构如下:

微信医保支付能力
在这个类比中,微信医保支付也类似微信支付一样,建立起了开放合作的基础架构。

在人社部门&主管部门的指导、监管下,将医保移动支付结算的接口,封装为相对标准的微信医保支付开放接口,提供给符合监管要求的医疗医药机构。用户在微信中绑定社保卡后在医院/药小程序中,挂号或者门诊缴费时,使用微信医保支付。

对于用户而言:在指定入口绑定社保卡,后续在支持医保支付的医院挂号付费,或前往医疗机构就诊付费,可以通过微信医保支付,在线完成医保结算(医药机构类似),缩短就医路径,减少排队等待的时间。

对于医疗医药机构而言:可以通过微信医保标准的接入接口,申请成为微信医保支付的“商户”,然后在小程序为用户提供便捷的微信医保支付结算。

三、能力覆盖

目前微信医保支付的覆盖城市范围,包括如下城市:

深圳、成都、汕头、郑州、铜川、厦门、广西、嘉兴、宁波,开封,武汉,延安,攀枝花、白城、长沙、哈尔滨、沈阳、潍坊、葫芦岛、西安、宝鸡、咸阳、榆林、渭南、安康、商洛,南京,甘肃全省,合肥,青岛,广州,邯郸,台州,通化、石家庄,长春等省市(持续更新中)

如有开发者或运营者的小程序在以上覆盖城市,则可以沟通对接微信医保支付接口能力。

四、接口权限申请

微信医保支付接口权限,包含但不限于以下3部分内容:

(一)征得当地主管单位的同意,且确保对应医疗机构或医药机构是合规的定点机构;

(二)对应医疗机构或医药机构已开通微信支付权限;

(三)按照以下方式申请接口权限:

1、登录微信公众平台:使用医疗机构公众号登录微信公众平台(mp.weixin.qq.com)(备注:申请开通微信医保支付权限,均需由医疗机构对应公众号提交,如果还没有公众号,请先完成公众号注册及认证。)

2、找到【城市服务】插件:在公众平台左边栏【功能栏】下方,找到【城市服务】插件。未能找到请点击【添加功能插件】。从插件库中选择添加城市服务插件,填写相应信息即可开通。

如果通过以上方式,还未找到城市服务插件,可以通过以下方式申请开通(仅支持公立医院开通):

微信医保支付能力

、接口能力说明

5.1支付场景介绍

微信医保支付除支持小程序外,还支持公众号、扫码付、刷码付等多个支付场景。针对小程序场景,说明如下:

1、医院小程序下单后获得pay_appid与pay_url后,使用这两个参数跳转到医保支付小程序。 跳转的小程序接口参见https://mp.weixin.qq.com/debug/wxadoc/dev/api/navigateToMiniProgram.html

2、参考示例:

微信医保支付能力

3、用户在医保支付小程序完成支付后,会返回调用方的小程序,可在小程序的onShow方法通过scene 等于1038(从另一个小程序返回)时,拿到小程序本身存储的上下文,获得相关订单号,然后先查询医院订单是否已接收到成功通知,如果还没有,则向微信医保支付后台查询支付结果。

5.2接入模式说明

微信医保支付接入,分为两种模式:服务商模式,独立模式。

1、服务商模式

目前接入的大部分都属于服务商模式,即由第三方平台公众号代理医院公众号接入医保支付系统,第三方平台无需代理医院的公众号secret即可进行操作。

医保支付的服务商模式与微信支付的父子商户不相关也不冲突,即不管原来是不是子商户,都可以用服务商模式。

如医院公众号A,第三方平台公众号X,调用API的参数规则如下:

微信医保支付能力

2、独立模式

医院公众号自行接入医保支付系统。如医院公众号为A,其为自行开发的公众号,且自行接入医保支付,调用API的参数规则如下:

微信医保支付能力

5.3业务流程举例说明

1、微信医保支付总业务流程图

微信医保支付能力

2、挂号支付流程图

微信医保支付能力

3、诊间支付流程图

微信医保支付能力

4、订单状态更新流程说明

设定公众号本身有订单信息存储称为本地DB,当公众号收到来自医保支付的后台通知时(即通过notify_url进行通知的支付结果),公众号查询其本地DB,根据通知的数据更新订单的状态。

当未收到通知时,可能通知失败,或者订单支付失败,不管支付成功或失败,用户都会从支付页面跳转到公众号提供的return_url,此时公众号可以在用户跳转的return_url 中,首先查询本地DB看状态是否为成功,不成功则调用医保支付查询API进行查询,获得支付状态并更新公众号本地DB的订单状态。

5.4接口规则

商户接入医保支付,调用API必须遵循以下规则:

传输方式 为保证交易安全性,采用HTTPS传输
提交方式 采用POST方法提交
数据格式 提交和返回数据都为XML格式,根节点名为xml
字符编码 统一采用UTF-8字符编码
签名算法 MD5
签名要求 请求和接收数据均需要校验签名,详细方法请参考,安全规范-签名算法,key说明见后续文档
服务器IP要求 调用申请退款接口需要先提供服务器IP列表
判断逻辑 先判断协议字段返回,再判断业务返回,最后判断交易状态

5.5获取access_token

1、服务商模式获取方式:

https://api.weixin.qq.com/payinsurance/gettoken?grant_type=client_credential&agentappid=AGENT_APPID&agentsecret=AGENT_SECRET&appid=APPID

请求参数:

微信医保支付能力

如服务商appid为A,医院appid为B,服务商appsecret为C,那么请求为:

https://api.weixin.qq.com/payinsurance/gettoken?grant_type=client_credential&agentappid=A&agentsecret=C&appid=B

返回参数:

微信医保支付能力

以下字段在return_code为SUCCESS的时候有返回:

微信医保支付能力

err_code与err_code_des参见https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1433747234

以下字段在return_code 和result_code都为SUCCESS的时候有返回:

微信医保支付能力

2、独立模式获取方式:

与开放平台获取access_token方式相同,参照一下说明: https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1421140183

六、接口文档

详细接口文档,可以点击此处查阅。

七、相关文档

另,除以上主接口文档外,还提供了“选用接口”,以实现查询用户社保卡信息、动态获取社保卡绑卡链接等功能。详见7.3文档。

7.1微信医保支付接口文档之《对接移动医疗平台(医院)接口文档》(更新于2018.10.15)

7.2微信医保支付接口文档之《接入指引文档》(更新于2017.9.15)

7.3微信医保支付接口文档之《选用接口文档》(更新于2018.7.12)

weinxin
我的微信
把最实用的经验,分享给最需要的读者,希望每一位来访的朋友都能有所收获!
avatar

Comment

:?: :razz: :sad: :evil: :!: :smile: :oops: :grin: :eek: :shock: :???: :cool: :lol: :mad: :twisted: :roll: :wink: :idea: :arrow: :neutral: :cry: :mrgreen: