中國工商銀行網(wǎng)上銀行網(wǎng)上支付接口規(guī)范(存儲版)
【正文】 商戶可能收到的銀行通知指令成功：只能有一筆成功、且要驗證銀行簽名、訂單金額等信息是否與商戶端記錄一致。訂單金額amountMAX(10)客戶支付訂單的總金額，一筆訂單一個，以分為單位。語言版本LanguageMAX(10)選輸，默認為中文版取值：“EN_US”為英文版；取值：“ZH_CN”或其他為中文版。訂單號orderidMAX(30)必輸，客戶支付后商戶網(wǎng)站產(chǎn)生的一個唯一的定單號，該訂單號應(yīng)該在相當(dāng)長的時間內(nèi)不重復(fù)。在從銀行交易頁面返回商戶時，將交易結(jié)果作為表單數(shù)據(jù)提交到商戶此返回地址。處理的優(yōu)點：強制完成交易閉環(huán)；無需銀行后臺發(fā)送通知，客戶不需要等待商戶接收銀行通知后才能看到交易結(jié)果頁面，縮短響應(yīng)時間；通知方式不再局限于連接和80端口，返回商戶的地址可以使用方式和其他商戶支持的端口，提高安全性；銀行作為交易的一方，支持眾多商戶和客戶時，存在一定的帶寬和服務(wù)器處理壓力，使用客戶返回商戶方式提供交易結(jié)果，可有效減少交易掉單現(xiàn)象，只要客戶到了銀行的結(jié)果頁面，如果還出現(xiàn)掉單問題，則可能是客戶和商戶的通訊等方面的問題。工行通過訂單號加訂單日期來唯一確認一筆訂單的重復(fù)性。注意：大小寫敏感。不可以為零，必需符合金額標(biāo)準(zhǔn)。指令失敗：注意可能收到多筆失敗。生成訂單： 商戶和當(dāng)?shù)匦新?lián)系，申請聯(lián)調(diào)測試；由當(dāng)?shù)匦性谀M測試環(huán)境錄入商戶信息，生成商戶證書（pfx格式）；并提供銀行模擬測試環(huán)境的銀行證書公鑰文件（用于驗證銀行簽名時使用）； 商戶或者銀行用證書拆分工具將pfx格式的商戶證書拆分成擴展名為crt的公鑰文件和擴展名為key的私鑰文件；（這兩個文件用于商戶開發(fā)API調(diào)用來進行商戶訂單數(shù)據(jù)簽名） 商戶進行開發(fā)，準(zhǔn)備要求的訂單數(shù)據(jù)； 其中訂單簽名數(shù)據(jù)merSignMsg字段是對明文的簽名數(shù)據(jù)；需要使用提供的API函數(shù)和商戶私鑰進行簽名，得到簽名串，然后做BASE64編碼； 其中商城證書公鑰merCert字段需要使用API函數(shù)做BASE64編碼； 準(zhǔn)備好訂單數(shù)據(jù)，即完成訂單提交的開發(fā)；之后只要將訂單提交銀行接收入口“://銀行地址/servlet/ICBCINBSEBusinessServlet”，銀行來處理B2C指令的資金支付；接收通知：交易處理后，會將客戶定向回商戶網(wǎng)站，此時包含交易結(jié)果信息和銀行簽名。商戶開發(fā)時使用這套函數(shù)和工行頒發(fā)的商戶證書進行商戶訂單信息簽名；簽名數(shù)據(jù)項和順序均固定，具體格式可參見上文的數(shù)據(jù)定義；同時使用這套API和銀行公鑰可以驗證銀行通知消息的有效性。1客戶聯(lián)名 0客戶未聯(lián)名聯(lián)名會員號UserNumMAX(40)聯(lián)名客戶在商戶的會員號。工行通過訂單號加訂單日期來唯一確認一筆訂單的重復(fù)性。（商戶付給銀行手續(xù)費的賬戶，可以在開戶的時候指定，也可以用交易指定方式；用交易指定方式則使用此商戶賬號）檢驗聯(lián)名標(biāo)志verifyJoinFlag=1必輸， 取值“1”：客戶支付時，網(wǎng)銀判斷該客戶是否與商戶聯(lián)名，是則按上送金額扣帳，否則展現(xiàn)未聯(lián)名錯誤；取值“0”：不檢驗客戶是否與商戶聯(lián)名，按上送金額扣帳。tranData交易數(shù)據(jù)的xml串需要有xml的頭，即?xml version= encoding=GBK standalone=no? tranData數(shù)據(jù)定義變量名稱變量命名長度定義說明接口名稱interfaceName＝16必輸，取值：“ICBC_PERBANK_B2C”接口版本號interfaceVersionMAX(15)必輸，取值：“”交易日期時間orderDate=14必輸，格式為：YYYYMMDDHHmmss要求在銀行系統(tǒng)當(dāng)前時間的前1小時和后12小時范圍內(nèi)，否則判定交易時間非法。，和接收銀行通知的地址；此版本要求商戶在提交訂單時，提供交易處理后返回商戶的地址，即完成客戶從商戶轉(zhuǎn)向到銀行進行支付，處理后又從銀行定向回商戶網(wǎng)站的閉環(huán)。以下簡述處理流程：1. 客戶在商戶網(wǎng)站瀏覽商品信息，簽訂訂單；2. ，并使用工行提供API和商戶證書對訂單數(shù)據(jù)簽名，形成form表單返回客戶瀏覽器，表單action地址指向工行接收商戶訂單信息的servlet；3. 客戶確認使用工行支付后，提交此表單到工行；4. 工行網(wǎng)銀系統(tǒng)接收此筆訂單，對訂單信息和商戶信息進行檢查；5. 通過檢查則顯示工行支付頁面，；6. 客戶輸入后提交；7. 銀行查詢客戶相關(guān)信息；8. 返回客戶在銀行的預(yù)留信息；9. 客戶確認；10. 返回交易確認頁面；11. 不同類型客戶使用各自認證方式進行交易確認，支持靜態(tài)支付密碼、動態(tài)口令卡、證書簽名；12. 銀行校驗后進行支付處理；13. 將結(jié)果形成通知消息并有銀行端簽名信息，返回客戶端；14. 引導(dǎo)客戶返回商戶網(wǎng)站，地址是訂單中提供的商戶url，此url支持和及自定義端口；B2C在線支付接口版本說明：（基本支付）（支持英文界面）（內(nèi)部保留）（，優(yōu)化通知方式）（商戶訂單中指定支付卡，不強制使用e卡支付，不允許客戶的支付卡透支支付，專門用于基金商戶進行基金直銷業(yè)務(wù)，）通知消息模式區(qū)別：原有模式：支付處理后，后臺發(fā)送商戶通知；新增模式：支付完成后或客戶點擊“返回商戶”，利用客戶瀏覽器跳轉(zhuǎn)，完成商戶通知的轉(zhuǎn)發(fā)，后臺不再單獨發(fā)送商戶通知。訂單金額amountMAX(10)必輸，客戶支付訂單的總金額，一筆訂單一個，以分為單位。商品編號
公司管理相關(guān)推薦
鄂ICP備17016276號-1