中國(guó)工商銀行網(wǎng)上銀行網(wǎng)上支付接口規(guī)范-全文預(yù)覽
【正文】 ，然后做BASE64編碼； 其中商城證書(shū)公鑰merCert字段需要使用API函數(shù)做BASE64編碼； 準(zhǔn)備好訂單數(shù)據(jù)，即完成訂單提交的開(kāi)發(fā)；之后只要將訂單提交銀行接收入口“://銀行地址/servlet/ICBCINBSEBusinessServlet”，銀行來(lái)處理B2C指令的資金支付；接收通知：交易處理后，會(huì)將客戶(hù)定向回商戶(hù)網(wǎng)站，此時(shí)包含交易結(jié)果信息和銀行簽名。當(dāng)沒(méi)有收到銀行通知時(shí)，可登錄工行商戶(hù)服務(wù)網(wǎng)站手工查詢(xún)指令狀態(tài)或者商戶(hù)調(diào)用查詢(xún)接口自動(dòng)處理。指令失敗：注意可能收到多筆失敗。檢驗(yàn)聯(lián)名標(biāo)志verifyJoinFlag=1取值“1”：客戶(hù)支付時(shí)，網(wǎng)銀判斷該客戶(hù)是否與商戶(hù)聯(lián)名，是則按上送金額扣帳，否則展現(xiàn)未聯(lián)名錯(cuò)誤；取值“0”：不檢驗(yàn)客戶(hù)是否與商戶(hù)聯(lián)名，按上送金額扣帳。不可以為零，必需符合金額標(biāo)準(zhǔn)。注意：簽名是對(duì)notifyData的xml明文進(jìn)行簽名，不是其BASE64編碼后的串；簽名后得到二進(jìn)制數(shù)據(jù)，對(duì)此數(shù)據(jù)進(jìn)行BASE64編碼得到signMsg notifyData數(shù)據(jù)定義變量名稱(chēng)變量命名長(zhǎng)度定義說(shuō)明接口名稱(chēng)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í)間非法。注意：大小寫(xiě)敏感。取值： “001”商戶(hù)代碼merIDMAX(20)必輸，唯一確定一個(gè)商戶(hù)的代碼，由商戶(hù)在工行開(kāi)戶(hù)時(shí)，由工行告知商戶(hù)。工行通過(guò)訂單號(hào)加訂單日期來(lái)唯一確認(rèn)一筆訂單的重復(fù)性。 從商戶(hù)Post過(guò)來(lái)的數(shù)據(jù)，參數(shù)名的名稱(chēng)必須與上表中完全相同，名稱(chēng)中的字母大小寫(xiě)均要相同，不能進(jìn)行隨意更改(在form中的提交按鈕input type=”submit”……中submit不能有Name屬性)；此外，如果其他input 項(xiàng)的Name中使用了雙引號(hào)，如：input type=text name= merCert value=xxxxxxx，則一定注意在引號(hào)內(nèi)不要包含空格，不要寫(xiě)成“mer URL ”，如果拼寫(xiě)錯(cuò)誤或者多了空格，將造成數(shù)據(jù)無(wú)法識(shí)別，無(wú)法正常進(jìn)行支付接口名稱(chēng)和版本號(hào)一定要和上表中相同.。處理的優(yōu)點(diǎn)：強(qiáng)制完成交易閉環(huán)；無(wú)需銀行后臺(tái)發(fā)送通知，客戶(hù)不需要等待商戶(hù)接收銀行通知后才能看到交易結(jié)果頁(yè)面，縮短響應(yīng)時(shí)間；通知方式不再局限于連接和80端口，返回商戶(hù)的地址可以使用方式和其他商戶(hù)支持的端口，提高安全性；銀行作為交易的一方，支持眾多商戶(hù)和客戶(hù)時(shí)，存在一定的帶寬和服務(wù)器處理壓力，使用客戶(hù)返回商戶(hù)方式提供交易結(jié)果，可有效減少交易掉單現(xiàn)象，只要客戶(hù)到了銀行的結(jié)果頁(yè)面，如果還出現(xiàn)掉單問(wèn)題，則可能是客戶(hù)和商戶(hù)的通訊等方面的問(wèn)題。 商戶(hù)手冊(cè)中國(guó)工商銀行軟件開(kāi)發(fā)中心Copyright Reserved目錄第 1 章 業(yè)務(wù)說(shuō)明 3第 2 章 商戶(hù)接口 4 支付接口 5 支付接口表單定義 5 tranData數(shù)據(jù)定義 6 tranData格式定義 7 表單樣例 8 通知接口 9 通知接口表單定義 9 notifyData數(shù)據(jù)定義 10 notifyData格式定義 11 表單樣例 11 說(shuō)明 12第 3 章 安全API說(shuō)明 13第 4 章 開(kāi)發(fā)步驟 13第 1 章 業(yè)務(wù)說(shuō)明B2C在線支付接口實(shí)現(xiàn)工行個(gè)人網(wǎng)銀客戶(hù)在工行B2C商戶(hù)網(wǎng)站進(jìn)行消費(fèi)支付的業(yè)務(wù)處理。在從銀行交易頁(yè)面返回商戶(hù)時(shí)，將交易結(jié)果作為表單數(shù)據(jù)提交到商戶(hù)此返回地址?！?、“=”，這些字符為銀行端程序保留字符；中文變量使用GBK編碼。訂單號(hào)orderidMAX(30)必輸，客戶(hù)支付后商戶(hù)網(wǎng)站產(chǎn)生的一個(gè)唯一的定單號(hào)，該訂單號(hào)應(yīng)該在相當(dāng)長(zhǎng)的時(shí)間內(nèi)不重復(fù)。支付幣種curType= 3必輸，用來(lái)區(qū)分一筆支付的幣種，目前工行只支持使用人民幣（001）支付。語(yǔ)言版本LanguageMAX(10)選輸，默認(rèn)為中文版取值：“EN_US”為英文版；取值：“ZH_CN”或其他為中文版。由客戶(hù)端瀏覽器支付完成后提交通知結(jié)果時(shí)是明文傳輸，建議商戶(hù)對(duì)此變量使用額外安全防范措施，如簽名、base64，銀行端將此字段原樣返回通知結(jié)果數(shù)據(jù)notifyData無(wú)限制銀行通知消息，xml格式定義見(jiàn)下文，提交商戶(hù)時(shí)對(duì)xml明文串進(jìn)行了base64編碼；xml串中沒(méi)有回車(chē)換行和多余空格；包含xml頭屬性，且格式固定；銀行對(duì)通知結(jié)果的簽名數(shù)據(jù)signMsg無(wú)限制銀行使用自己證書(shū)對(duì)商戶(hù)通知消息notifyData字段的xml格式明文串進(jìn)行的簽名，然后進(jìn)行BASE64編碼后的字符串。訂單金額amountMAX(10)客戶(hù)支付訂單的總金額，一筆訂單一個(gè)，以分為單位。商戶(hù)賬號(hào)merAcctMAX(19)商戶(hù)收費(fèi)入賬賬號(hào) （只能交易時(shí)指定）。銀行指令序號(hào)TranSerialNoMAX(30)銀行端指令流水號(hào)返回通知日期時(shí)間notifyDateMAX(14)格式為：YYYYMMDDHHmmss訂單處理狀態(tài)tranStat=11“
公司管理相關(guān)推薦
鄂ICP備17016276號(hào)-1