定点医药机构移动端应用接入医保移动支付开发实施指南

1. 定点医药机构移动端应用对接接引说明
   1. 范围

本文档规定了定点医药机构移动端应用为实现各种医疗服务业务场景下接入医保移动支付，需要调用的医保移动支付相关接口规范，包括HIS接口规范、医保小程序后端服务接口规范、前端接口规范。（参见《北京市基本医疗保险移动支付HIS接口规范》、《定点医药机构移动端应用与移动支付子系统接口规范》、《医保小程序微信端对接定点医药机构移动端应用接口方案》、《医保小程序支付宝端对接定点医药机构移动端应用接口方案》），适用于定点医药机构信息管理部门人员、移动端应用开发人员、HIS开发人员等使用。

1. 1. 概念术语
2. 北京医保平台移动支付子系统

北京医保平台移动支付子系统封装了医保移动支付相关支付、退费、银行卡管理、电子凭证激活展码等服务能力，由医保小程序和后端服务两部分组成，医保小程序又分为支付宝、微信两种平台具体实现。

1. 定点医药机构移动端应用

定点医药机构移动端应用是指面向就诊人提供的支持医药机构各种医疗服务开展的移动端应用，通常包括APP、小程序、公众号/生活号等，医保移动支付子系统为每个不同的移动端应用分配一个应用ID用做唯一标识。

应用ID主要用于移动端应用和医保移动支付子系统接口调用时进行签名验签和加解密处理。

1. 定点医药机构信息系统(HIS)

指定点医药机构的核心业务信息系统，通常作为移动端应用的后端系统，为移动端应用提供相关的服务接口。

1. 医药端移动支付平台

北京市医保平台统一的医药端移动支付代理服务子系统，负责HIS和医保移动支付中心的对接接入，提供支付订单获取、上传、支付/退费发起、结果反馈等服务功能。

1. 移动支付渠道

接入医保移动支付的移动端应用称之为移动支付渠道应用，医保移动支付子系统为每个不同的移动支付渠道分配一个渠道ID用做唯一标识，一家医药机构可以自行开通多个移动支付渠道应用。

医药端移动支付平台按渠道进行支付/退费交易数据信息的管理，对移动端应用发起的每一笔医保移动支付、退费交易都通过渠道ID标记发起交易的渠道。

对于直接接入医保移动支付的定点医药机构渠道，根据医保移动支付流程需要，挂号、门诊业务均采用医药端移动支付平台调用HIS接口拉取费用明细信息方式（简称“拉”方式）。

1. 支付订单号

业务订单发起一次具体收费操作时，需要生成一个对应此次收费交易的流水号，称为此业务订单的支付订单号。

一个业务订单可以发起多次支付，因此对应多个支付订单号。由于医药端移动支付平台对接全市所有的移动支付渠道应用，支付订单号在平台内必须唯一，因此支付订单号需要按照统一的规则生成。

1. 退费订单号

业务订单发起一次具体退费操作时，需要生成唯一一个对应此次退费操作的流水号，称为此业务订单的退费订单号。由于一个业务订单可以对此发起多次退费，因此一个业务订单号可以对应多个退费订单号。

1. 支付/退费结果通知