Neusoft
医保电子凭证扫码支付 接口规范
东软集团股份有限公司
Neusoft
目录
、接口通用说明.. 1.1接口实现方式 .3 .31.1.1数字安全.. .31.1.4交易列表... .41.1.3报文参数说明. 1.1.5报文样例.. .. .4二、各种场景下接口交易的使用说明2.1一次扫码支付与两次扫码支付. ..2.3住院场景. 2.2门诊场景. ..8三、接口交易说明.. ...1.0 ...3.1基础服务类.. ..103.1.1 签到. ..103.1.2签退. 3.1.3扫码身份识别3.2扫码支付服务类.. ...13 113.2.1被扫支付. ..133.2.2查询支付状态 3.2.3预生成支付订单 ..143.2.4验码支付. ..15 ..163.2.5 扫码退费.. ..173.2.6扫码入院（就诊）登记 ..183.3辅助服务类.. 3.2.7扫码无费退院. ..20 203.3.1交易取消. 203.3.2对账 21四、附录.. ..24.2就诊类别 4.1交易订单类型... ..22 224.3支付状态.. 234.4生成订单参数明细定义 234.5医保支付返回明细信息. .54.6医疗类别.. 4.7电子凭证二维码解码说明 39 39
Neusoft
一、接口通用说明
1.1接口实现方式
接口统一采用HTTPPOST方式调用，交易报文采用key1=valuel&key2=value2&.-格式，报文元素统一使用小写，字符编码采用UTF-8.
1.1.1数字安全
定点医药机构系统与医保业务系统之间按本接口规范交互.
定点医药机构系统与医保业务系统间的信息交互和服务调用基于PKI证书进行签名和加密.在定点医药机构系统调用医保业务系统的交易时，采用定点医药机构系统的私钥进行签名，使用医保业务系统公钥进行加密，将请求发送到医保业务系统，医保业务系统完成解密和签名验证后执行相关动作.
医保业务系统将交易的输出返回定点医药机构系统时，或是医保业务系统调用定点医药机构系统交易时（如回调定点医药机构系统推送相应的处理结果），医保业务系统使用定点医药机构系统的公钥进行加密，使用医保业务系统的私钥进行签名，返回信息或将调用发送至定点医药机构系统，定点医药机构系统应该进行解密和签名验证后，再进行相应的处理.
定点医药机构系统可使用辅助开发包（Java技术路线可使用
Neusoft
securitypkg.jar，C、C#或C技术路线可使用securitypkg.dl1）配置对接口交易参数进行数字签名及加密，以http请求发送到医保业务系统的服务端点上，完成交易调用.
1.1.4交易列表
类型 交易编号 交易名称 备注ST001 签到基础服务类 ST002 签退ST020 扫码身份识别ST007 被扫支付ST009 查询支付状态ST010 扫码退费扫码支付服ST021 预生成支付订单务类ST022 验码支付ST023 扫码入院（就诊）登记ST024 扫码无费退院交易取消辅助服务类 ST100ST099 对账文件获取
1.1.3报文参数说明
元素名 元素含义 类型 说明
Neusoft
version 版本号 String(10) 初始版本为1.0merchantcode 商户代码 String(32) 商户代码接入信息系统代码（如医院信息系infosyscode 接入信息系统代码 String(32) 统HIS、医院一体机、医院/服务号等）transtype 交易编码 String(32) 见交易列表节hospcode 定点医药机构代码 String(32) 定点医药机构代码接口方法调用结果.入参不传00：方法调用成功respcode 接口方法调用结果 String(4)1X:方法调用失败-1：方法异常返回接口方法调用结果说 接口方法调用结果详细说明.入参respmsg 明 String(200) 不传业务执行结果.入参不传aptcode 业务执行结果 String(4) 00：业务执行成功1X:业务执行失败-1：业务异常返回aptmsg 业务执行结果说明 String(200) 业务执行结果详细说明.入参不传xml格式.以transdata 交易业务参数元素作为根节点，各交易的业务参数元素详见接口交易说明.
