移動支付對接上海市醫(yī)療保障信息平臺

接口規(guī)范開發(fā)說明V13

關(guān)于醫(yī)藥機構(gòu)對接國家平臺的移動支付部分，涉及電子憑證及線上結(jié)算的相關(guān)部

分接口需要改造適配。以下為接口改造說明。

1.總體說明

因國家平臺不支持部分特殊人員就醫(yī)，參保人刷電子憑證時，醫(yī)藥機構(gòu)解瑪時先

統(tǒng)一調(diào)用五期SE01獲取身份信息，并調(diào)用SM01查詢賬戶信息，然后參照《定點醫(yī)藥

機構(gòu)接口開發(fā)說明》，根據(jù)不同的人員類型決定是發(fā)往國家平臺還是五期系統(tǒng)C

發(fā)送到國家平臺時，如果是線下刷電子憑證，所有接口中就診憑證類型和就診憑

證編號兩個參數(shù)需要傳電子憑證類型和對應(yīng)的電子憑證令牌；如果是線上支付或互聯(lián)

網(wǎng)醫(yī)院交易，除了就診憑證類型和就診憑證編號需要改造，還需要根據(jù)以下接口說明

開發(fā)H1S系統(tǒng)進行移動支付結(jié)算。

1.1接口規(guī)范說明

醫(yī)療機構(gòu)接入國家平臺實時交易的移動支付時，報文頭要使用國家平臺的報文頭格

式規(guī)范，以文檔《醫(yī)療保障信息平臺定點醫(yī)藥機構(gòu)接口規(guī)范》（以下簡稱“國家接

口”）的最新版本規(guī)范為準.

input節(jié)點和output節(jié)點需繼續(xù)沿用《中心系統(tǒng)與定點醫(yī)療機構(gòu)接口規(guī)范（第五

版V1.0）》（以下簡稱“五期接口”）最新版本（具體見本文檔章節(jié)2）,SE系列接

口的報文內(nèi)容均直接放在input或output節(jié)點中，是國家接口與五期接口兩種接口

文檔的組合。本文檔SE02中payRequest參數(shù)使用國家接口文檔中2207接口的入?yún)ⅲ?/p>

SE03、SE04中payResponse參數(shù)使用2207接口的出參（國家平臺、五期移動支付均

只支持門診交易）。

另：涉及線上交易時.，optejtype需設(shè)置為4（線上支付終端）或5（互聯(lián)網(wǎng)醫(yī)

院）。

1.2訪問路徑說明

根據(jù)不同的人員類型，應(yīng)在五期系統(tǒng)結(jié)算的人員仍使用五期接口規(guī)范規(guī)定的接口報

文，并發(fā)送到五期地址；應(yīng)在國家平臺結(jié)算的人員使用本文檔規(guī)定的接口報文，并發(fā)

往國家平臺。

國家平臺正式環(huán)境訪問路徑：

訪問不同的SE系列接口需要將接口名寫入報文頭的infn。項中，注意國家平臺的

報文需要使用國家機構(gòu)代碼。具體見第2章接口入?yún)⑹纠?/p>

2.具體接口說明

移動支付相關(guān)流程見附件一，具體接口說明如下：

2.1SE02-互聯(lián)網(wǎng)線上結(jié)算

2.1.1說明

報文頭使用國家接口標準規(guī)范，payRequest放置國家接口報文2207接口輸入?yún)?/p>

數(shù)，入?yún)⒑统鰠⒌膱笪念^分別更換為國家平臺接口輸入和輸出報文頭，報文頭中

infno交易編號為SE02,在報文頭中的optejtype需設(shè)置為4（線上支付終端）或

5（互聯(lián)網(wǎng)醫(yī)院）。除此以外，接口作用，字段含義和定義均沿用五期接口文檔最新規(guī)

范。

2.1.2人參

參數(shù)名類型是否必填中文名稱備注

orderNo字符串是訂單號醫(yī)院自行生成的唯一ID,

生成規(guī)則：國家機構(gòu)代碼

（12位）

+yyyyMMddHHmmssSSS+6

位隨機數(shù)字

ecToken字符串是令牌

payRequest字符串是醫(yī)保結(jié)算確認按線下結(jié)算的格式和長度

請求包（僅為準，以國家平臺最新接

input部分）口規(guī)范為準

pName字符串否姓名

pldNo字符串否身份證號

注：結(jié)算請求發(fā)送后，即時返回報文表示醫(yī)保成功收到信息。是否成功結(jié)算醫(yī)院需

根據(jù)“SE03支付結(jié)果推送”和“SE04支付結(jié)果查詢”進行判斷。

入?yún)⒉焕?

〃infno〃：〃SE02〃，

〃msgid〃：〃H5400。”，

〃mdtrtarea_adnivs〃：“310000〃，

〃insuplc_admdvs":"310000〃，

〃recer_sys_code”:〃01",

〃d1evno〃:〃〃,

devsafeinfo:,

〃?c〃〃〃

cainio:,

〃?.〃〃〃

signtype:,

〃infver〃：〃V1.0〃，

〃.〃〃/〃

opter_type:4,

“opter〃：〃3510”,

〃opter_name〃：〃測試操作員〃，

〃inf_time〃：〃2022-03-0111:38:59〃，

iixmedins_code:H,

/zfixmedins_namez/:〃三級機構(gòu)〃，

〃?〃〃//

sign_no:,

input:{

orderNo:4,

“ecToken〃：〃310000ecl7so91103l0b230aa800002c952249〃，

〃pName〃：〃測試人員三四五〃，

〃pIdNo〃：“150001〃，

“payRequest〃：{

"data”:(

〃〃〃〃

psn_no:,

，，mdtrt_cert_type，z:〃01〃，

，，mdtrt_cert_no，/：〃310000ect7so91103t0b230aa800002c952249〃,

〃medtype〃：〃]]〃，

〃medf?e_sumamt":"100.00〃,

〃psn_setl\vay〃：〃01〃，

〃mdtrt_id〃：”44135〃，

〃chrg_bchno〃：〃SF01”,

〃acct_used_flag〃：〃1”,

“insutype〃：“310〃

)

}

)

)

2.1.3出參

實時返回成功響應(yīng)報文頭，是否成功結(jié)算醫(yī)院需根據(jù)“SE03支付結(jié)果推送”和“SE04

支付結(jié)果查詢”進行判斷°

2.2SE03.支付結(jié)果推送

2.2.1說明

報文頭使用國家接口標準規(guī)范，payResponse節(jié)點放置國家接口報文2207接口輸

出參數(shù)，入?yún)⒑统鰠⒌膱笪念^分別更換為國家平臺接口輸入和輸出報文頭。報文頭中

infno交易編號為SE03c除此以外，接口作用，其他字段含義和定義均沿用五期接

口文檔最新規(guī)范。另：推送接口地址為原五期SE03推送地址+/nation,

如:8888/shyb/notify/nation

2.2.2人參

數(shù)據(jù)項數(shù)據(jù)項說明類型最大長是否可備注

度空

ecToken令牌字符非空

63

串

payStatus支付狀態(tài)字符非空1：成功；-1：失敗

2

串

payResponse醫(yī)保結(jié)算確認字符非空按線下結(jié)算的格式返【可長度

返回包（僅串按線下返回的交易包長度為

output部分）準，以國家平臺最新接口規(guī)

范為準

gmt支付完成時間時間非空

格式

orderNo第三方支付訂字符可空Channel不等于"ybpay”

40

單號串時必傳

tradeNo第三方支付平字符可空Channel不等于"ybpay”

臺的支付交易串64時必傳

流水號

amount第三方支付金數(shù)字可空Channel不等于"ybpay”

額格式時必傳

A

channel支付渠道字符非空wechat：微信支付

串a(chǎn)lipay：支付寶支付

10

unionpay：銀聯(lián)

ybpay：0現(xiàn)金的付款

billTime第三方支付平日期可空Channel不等于"ybpay”

臺清算日期格式時必傳

示例:

〃infno〃：〃SE03〃,

〃msgid〃：null,

“infver”:null,

〃opter〃：null,

“infcode〃：0,

〃inf_refmsgid〃：“070358〃,

“refmsgtime":"40313”,

〃rcspond_timc〃：〃42392〃,

，zerr_msg/z:null,

“warnmsg〃：null,

“signtype”:null,

“cainfo”:null,

output:I

/zecToken，z:，，310000ect7tf9a003v0b230aa80000f60289ab//,

“payStalus〃：〃1〃，

“payResponse”:

〃{\"setlinfo\〃：{\"setl_id\〃：\〃44020\〃，\"mdtrt一id\":\〃44793\〃，\〃psn_no\〃:\"\

〃，\〃psn_name\〃：\〃測試人員三四五

\〃，\〃psn_cert_type\〃：\"01\〃，\"certno\〃：\〃150001\",\〃gend\〃：\〃l\〃，\"n2ty\":\

z/99\z，,VbrdyVrV1994-06-

15\〃，\"age\〃：27.0,\〃insutype\〃：\〃310\",\〃psn_type\〃：\〃116031\",\〃cvlserv_fl

agVA'OV,Vsetl_time\"：V2022-03-03

20:54:40\〃，\〃mdtrt_cert_type\〃：\"02\〃，\〃med_type\〃：\"12\〃，\〃medfee_suniamt\"

:10000.00,X^fulamtownpay00,X^overlmt_selfpay\，/:0.00,X^preselfpay

amt\”:0.00,\z/inscp_scp_amt\z/：10000.00,\〃act_pay_dcdc\”:0.00,\〃hifp_pay\":0.

00,\z，pool_prop_selfpay\，z:1.50,\，，cvlserv_pay\，/:0.00,\〃hifes_pay\〃：5000.00,\〃

hifmi_pay\〃：0.00,\"hifob_pay\〃：0.00,\〃hifdni_pay\〃：0.00,\z/maf_pay\/z:0.00,\"o

th_pay\，z:0.00,\"fund_pay_sumamt\〃：5000.00,\，，psn_part_amt\/，:5000.00,\z，acct_p

ay\”:0.00,\〃psncashpay\〃：5000.00,\〃hosppartamt\〃：0,\〃balc\〃：0.00,\〃acct

_mulaid_pay\，/:0,\〃medins_setl_id\〃:\〃9\〃,\〃clr_optins\〃:\〃310110\",\z/clr_wa

y\〃：\〃1\〃，\〃c1r_type\〃：\〃ll\"},\"setldetail\":[{\"fund_pay_type\〃：\〃310800\

/z,\z/inscp_scp_amt\z/：10000.00,\〃crt_payb_lmt_amt\〃：0,\〃fund_payamt\〃：5000.00

,\，，fund_pay_type_name\A:\，，310800\z，,\z，setl_proc_info\，/:null},{\z，fund_pay_typ

c\〃：\〃本年余額

\〃，\〃inscp_scp_amt\〃：10000.00,\〃crt_payb_lmt_amt\〃：0,\〃fund_payamt\〃：0.00,\

"fund_pay_lype_name\〃：\〃本年余額

\〃，\〃setl_proc_info\〃：null},{\〃fund_pay_type\":\"歷年余額

\〃,\〃inscpscpainl\〃：10000.00,\"crlpeiybImtamlA〃：0,\〃fundpayarn(A〃：0.00,\

“fund_pay_type_name\〃:\〃歷年余額

\〃，\〃setl_proc_info\〃：nun},{\"fund_pay_type\":\〃附加段現(xiàn)金

\〃，\〃inscp_scp_amt\〃：10000.00,\，zcrt_pai^b_lmt_amt\z/：0,\/zfund_payamt\，z:5000.0

0,\〃fimd_pay_type_name\〃：\〃附加段現(xiàn)金

\z/,\，zsetlprocinfo\，z:null}],\，zexpcontent\〃:nun}〃，

〃gmt〃：〃2022-03-0320:54:42”,

orderNo:4,

"tradcNo”:〃24〃，

"amount":"5000.U",

channel:alipay,

billTime:

},〃

〃mdtrtarea_adnivs〃：null,

“insuplc_admdvs”:null,

〃recer_sys_code,:null,

“dev_no〃：null,

〃dev_safe_info〃：null,

〃opter_type〃：null,

〃opter_name〃：null,

“inf_time〃：null,

“fixmedins_code”:null,

ixmedins_nameA:null,

“signno”:null

}

2.2.3出參

醫(yī)療機構(gòu)如若接受到推送數(shù)據(jù)，需返回JSON報文

(

"infcode":0

)

2.3SE04.支付結(jié)果查詢

2.3.1說明

報文頭使用國家接口標準規(guī)范，payResponse節(jié)點放置國家接口報文2207接口輸

出參數(shù)，入?yún)⒑统鰠⒌膱笪念^分別更換為國家平臺接口輸入和輸出報文頭。報文頭中

infno交易編號為SE04c除此以外，接口作用，其他字段含義和定義均沿用五期接

口文檔最新規(guī)范。

2.3.2人參

數(shù)據(jù)項數(shù)據(jù)項說明類型最大長度是否可空備注

eclbken令牌字符串63非空

示例:

"infno":"SE04”，

"msgid":"H71494”,

"cainfo":

"signtype":

"infver":"V1.0"z

"opter":"0018”,

"mdtrtarea_admvs":"310000",

"insuplc_admdvs":"310104",

"recer_sys_code":"HIS",

"dev_no":

"dev_safe_info":

"opter_type":“4"，

"opter_name":"doct",

"inf_time":"2022-02-2816:29:27",

"fixmedins_code":"H",

"fixmedins_name":"三級機構(gòu)",

"sign_no":"535413",

"input":{

"ecToken":"310000ect7tf9a003v0b230aa80000f60289ab"

)

2.3.3出參

數(shù)據(jù)項數(shù)據(jù)項說明類型最大長是否可備注

度空

ecToken令牌字符串63非空

payResponse醫(yī)保結(jié)算返回包字符串非空按線下結(jié)算的格式

（僅output部分）返回長度按線下返

回的交易包長度為

準，以國家平臺最

新接口規(guī)范為準

gmt支付完成時間時間格式非空

orderNo第三方支付訂單號字符串可空Channel不等于

40“ybpay”

時必傳

tradeNo第三方支付平臺的字符串可空Channel不等于

支付交易流水號64“ybpay”

時必傳

amount第三方支付金額數(shù)字格式可空Channel不等于

A10“ybpay”

時必傳

channel支付渠道字符串非空wechat：微信支付

10

alipay：支付寶支付

unionpay：銀聯(lián)

ybpay：0現(xiàn)金的付

款

billTime第三方支付平臺清Fl期格式可空Channel不等于

算日期40“ybpay”

時必傳

示例:

"output":{

"amount":"5000.00",

"ecToken":"310000ect7tf9a003v0b230aa80000f60289ab",

"orderNo":"H",

"tradeNo":"24",

"payResponse":

"{\"setldetail\":[{\"crt_payb_lmt_amt\":0A"fund_pay_type\":\"310800\"A"fund_pay_type_name\":\"310

,,,,

800\"A"fund_payamt\:5000.00,\inscp_scp_amt\":10000.00},{\"crt_payb_lmt_amt\":0,\"fund_pay_type

\"：\“本年余額\”,\"fund_pay_type_name\":\“本年余額

',

\",\"fund_payamt\:O.OO/\"inscp_scp_amt\":lOOOO.OO},{\"crt_poyb_lmt_amt\":O/\"fund_pay_typc\":\"^

年余額\",\"fund_pay_type_name\":\”歷年余額

,，;

\",\"fund_payamt\":0.00,\"inscp_scp_amt\":10000.00},{\"crt_payb_lmt_amt\":07\"fund_pay_type\"：\Wf

加段現(xiàn)金\",\"fund_pay_type_name\":\"附加段現(xiàn)金

\"A"fund_payamt\":5000.00,\"inscp_scp_amt\":10000.00}]A"setlinfo\":{\"acct_mulaid_pay\":0A"acct_pa

y\":0.00A"act_pay_dedc\":0.00A"age\":27.0A"balc\":0.00A"brdy\',:\"1994-06-

，,,,，,',,,

15\"Acertno\":\'\"A"clr_optins\":\"310110\A"clr_type\":\"ll\",\'clr_way\:\l\"A"cvlserv_flag\":\"0\"

,,',

A"cvlserv_pay\":0.00A"fulamt_ownpay_amt\":0.00,\fund_pay_sumamt\:5000.00A"gend\":\"l\"A"hifd

，，

m_pay\":0.00A"hifes_pay\":50C0.00,\"hifmi_pay\":0.00Ahifob_pay\":0.00,\"hifp_pay\":0.00A"hosp_part

_amt\":0,\"inscp_scp_amt\":10000.00A"insutype\":\"310\"A"maf_pay\":0.00,\"rndtrt_cert_type\":\"02\"

",,,

A"mdtrtJd\":\"44793\"A"med_type\":\"12\"Amedfee_sumamt\":10000.00/\medins_setl_id\":\"9\"A"

naty\":\"99\",\"oth_pay\":0.00/\"overlmt_selfpay\":0.00A"pool_prop_selfpay\":1.50,\"preselfpay_amt\":

0.00A"psn_cash_pay\":5000.00,\"psn_cert_type\":\"01\"A"psn_name\":\"^raA^Hni±L

\"A"psn_no\":\"\"A"psn_part_cmt\":5000.00A"psn_type\',:\"116031\"A"setlJd\',:\"44020\"A"setl_time\

":\"2022-03-0320:54:40\"}}",

"channel":"alipay",

"gmt":"2022-03-0320:54:42"

},

"infcode":0,

"cainfo":

"signtype":""

)

2.4SE05.現(xiàn)金退款結(jié)果推送

2.4.1說明

沿用原邏輯，入?yún)⒑统鰠⒌膱笪念^分別更換為國家平臺接口輸入和輸出報文頭，報

文頭中infno交易編號為SE05o另：推送接口地址為原五期SE05推送地址+

/nation,如:8888/shyb/refund/nation

2.4.1.1入?yún)?/p>

數(shù)據(jù)項數(shù)據(jù)項說明類型最大長度是否可空備注

ecToken解碼令牌字符串63非空

refundstatus退款狀態(tài)字符串非空1：退款成功

2

-1：退款失敗

rmt退款完成時間時間格可空refundstatus

式為'1'時必填

orderNo第三方支付訂單號字符串可空refundstatus

40

為‘1'時必填

refundNo第三方退款訂單號字符串可空refundstatus

64

為‘1'時必填

amount第三方退款金額數(shù)字格可空refundstatus

式A為‘1'時必填

channel第三方渠道字符串可空wechat-徵信

支付

alipay-支付寶

支付

10

unionpay-銀

聯(lián)

refundstatus

為‘1'時必填

billTime第三方支付平臺清FI期格可空refundstatus

算日期式為T時必填

示例：

(

"infno":"SEO5",

"msgid":null,

"infver":null,

"opter":null,

"infcode":null,

"inf_refmsgid":null,

"refmsg_time":null,

"respond_time":null,

"err_msg":null,

"warn_msg":null,

"signtype":null,

"cainfo":null,

"output":{

"ecToken":"310000ect7tf9a003v0b230aa80000f60289ab"z

"refundstatus":"1",

"rmt":"2022-03-0321:10:14",

"orderNo":"H",

"refundNo":"TEST-TK-1299aO14f5ab"z

"amount":"5000.00",

"channel":"alipa/；

"billTime":""

},

"mdtrtarea_admvs":null,

"insuplc_admdvs":nuI,

"recer_sys_code":null,

"dev_no":null,

"dev_safe_info":null,

"optertype":null,

"opter_name":null,

"inftime":null,

"fixmedins_code":"H",

"fixmedins_name":null,

"sign_no":null

}

2.4.1.2出參

醫(yī)療機構(gòu)如若接受到推送數(shù)據(jù)，需返回JSON報文

(

"infcode":0

}

2.5SE06.現(xiàn)金退款結(jié)果查詢

2.5.1說明

沿用原邏輯，入?yún)⒑统鰠⒌膱笪念^分別更換為國家平臺接口輸入和輸出報文頭，報

文頭中infno交易編號為SE06o

2.5.1.1人參

數(shù)據(jù)項數(shù)據(jù)項說明類型最大長度是否可空備注

ecToken令牌字符串63非空

示例:

,,Infno":"SE06'；

"msgid":"H73721",

"cainfo":

"signtype":

"infver":"V1.0"z

"opter":"0018",

"mdtrtarea_admvs":"310000",

"insuplc_admdvs":"310104",

"recer_sys_code":"HIS",

"dev_no":

"dev_safe_info":

"opter_type":"4",

"opter_name":"doct",

"inf_time":"2022-02-2816:29:27",

"fixmedins_code":"H",

"fixmedins_name":"三級機構(gòu)",

"sign_no":"535413",

"input":{

"ecToken":',310000ect7tf9a003v0b230aa80000f60289ab,,

)

)

2.5.1.2出參

數(shù)據(jù)項數(shù)據(jù)項說明類型最大長度是否可空備注

pcTnkpn解碼令牌字符串6?非空

refundstatus退款狀態(tài)字符串非空1：退款成功

20：退款口

-1:退款失敗

rmt退款完成時間時間格可空refundstatus

式為'1'時必填

orderNo第三方支付訂單號字符串可空refundstatus

40

為'1'時必填

refundNo第三方退款訂單號字符串可空refundstatus

64

為‘1'時必填

amount第三方退款金額數(shù)字格可空refundstatus

式A為’1'時必填

channel第三方渠道字符串可空wechat-徵信

支付

alipay-支付寶

支付

10

unionpay-銀

聯(lián)

refundstatus

為'1'時必填

billTime第三方支付平臺清日期格可空refundstatus

算日期式為'1'時必填

示例:

“output”:{

“amount〃：〃5000.00〃,

billTime:,

"ecToken":/，310000ect7tf9a003v0b230aa80000f60289ab/z,

“orderNo”:〃H〃，

“refundNo":"TEST-TKT299aoi4f5ab”,

”rmt〃："2022-03-0321:07:37〃，

channel:alipay

）,

“infcode”:0.

cainfo:,

〃?〃"〃

signtype:

）

2.6SE07.現(xiàn)金退款提交

2.6.1說明

沿用原邏輯，入?yún)⒑统鰠⒌膱笪念^分別更換為國家平臺接口輸入和輸出報文頭，報

文頭中infno交易編號為SE07,在報文頭中的optejtype需設(shè)置為4（線上支付

終端）或5（互聯(lián)網(wǎng)醫(yī)院）。

2.6.1.1人參

數(shù)據(jù)項數(shù)據(jù)項說明類型最大長度是否可空備注

ecluken令牌字符串63非空

orderNo第三方支付訂單號字符串40非空

示例:

"infno":"SE07"z

"msgid":"H95517",

'?cainfo":

"signtype":

"infver":"V1.0"z

"opter":"0018”，

"mdtrtarea_admvs":"310000",

"insuplc_admdvs":"310104",

"recer_sys_code":"HIS",