移动支付对接上海市医疗保障信息平台接口规范开发说明V13.docx
移动支付对接上海市医疗保障信息平台接口规范开发说明V13关于医药机构对接国家平台的移动支付部分，涉及电子凭证及线上结算的相关部分接口需要改造适配。以下为接口改造说明。1 .总体说明因国家平台不支持部分特殊人员就医，参保人刷电子凭证时，医药机构解码时先统一调用五期SEOI获取身份信息，并调用SMO1.查询账户信息，然后参照定点医药机构接口开发说明，根据不同的人员类型决定是发往国家平台还是五期系统。发送到国家平台时，如果是线下刷电子凭证，所有接口中就诊凭证类型和就诊凭证编号两个参数需要传电子凭证类型和对应的电子凭证令牌；如果是线上支付或互联网医院交易，除了就诊凭证类型和就诊凭证编号需要改造，还需要根据以下接口说明开发HIS系统进行移动支付结算。1.1 接口规范说明医疗机构接入国家平台实时交易的移动支付时，报文头要使用国家平台的报文头格式规范，以文档医疗保障信息平台定点医药机构接口规范（以下简称“国家接口”）的最新版本规范为准。input节点和OUtPUt节点需继续沿用中心系统与定点医疗机构接口规范（第五版V1.O）（以下简称“五期接口”）最新版本（具体见本文档章节2）,SE系列接口的报文内容均直接放在input或output节点中，是国家接口与五期接口两种接口文档的组合。本文档SE02中PayReqUeSt参数使用国家接口文档中2207接口的入参，SEo3、SE04中PayReSPOnSe参数使用2207接口的出参（国家平台、五期移动支付均只支持门诊交易）。另：涉及线上交易时，Optejtype需设置为4（线上支付终端）或5（互联网医院）。1.2 访问路径说明根据不同的人员类型，应在五期系统结算的人员仍使用五期接口规范规定的接口报文，并发送到五期地址；应在国家平台结算的人员使用本文档规定的接口报文，并发往国家平台。国家平台正式环境访问路径：http:前置机地址/gjptqZyy-Prodapiv1.routc访问不同的SE系列接口需要将接口名写入报文头的infno项中，注意国家平台的报文需要使用国家机构代码。具体见第2章接口入参示例。2 .具体接口说明移动支付相关流程见附件一，具体接口说明如下：2.1 SE02-互联网线上结算1 .1.1说明报文头使用国家接口标准规范，PayRequest放置国家接口报文2207接口输入参数，入参和出参的报文头分别更换为国家平台接口输入和输出报文头，报文头中infno交易编号为SE02,在报文头中的OPteJtyPe需设置为4（线上支付终端）或5（互联网医院）。除此以外，接口作用，字段含义和定义均沿用五期接口文档最新规范。2 .1.2入参参数名类型是否必填中文名称备注orderNo字符串是订单号医院自行生成的唯一ID,生成规则：国家机构代码（12位）+yyyyMMddHHmmssSSS+6位随机数字ecToken字符串是令牌PayRequest字符串是医保结算确认请求包（仅input部分）按线下结算的格式和长度为准，以国家平台最新接规范为准pName字符串否姓名p1.dNo字符串否身份证号注：结算请求发送后，即时返回报文表示医保成功收到信息。是否成功结算医院需根据“SE03支付结果推送”和“SE04支付结果查询”进行判断。入参示例:“infno”:SE02，zzmsgid,z:zzH54000,z,mdtrtarea-admvs,z:310000，“insup1.jadmdvs":"310000”,“receJSyS_code”:01",dev_no:,dev_safe_info:,canfo:,/signtype:,“infver”:V1.0，opter_type:4,zopterzz:zz3510,z,“opteJname：测试操作员，"2022-03-0111:38:59”,xmedns-code:H,zrfixmedins_name*:三级机构，sign_no:,工rinput:("orderNo":"H",zzecToken,z:zz310000ect7s091103t0b230aa800002c952249,z,“pNamc”:测试人员三四五，pIdNo："150001，“payRCqUeSt："data":psn_no:,，zmdtrt_cert_type/z:01",zzmdtrt_cert_nozz：,310000ect7s091103t0b230aa800002c952249",/zmed_type，z:,1,zzmedfee-sumamt,z:z,100.00zz,/zpsn_set1.wayzz:01",mdtrt_id":"44135，chrg_bchno：SFO1，z，acct_used_f1.agz,:1，,zinsutype,z:“310”)12. 1.3出参实时返回成功响应报文头，是否成功结算医院需根据“SE03支付结果推送”和“SE04支付结果查询”进行判断。2.2 SE03支付结果推送2.2.1 说明报文头使用国家接口标准规范，PayResponse节点放置国家接口报文2207接口输出参数，入参和出参的报文头分别更换为国家平台接口输入和输出报文头。报文头中infno交易编号为SE03o除此以外，接口作用，其他字段含义和定义均沿用五期接口文档最新规范。另：推送接口地址为原五期SE03推送地址+/nation,如:8888/shyb/notify/nation2.2.2 人参数据项数据项说明类型最大长度是否可空备注ecToken令牌字符串63非空PayStatus支付状态字符串2非空1：成功；-1：失败payResponse医保结算确认返回包（仅output部分）字符-1'非空按线下结算的格式返回长度按线下返回的交易包长度为准，以国家平台最新接口规范为准gmt支付完成时间时间格式非空orderNo第三方支付订单弓字符串40可空Channe1.不等于wybpayw时必传tradeNo第三方支付平台的支付交易流水号字符串64可空Channe1.不等于"ybpay”时必传amount第三方支付金额数字格式A可空Channe1.不等于ybpayw时必传channe1.支付渠道字符串10非空wechat：微信支付a1.ipay：支付宝支付unionpay：银联ybpay：0现金的付款bi1.1.Time第三方支付平台清算日期H期格式可空Channe1.不等于"ybpay”时必传示例:“infno”:SE03，“msgid”:nu1.1.,“infver：nu1.1.,“opter：nu1.1.,infcode”:0,inf_refmsgid”:070358,refmsg_time：“40313”,“responC1.time：42392，erJmSg”:nu1.1.,“warnJnSg：nu1.1.,“signtype”:nu1.1.,z*cainfozz:nu1.1.,4上foutput:t"ecToken":zz310000ect7tf9a003v0b230aa80000f60289abz/,z,payStatuszz:"1",z,payResponse,z:“"set1.info”:"set1.id：44020，mdtrt_id：44793","psn_no":"”,psn_name：测试人员三四五”,psn_cert_type：“01","certno”:150001，“gend":"1","naty":,99,z,VbrdyV:V1994-06-15”,"age”:27.0,“insutype”:"310”,psn_type：“116031","cv1.serv_f1.ag：V0V,Vset1._timeV:2022-03-0320:54:40，mdtrt_cert_type："02，med_type：12",medfee_sumamt":10000.00,fu1.amt-ownpay-amtz,:0.00,z,over1.mt-se1.fpayzz:0.00,/zprese1.fpay_amtzz:0.00,inscp_scp_amt：10000.00,act_pay_dedc:0.00,z，hifp_pay/z:0.00,?zpoo1._prop_se1.fpayz/:1.50,z，cv1.serv_payz/:0.00,hifes_pay”:5000.00,“hifmi_payz，:0.00,hifob_pay:0.00,hifdm_pay:0.00,maf_pay:0.00,oth_payz，:0.00,fund-pay-sumamtz,:5000.00,psn_part_amt":5000.00,z/acct_pay”:0.00,psn_cash_pay:5000.00,hosp_part_amt:0,“ba1.c”:0.00,“acct_mu1.aid_payz/:0,medins_set1.id":9,c1.r_oPtinS”:”310110”,"c1.jwa”set1.detai1.”:"fund_pay_type":"310800”,inscp_scp_amt：Iooo0.00,crt_paybmt_amt：0,"fund_payamt":5000.00,"fund_pay_type_name":”310800”,"set1.ProC_info:nu1.1.,z，fund_pay_type"：本年章额，?,zzinscp-scp-amt,z:10000.00,crt_paybmt_amt：0,fund_payanrt”:0.00,fUnCI_pay_type_name：本年余额，Set1.Proc_info：nu1.1.,"fimd_pay_type：历年余额”,inscp_scp_amt：IOO00.00,crt_payb_1.IIrt:0,fund_payamt”:0.00,zzfund_pay_type_name，":历年余额”,set1._prOJinfo：nu1.1.,fund_pay_type":附加段现金，inscp_scp_amt：10000.00,crt_payb_1.mt_amt：0,"fund_payamt":5000.00,”func1.Pa
