中國(guó)工商銀行網(wǎng)上銀行網(wǎng)上支付接口規(guī)范(參考版)
2025-04-10 22:46本頁(yè)面
【正文】 使用商戶開(kāi)發(fā)API和銀行公鑰文件對(duì)表單中的銀行簽名signMsg進(jìn)行驗(yàn)簽； 驗(yàn)簽成功后，為確保數(shù)據(jù)一致，建議商戶比較一下通知消息中訂單金額、賣家卡號(hào)等關(guān)鍵信息和自己記錄的是否一致； 商戶根據(jù)交易結(jié)果tranStat來(lái)更新自己的指令狀態(tài)和相關(guān)數(shù)據(jù)庫(kù)信息；13 / 13。生成訂單： 商戶和當(dāng)?shù)匦新?lián)系，申請(qǐng)聯(lián)調(diào)測(cè)試；由當(dāng)?shù)匦性谀M測(cè)試環(huán)境錄入商戶信息，生成商戶證書(shū)（pfx格式）；并提供銀行模擬測(cè)試環(huán)境的銀行證書(shū)公鑰文件（用于驗(yàn)證銀行簽名時(shí)使用）； 商戶或者銀行用證書(shū)拆分工具將pfx格式的商戶證書(shū)拆分成擴(kuò)展名為crt的公鑰文件和擴(kuò)展名為key的私鑰文件；（這兩個(gè)文件用于商戶開(kāi)發(fā)API調(diào)用來(lái)進(jìn)行商戶訂單數(shù)據(jù)簽名） 商戶進(jìn)行開(kāi)發(fā)，準(zhǔn)備要求的訂單數(shù)據(jù)； 其中訂單簽名數(shù)據(jù)merSignMsg字段是對(duì)明文的簽名數(shù)據(jù)；需要使用提供的API函數(shù)和商戶私鑰進(jìn)行簽名，得到簽名串，然后做BASE64編碼； 其中商城證書(shū)公鑰merCert字段需要使用API函數(shù)做BASE64編碼； 準(zhǔn)備好訂單數(shù)據(jù)，即完成訂單提交的開(kāi)發(fā)；之后只要將訂單提交銀行接收入口“://銀行地址/servlet/ICBCINBSEBusinessServlet”，銀行來(lái)處理B2C指令的資金支付；接收通知：交易處理后，會(huì)將客戶定向回商戶網(wǎng)站，此時(shí)包含交易結(jié)果信息和銀行簽名。商戶開(kāi)發(fā)時(shí)使用這套函數(shù)和工行頒發(fā)的商戶證書(shū)進(jìn)行商戶訂單信息簽名；簽名數(shù)據(jù)項(xiàng)和順序均固定，具體格式可參見(jiàn)上文的數(shù)據(jù)定義；同時(shí)使用這套API和銀行公鑰可以驗(yàn)證銀行通知消息的有效性。當(dāng)沒(méi)有收到銀行通知時(shí)，可登錄工行商戶服務(wù)網(wǎng)站手工查詢指令狀態(tài)或者商戶調(diào)用查詢接口自動(dòng)處理。指令可疑：由于網(wǎng)銀系統(tǒng)與后臺(tái)業(yè)務(wù)處理系統(tǒng)間通訊異常，造成網(wǎng)銀不能確認(rèn)支付指令結(jié)果，則此筆指令為可疑指令；可疑指令將被自動(dòng)批復(fù)，商戶、客戶可于第二日查詢指令狀態(tài)。指令失?。鹤⒁饪赡苁盏蕉喙P失敗。1客戶聯(lián)名 0客戶未聯(lián)名聯(lián)名會(huì)員號(hào)UserNumMAX(40)聯(lián)名客戶在商戶的會(huì)員號(hào)。檢驗(yàn)聯(lián)名標(biāo)志verifyJoinFlag=1取值“1”：客戶支付時(shí)，網(wǎng)銀判斷該客戶是否與商戶聯(lián)名，是則按上送金額扣帳，否則展現(xiàn)未聯(lián)名錯(cuò)誤；取值“0”：不檢驗(yàn)客戶是否與商戶聯(lián)名，按上送金額扣帳。取值： “001”商戶代碼merIDMAX(20)唯一確定一個(gè)商戶的代碼，由商戶在工行開(kāi)戶時(shí)，由工行告知商戶。不可以為零，必需符合金額標(biāo)準(zhǔn)。工行通過(guò)訂單號(hào)加訂單日期來(lái)唯一確認(rèn)一筆訂單的重復(fù)性。注意：簽名是對(duì)notifyData的xml明文進(jìn)行簽名，不是其BASE64編碼后的串；簽名后得到二進(jìn)制數(shù)據(jù)，對(duì)此數(shù)據(jù)進(jìn)行BASE64編碼得到signMsg notifyData數(shù)據(jù)定義變量名稱變量命名長(zhǎng)度定義說(shuō)明接口名稱interfaceName＝16取值：“ICBC_PERBANK_B2C”接口版本號(hào)interfaceVersionMAX(15)取值：“”交易日期時(shí)間orderDate=14格式為：YYYYMMDDHHmmss要求在銀行系統(tǒng)當(dāng)前時(shí)間的前1小時(shí)和后12小時(shí)范圍內(nèi)，否則判定交易時(shí)間非法。由客戶端瀏覽器支付完成后提交通知結(jié)果時(shí)是明文傳輸，建議商戶對(duì)此變量使用額外安全防范措施，如簽名、base64 tranData格式定義tranData格式(xml格式固定，選輸字段的取值可以為空，標(biāo)簽需保留)?xml version= encoding=GBK standalone=no?B2CReq interfaceName/interfaceName interfaceVersion/interfaceVersion orderInfo orderDate/orderDate orderid/orderid amount/amount curType/curType merID/merID merAcct/merAcct /orderInfo custom verifyJoinFlag/verifyJoinFlag Language/Language /custom message goodsID/goodsID goodsName/goodsName goodsNum/goodsNum carriageAmt/carriageAmt merHint/merHint remark1/remark1 remark2/remark2 merURL/merURL merVAR/merVAR /message/B2CReq 表單樣例表單數(shù)據(jù)：INPUT NAME=interfaceName TYPE=text value=ICBC_PERBANK_B2C INPUT NAME=interfaceVersion TYPE=text value=INPUT NAME=tranData TYPE=text value=PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iR0JLIiBzdGFuZGFsb25lPSJubyI/PjxCMkNSZXE+PGludGVyZmFjZU5hbWU+SUNCQ19QRVJCQU5LX0IyQzwvaW50ZXJmYWNlTmFtZT48aW50ZXJmYWNlVmVyc2lvbj4xLjAuMC4zPC9pbnRlcmZhY2VWZXJzaW9uP
公司管理相關(guān)推薦
鄂ICP備17016276號(hào)-1