《移动支付对接上海市医疗保障信息平台接口规范开发说明V13.docx》由会员分享，可在线阅读，更多相关《移动支付对接上海市医疗保障信息平台接口规范开发说明V13.docx（24页珍藏版）》请在课桌文档上搜索。
1、移动支付对接上海市医疗保障信息平台接口规范开发说明V13关于医药机构对接国家平台的移动支付部分，涉及电子凭证及线上结算的相关部分接口需要改造适配。以下为接口改造说明。1 .总体说明因国家平台不支持部分特殊人员就医，参保人刷电子凭证时，医药机构解码时先统一调用五期SEOI获取身份信息，并调用SMO1.查询账户信息，然后参照定点医药机构接口开发说明，根据不同的人员类型决定是发往国家平台还是五期系统。发送到国家平台时，如果是线下刷电子凭证，所有接口中就诊凭证类型和就诊凭证编号两个参数需要传电子凭证类型和对应的电子凭证令牌；如果是线上支付或互联网医院交易，除了就诊凭证类型和就诊凭证编号需要改造，还需要
2、根据以下接口说明开发HIS系统进行移动支付结算。1.1 接口规范说明医疗机构接入国家平台实时交易的移动支付时，报文头要使用国家平台的报文头格式规范，以文档医疗保障信息平台定点医药机构接口规范（以下简称“国家接口”）的最新版本规范为准。input节点和OUtPUt节点需继续沿用中心系统与定点医疗机构接口规范（第五版V1.O）（以下简称“五期接口”）最新版本（具体见本文档章节2）,SE系列接口的报文内容均直接放在input或output节点中，是国家接口与五期接口两种接口文档的组合。本文档SE02中PayReqUeSt参数使用国家接口文档中2207接口的入参，SEo3、SE04中PayReSPOn
3、Se参数使用2207接口的出参（国家平台、五期移动支付均只支持门诊交易）。另：涉及线上交易时，Optejtype需设置为4（线上支付终端）或5（互联网医院）。1.2 访问路径说明根据不同的人员类型，应在五期系统结算的人员仍使用五期接口规范规定的接口报文，并发送到五期地址；应在国家平台结算的人员使用本文档规定的接口报文，并发往国家平台。国家平台正式环境访问路径：http:前置机地址/gjptqZyy-Prodapiv1.routc访问不同的SE系列接口需要将接口名写入报文头的infno项中，注意国家平台的报文需要使用国家机构代码。具体见第2章接口入参示例。2 .具体接口说明移动支付相关流程见附件
4、一，具体接口说明如下：2.1 SE02-互联网线上结算1 .1.1说明报文头使用国家接口标准规范，PayRequest放置国家接口报文2207接口输入参数，入参和出参的报文头分别更换为国家平台接口输入和输出报文头，报文头中infno交易编号为SE02,在报文头中的OPteJtyPe需设置为4（线上支付终端）或5（互联网医院）。除此以外，接口作用，字段含义和定义均沿用五期接口文档最新规范。2 .1.2入参参数名类型是否必填中文名称备注orderNo字符串是订单号医院自行生成的唯一ID,生成规则：国家机构代码（12位）+yyyyMMddHHmmssSSS+6位随机数字ecToken字符串是令牌Pa
5、yRequest字符串是医保结算确认请求包（仅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:,“i
6、nfver”: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：,3100
7、00ect7s091103t0b230aa800002c952249,/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接口输出参
8、数，入参和出参的报文头分别更换为国家平台接口输入和输出报文头。报文头中infno交易编号为SE03o除此以外，接口作用，其他字段含义和定义均沿用五期接口文档最新规范。另：推送接口地址为原五期SE03推送地址+/nation,如:8888/shyb/notify/nation2.2.2 人参数据项数据项说明类型最大长度是否可空备注ecToken令牌字符串63非空PayStatus支付状态字符串2非空1：成功；-1：失败payResponse医保结算确认返回包（仅output部分）字符-1非空按线下结算的格式返回长度按线下返回的交易包长度为准，以国家平台最新接口规范为准gmt支付完成时间时间格式非
9、空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：n
10、u1.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:tecToken:zz310000ect7tf9a003v0b230aa80000f60289abz/,z,payStatuszz:1,z,payResponse,z:“set1.info”:set1.id：44020，mdtrt_id：44793,psn_no:”,psn_name：
11、测试人员三四五”,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_amtz
12、z: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,hos
13、p_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
14、_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.Pay_type
15、_name：附加段现金，“set1.PrOJinfO”:nu1.1.,exp_content:nu1.1.，,gmt:,2022-03-0320:54:42，“orderNo:H,tradeNo：24，amount:5000.0,channe1.:a1.pay,i】pDi1.1.Time:),z,mdtrtarea-admvsz:nu1.1.,insup1c_admdvs：nu1.1.,zzrecer_sys_code/，:nu1.1.,dev_no：nu1.1.,，dev_safe_info，/:nu1.1.,zzopter-typez,:nu1.1.,/，opter_name/，:nu1.
16、1.,nu1.1.,zzfixmedins_code/，:nu1.1.,“fixmedins_name：nu1.1.,sign_no：nu1.1.)2.2.3 出参医疗机构如若接受到推送数据，需返回JSON报文(infcode:0)2.3 SE04支付结果查询2.3.1 说明报文头使用国家接口标准规范，PayReSPOnSC节点放置国家接口报文2207接口输出参数，入参和出参的报文头分别更换为国家平台接口输入和输出报文头。报文头中ifno交易编号为SE04o除此以外，接口作用，其他字段含义和定义均沿用五期接文档最新规范。示例:2.3.2 人参数据项数据项说明类型最大长度是否可空备注ecToke
17、n令牌字符串63非空infno:SE04,msgid:H71494,cainfo:signtype:zinfver:V1.0,opter:0018,mdtrtarea_admvs:310000zinsup1.c_admdvs:310104,recer_sys_code:HIS,dev_no:zdev_safe_info:,opter_type:4,opter_name:doctzinf_time:2022-02-2816:29:27,fixmedins_code:H,fixmedins,name:三级机构zsign_no:,535413zinput:ecToken,310000ect7tf9a
18、003v0b230aa80000f60289ab)2.3.3 出参数据项数据项说明类型最大长度是否可空备注ecTken令牌字符串63非空payResponse医保结算返回包（仅。IJtPUt部分）字符串非空按线下结算的格式返回长度按线下返回的交易包长度为准，以国家平台最新接口规范为准gmt支付完成时间时间格式非空orderNo第三方支付订单号字符串40可空Channe1.不等于“ybpay”时必传tradeNo第三方支付平台的支付交易流水号字符串64可空Channe1.不等于wybpayw时必传amount第三方支付金额数字格式A10可空Channe1.不等于“ybpay”时必传channe1
19、.支付渠道字符串10非空wechat：微信支付a1.ipay：支付宝支付unionpay：银联ybpay：0现金的付款bi1.1.Time第三方支付平台清算日期日期格式40可空Channe1.不等于“ybpay”时必传示例:output:amount:5000.00,ec1.bken:310000ect7tf9a003v0b230aa80000f60289abzorderNorHztradeNo:24,payResponse:set1.detai1.:crt_payb_1.mt_amt:0Afund_pay_type:310800Afund_pay_type_name:310800Afund_
20、payamt:5000.00Ainscp_scp_amt:10000.00zcrt_payb_1.mt_amt:0Afunc1._pay_typeV：本年余额V,VfunC1.Pa1.tyPJnamZ:”本年余额fund-payamt0.00Ainscp,scp,amt1.0000.00z,crt.payb.1.mt,amt0,fund-payJypeAro年余额,fund_pay_type_name:历年余额fund-payamt,0.00inscp.scp.amt1.0000.00z,crt,payb-1.mt,amt,0,fund-payJypeA,f加段现金V,fund_Pa1.tyP
21、ejame:附加段现金fund-payamtr5000.00inscp-scp-amtr1.0000.00set1.infoacct-mu1.aid-payr0,acct-pay:0.00Aact_pay_dedc:0.00Aage:27.0Aba1.c:0.00Abrdy:1994-06-15,certnoA,c1.r-optinsA310110,c1.rJype,A1.1.,c1.r,wayV1.,cv1.servJ1.agA0Acv1.serv_pay:0.00/fu1.amt_ownpay_amt,:0.00Afund_pay_sumamt:5000.00AgendV,:,1.,Ahi
22、fdm_pay:0.00Ahifes_pay:5000.00Ahifmi_pay:0.00Ahifob_pay:0.00Ahifp_pay:0.00Ahosp_part,amt0inscp-scp-amt1.0000.00insutpeA310maf-pay0.00mc1.trt-cert-typeA02mdtrtJd,44793,med.type,A12,medfee.sumamtV,1.00.00medins-set1.JdA9natyA99oth-payr0.00Aover1.mt-se1.fpay,0.00poo1.prop-se1.fpay1.50prese1.fpay-amt:0.
23、00,psn_cash_pay:5000.00,psn_cert_type:01,psn_name:测试人员三四五psn.noApsn.part,amt50.00,psn-typeA,116031set1.JdA44020set1.timeA2O22-O3-O320:54:40、”,channe1.:,a1.ipayzgmt:2022-03-0320:54:42,infcode:Ozcainfo:,signtype:)2.4 SE05现金退款结果推送2.4.1 说明沿用原逻辑，入参和出参的报文头分别更换为国家平台接口输入和输出报文头，报文头中infno交易编号为SE05o另：推送接口地址为原五
24、期SE05推送地址+/nation,如:8888/shybrefund/nation2.4.1.1 人参数据项数据项说明类型最大长度是否可空备注ecToken解码令牌字符串63非空refundstatus退款状态字符串2非空1：退款成功-1:退款失败rmt退款完成时间时间格式可空refundstatus为1时必填orderNo第三方支付订单号字符串40可空refundstatus为1时必填refundNo第三方退款订单号字符串64可空refundstatus为1时必填amount第三方退款金额数字格式A可空refundstatus为T时必填channe1.第三方渠道字符串10可空wechat-
25、微信支付a1.ipay-支付宝支付unionpay-银联refundstatus为1时必填bi1.1.Time第三方支付平台清算日期日期格式可空refundstatus为1时必填示例:infno:,SE05,msgid:nu1.1.infver:nu1.1.,opter:nu1.1.,infcode:nu1.1.,inf_refmsgid:nu1.1.,refmsg_time:nu1.1.zrespond_time:nu1.1.,err_msg:nu1.1.,warn_msg:nu1.1.,signtype:nu1.1.,cainfo:nu1.1.,output:ec7bken:310000e
26、ct7tf9a003v0b230aa80000f60289ab,zrefundStatus:,1,rmt:2022-03-0321:10:14,orderNo,HzrefundNo:,TEST-TK-1299aO14f5abamount:5000.00channe1.:,a1.ipayzbi1.1.Time:,mdtrtarea_admvs:nu1.1.,insup1.c_admdvs:nu1.1.,recer_sys_code:nu1.1.,dev_no:nu1.1.,dev_safe_info:nu1.1.,opter_type:nu1.1.,opter_name:nu1.1.,inf_t
27、ime:nu1.1.,fixmedins_code:Hfixmedins_name:nu1.1.,sign_no:nu1.1.)2.4.1.2 出参医疗机构如若接受到推送数据，需返回JSON报文(infcode:O)2.5 SE06现金退款结果查询2.5.1 说明沿用原逻辑，入参和出参的报文头分别更换为国家平台接口输入和输出报文头，报文头中infno交易编号为SE06o2.5.1.1入参数据项数据项说明类型最大长度是否可空备注ecTken令牌字符串63非空示例:infno:,SE06,msgid:,H73721,cainfo:,signtype:zinfver:V1.0,opter:0018,
28、mdtrtarea_admvs:310000,UinSUP1.jadmdvs:310104zrecer_sys_code:HIS,dev_no:，dev_safejnfo:,opter_type:4,opter_name:doct,inf_time:2022-02-2816:29:27,fixmedins_code:H,“fixmedins_name：“三级机构zsign_no:535413zinput:ec7bken:310000ect7tf9a003v0b230aa80000f60289ab)2.5.1.2出参数据项数据项说明类型最大长度是否可空备注ecToken解码令牌字符串63非空re
29、fundstatus退款状态字符串2非空1：退款成功0：退款中-1:退款失败rmt退款完成时间时间格式可空refundstatus为1时必填orderNo第三方支付订单号字符串40可空refundstatus为T时必填refundNo第三方退款订单号字符串64可空refundstatus为1时必填amount第三方退款金额数字格式A可空refundstatus为1时必填channe1.第三方渠道字符串10可空wechat-微信支付a1.ipay-支付宝支付unionpay-银联refundstatus为1时必填bi1.1.Time第三方支付平台清算日期日期格式可空refundStatus为T时
30、必填示例:output:“amount:5000.00，biI1.Time:,zzecTokenz,:z,310000ect7tf9a003v0b230aa80000f60289abzz,z,orderNozz:H,z,refundNozz:z,TEST-TK-1299a014f5abzz,rmt：2022-03-0321:07:37,channe1.:a1.pay,infcode”:0,canfo:,.signtype:)2.6 SE07现金退款提交2.6.1 说明沿用原逻辑，入参和出参的报文头分别更换为国家平台接口输入和输出报文头，报文头中infno交易编号为SE07,在报文头中的OPte
31、jtyPe需设置为4（线上支付终端）或5（互联网医院）。2.6.1.1 人参数据项数据项说明类型最大长度是否可空备注ecToken令牌字符串63H.空orderNo第三方支付订单号字符串40非空示例:infno:,SE07,msgid:H95517,z,cainfo:signtype:zinfver:opter:“0018”，mdtrtarea_admvs:310000,insupIjadmdVs：310104,recer_sys_code:HIS,dev_no:zdev_safe_info:opter_type:4,opter_name:,doctzinf_time:2022-02-2816
32、:29:27，fixmedins_code:Hfixmedins_name:三级机构,sign_no:,535413zinput:,ec7bken310000ect7tf9a003v0b230aa80000f60289ab,orderNo:H)2.6.1.2 出参实时返回成功响应报文头，现金退款结果从SE05返回3.测试说明3.1 测试环境访问路径说明测试环境访问路径：http:前置机地址gjptqzyy-tcstapiv1.routc3. 2第三方支付测试说明因第三方无测试环境，移动支付测试环境涉及到第三方的流程均模拟自动通过，若有自费，默认自费直接成功，不会发起测试人员付自费的流程。测试环
33、境不会推送支付和退款结果（SE03和SE05）,但是可以通过接口查询支付和退款结果（SE04和SE06）o3.3电子凭证测试说明1、机构向区医保中心提供测试人员（上海参保人），需提供姓名、身份证号。中心会根据上报的人员信息表开通测试电子凭证权限。详见附件二。2、机构下载“国家医保服务平台”测试版APP并使用测试人员注册、登录，APP下载二维码见附件三，或手机浏览器访问（此APP仅支持安卓系统，短信验证码固定为6个1,若操作过程中设置了电子凭证密码请进行记录，展码时需要使用，也可至展码页面修改密码。若二维码无效请刷新重试，多次无效请卸载重装APP）。3、关于使用扫码测试线上支付的建议：线上支付时
34、，机构通过第三方渠道获取电子凭证码值，而本文档提供的测试电子凭证只有亮二维码的方式，和实际业务场景不一致。建议厂商写一个小demo将扫码扫出来的码值传到程序中以模拟正式环境（不建议通过扫码获取码值，然后手动将码值写死在程序中的方式，该方式需要频繁修改程序，而且电子凭证码值有效期只有一分钟，容易超时），因每家厂商不同，中心不提供dem。案例。（仅作建议，厂商也可自行想办法解决）4、测试环境移动支付权限不做控制。正式环境会根据五期相关权限的开通情况进行控制。5、因为是测试环境和测试电子凭证的交易，不会影响任何生产上的数据，无需收一笔退一笔。附件一：移动支付相关流程1、电子凭证线下使用流程渠道APP
35、电子凭长保结证中心克系统-1.3、湾求获取二维询宣-1；4、栗适信息校检aI2.1、石?S二金五A以7、调求解析二二T筵五信息= 广25、运亘结果11j22、返砺值WT2.6、运叵人员信息、ecToken-2.3、市求学否II111、赅尸举I11II22SEifi-杵1II!22M4直IIJ、*fFA-3.4,返亘如奘桑XII1I3.5、羡令SZ第BJIII三方支付毛这IIII-a?QBN与yftrRJI+-18.返宜造真叁果-ITIII-3.9,返亘造果T电子凭证二维码线下支付是由原来的线下插卡读取参保人信息，变更为扫码读取人员信息。口;用户打开渠道应用电子凭证二维码页，渠道应用向电子凭证中
36、心获取二维码值，并展示二维码。2、医疗机构通过扫码设备获取用户的渠道二维码值发送至电子凭证中心解码，电子凭证中心解码完成返回人员信息、ecTokeo3、医疗机构根据人员信息、ecToken做帐户查询、明细上传。再发起医保试算、结算。2、电子凭证线上支付流程医疗机构“联网端医疗机构 HIS举电r凭医保结证中心兑系统1.1.克或诊疗?一A.强取电子角迂K13,生码N-I1.4.5i1.il-l.卜 5I - 1.5、ZStl* 2 J-t-2.5.这豆人贝,、MTotan-J2.6.除户查31.2.3. 修密二G- t-Y 一L 2 4、庇ItA27、里更上海-J2.8.上/订一-J2.9.3.1
37、1.窗J仁ff*hI3.12.统装后经IIIII:一E:III基于电子凭证的医保线上支付，由医疗机构互联网端从对应渠道莪取电子窟证二维码，通过电子凭证二维码验证个人身份，完成网上挂号、互联网诊疗支付等医保电子凭证功能。1、参保人完成诊疗服务，在医疗机构互联网端选择医保支付，医疗机构互联网端将通过对应的渠道，授权获取电子凭证二维码值（渠道向电子凭证中心实时获取）。获取时，渠道商应依照国家局规范，进行人脸等实人认证。2、医疗机构互联网端将相关数据传递给HIS端，由HIS系统向医保系统进行电子凭证的验证、获取ectoken帐户查询等。3、医疗机构通过HIS系统进行明细上传以及请求试算（订单上传）等过
38、程。4、试算完成后，医疗机构互联网端将通知电子凭证中心进行结算，电子凭证中心通过后台接口发送个人自负部分的数据到对应渠道，由渠道应用完成参保人自负支付，然后将结果通知到电子凭证中心，由电子凭证中心完成医保结算。最后将交易结果返回给医院HIS系统，再返回到互联网端，进行后续医疗服务。5、如果结算时个人部分为零，则不再调用渠道进行医保个人部分结算。用户医疗机构互联网端医疗机构 HIS瑞X.2.：雯我电子兔可一1, .送 3R 值1.7. 1数患中I渠 APP1.5Cft-1.&京电-1g1.11. i(BA* ecToka-电子凭证中心医保结 算系统2.2.r2.4. IIg个人15%2.5, -2& SBSFaft-1、参保人在移动设备点击退款，医疗机构收到退款消息，校验该订单是否可以退款。2、医疗机构向医保端发起退款，医保结算系统收到退款请求，先发往医保结算系统进行医保退款，再返回电子凭证中心进行个人部分退款，最后将结果返回给医院HIS端。附件二：测试人员信息表机构名称测试人员姓名测试人员身份证附件三：测试APP下载二维码（仅支持安卓系统）
