定点医药机构对接 医保业务综合服务终端 接口规范
[√]草稿 文件状态: 报告编号: 当前版本:[]正式发布 编写人: 编写日期[]正在修改 审批人: 审批日期保密级别: 保密
目录
引言...1.1 目的1.2 1.3术语说明 文档阅读对象1.4安全机制2 业务流程2.1刷脸获取医保用户身份信息流程,2.2终端医保移动支付流程 2.2.1 刷脸识别医保用户身份方式2.2.2 扫码识别医保用户身份方式 5接口规则3.2格式规定 协议规则3.2.1 日期时间格式,3.2.2 交易金额格式约定,3.2.3 报文格式约定... 定点医药机构业务流水号约定动态库调用方法 3.2.44.1动态库:NationECCode.dll4.2交易接口调用函数 85.1刷脸获取医保用户身份授权接口5.1.1 接口描述.5.1.2 交易类型编码 65.1.3 出入参说明, 65.2结算结果通知接口 5.2.1 接口描述. 10 105.2.2 交易类型编码 105.2.3 出入参说明 105.3获取医保用户身份信息接口 接口描述. 115.3.1 5.3.2 出入参说明 11 115.4获取终端支付令牌接口 125.4.1 接口描述. 125.5终端医保电子凭证码解码接口 5.4.2 出入参说明 12 125.5.1 接口描述 125.5.2出入参说明 125.6终端医保移动支付接口 125.6.1 5.6.2 接口描述 交易类型编码. 12 12
5接口定义1 /19
5.6.3出入参说明 125.7费用上传接口 135.7.1接口描述.. 5.7.2出入参说明 135.8查询订单结算状态接口 13 135.8.1 接口描述. 135.8.2 出入参说明 135.9支付结果推送接口 5.9.1接口描述. 14 145.9.2 出入参说明 145.10撤销费用明细上传 145.10.1接口描述. 145.11医保退费接口 5.10.2出入参说明 14 145.11.1接口描述.. 145.11.2出入参说明 14附录A..... A.1代码标识说明 15 15A.2证件类型代码表 15A.3返回值代码表 16A.4订单状态编码(ordStas) 18A.5统筹区编码(id_poolarea) 81
1.1目的
本文档主要表述了定点医药机构接入医保业务综合服务终端(以下简称为终端)涉及的业务流程以及接口出入参等内容.编写该文档的目的在于对医保业务综合服务终端的接口方案进行详细的说明,使接口开发人员能够深刻理解接口方案.
1.2文档阅读对象
本文档的读者为定点医药机构的系统承建商的软件开发人员、软件设计人员、软件实施人员、测试人员以及与该项目相关的其他人员等.
1.3术语说明
术语 说明医保业务综合服务终端(以下简称终端)通过专线或者VPDN的方式接入医保核心业务区网医保业务综合服务终端 络.终端采用二维码、身份证及人脸识别技术进行身份核验,基于模块化的各类SDK及终 端业务中间件,提供基于医保电子凭证和医保支付结算等相关业务的办理功能.为了保障设备本身、应用及SDK的安全,要求设备提供基于密码技术的安全加固功能.同时,终端设备需接受国家及当地医保部门的监控管理.定点医药机构 医保定点医院和医保定点药店.
1.4安全机制
两定机构与动态库为明文交互,动态库内置安全认证机制,两定机构通过调用动态库接发起业务请求,动态 库将传入的业务请求入参进行标准国密加密后,以密文形式进行串口通讯传输给医保综合服务终端,医保综合服务终端收到请求后,用对应密钥进行请求解密,以验证请求方的合法性和安全性,验证通过后进行终端业务交易,以确保本地请求安全.
2. 1 刷脸获取医保用户身份信息流程
刷脸获取医保用户身份信息时序图