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