中國工商銀行網(wǎng)上銀行網(wǎng)上支付接口規(guī)范(已修改)
2025-04-19 22:46 本頁面
【正文】 商戶手冊中國工商銀行軟件開發(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ù)處理。（擴(kuò)充語言字段以支持英文版）在訂單中要求商戶選擇通知方式，即需要銀行通知交易結(jié)果，不需要銀行通知交易結(jié)果而是商戶主動(dòng)查詢；當(dāng)需要通知時(shí)，需要在訂單中提供商戶接收銀行通知地址，當(dāng)銀行處理結(jié)束后，會(huì)在銀行的后臺(tái)服務(wù)器請求商戶的此地址，將交易結(jié)果用連接post表單形式提交給商戶，然后返回客戶交易結(jié)果頁面。，和接收銀行通知的地址；此版本要求商戶在提交訂單時(shí)，提供交易處理后返回商戶的地址，即完成客戶從商戶轉(zhuǎn)向到銀行進(jìn)行支付，處理后又從銀行定向回商戶網(wǎng)站的閉環(huán)。在從銀行交易頁面返回商戶時(shí)，將交易結(jié)果作為表單數(shù)據(jù)提交到商戶此返回地址。處理的優(yōu)點(diǎn)：強(qiáng)制完成交易閉環(huán)；無需銀行后臺(tái)發(fā)送通知，客戶不需要等待商戶接收銀行通知后才能看到交易結(jié)果頁面，縮短響應(yīng)時(shí)間；通知方式不再局限于連接和80端口，返回商戶的地址可以使用方式和其他商戶支持的端口，提高安全性；銀行作為交易的一方，支持眾多商戶和客戶時(shí)，存在一定的帶寬和服務(wù)器處理壓力，使用客戶返回商戶方式提供交易結(jié)果，可有效減少交易掉單現(xiàn)象，只要客戶到了銀行的結(jié)果頁面，如果還出現(xiàn)掉單問題，則可能是客戶和商戶的通訊等方面的問題。以下簡述處理流程：1. 客戶在商戶網(wǎng)站瀏覽商品信息，簽訂訂單；2. ，并使用工行提供API和商戶證書對(duì)訂單數(shù)據(jù)簽名，形成form表單返回客戶瀏覽器，表單action地址指向工行接收商戶訂單信息的servlet；3. 客戶確認(rèn)使用工行支付后，提交此表單到工行；4. 工行網(wǎng)銀系統(tǒng)接收此筆訂單，對(duì)訂單信息和商戶信息進(jìn)行檢查；5. 通過檢查則顯示工行支付頁面，；6. 客戶輸入后提交；7. 銀行查詢客戶相關(guān)信息；8. 返回客戶在銀行的預(yù)留信息；9. 客戶確認(rèn)；10. 返回交易確認(rèn)頁面；11. 不同類型客戶使用各自認(rèn)證方式進(jìn)行交易確認(rèn)，支持靜態(tài)支付密碼、動(dòng)態(tài)口令卡、證書簽名；12. 銀行校驗(yàn)后進(jìn)行支付處理；13. 將結(jié)果形成通知消息并有銀行端簽名信息，返回客戶端；14. 引導(dǎo)客戶返回商戶網(wǎng)站，地址是訂單中提供的商戶url，此url支持和及自定義端口；B2C在線支付接口版本說明：（基本支付）（支持英文界面）（內(nèi)部保留）（，優(yōu)化通知方式）（商戶訂單中指定支付卡，不強(qiáng)制使用e卡支付，不允許客戶的支付卡透支支付，專門用于基金商戶進(jìn)行基金直銷業(yè)務(wù)，）通知消息模式區(qū)別：原有模式：支付處理后，后臺(tái)發(fā)送商戶通知；新增模式：支付完成后或客戶點(diǎn)擊“返回商戶”，利用客戶瀏覽器跳轉(zhuǎn)，完成商戶通知的轉(zhuǎn)發(fā)，后臺(tái)不再單獨(dú)發(fā)送商戶通知。對(duì)于不同類型商戶接口區(qū)別：第 2 章 商戶接口接口定義通過接口名稱和接口版本號(hào)來標(biāo)識(shí)，以便將來的擴(kuò)展；新通知方式的B2C接口稱為新模式B2C接口；原有后臺(tái)發(fā)送通知的方式稱為原模式接口； 支付接口 支付接口表單定義新模式接口的交易數(shù)據(jù)整合到一個(gè)xml格式串，作為表單的一項(xiàng)整體提交，不再同原來每個(gè)字段都是keyvalue形式；FORM表單數(shù)據(jù)如下：變量名稱變量命名長度定義說明接口名稱interfaceNameMAX(30)必輸，取值：“ICBC_PERBANK_B2C”接口版本號(hào)interfaceVersionMAX(15)必輸，取值：“”交易數(shù)據(jù)tranData無限制必輸，簽名；整合所有交易數(shù)據(jù)形成的xml明文串，并做BASE64編碼；具體格式定義見下文；注意：需有xml頭屬性；整個(gè)字段使用BASE64編碼；xml明文中沒有回車換行和多余空格；訂單簽名數(shù)據(jù)merSignMsg無限制必輸，商戶使用工行提供的簽名API和商戶證書將tranData的xml明文串進(jìn)行簽名，得到二進(jìn)制簽名數(shù)據(jù)，然后進(jìn)行BASE64編碼后得到可視的merSignMsg；注意：簽名時(shí)是針對(duì)tranData的xml明文，不是將tranData進(jìn)行BASE64編碼后的串；商城證書公鑰merCert無限制必輸，商戶用二進(jìn)制方式讀取證書公鑰文件后，進(jìn)行BASE64編碼后產(chǎn)生的字符串；注：數(shù)據(jù)中不能包含“|”、“amp?！薄ⅰ?”，這些字符為銀行端程序保留字符；中文變量使用GBK編碼。 從商戶Post過來的數(shù)據(jù)，參數(shù)名的名稱必須與上表中完全相同，名稱中的字母大小寫均要相同，不能進(jìn)行隨意更改(在form中的提交按鈕input type=”submit”……中submit不能有Name屬性)；此外，如果其他input 項(xiàng)的Name中使用了雙引號(hào)，如：input type=text name= merCert val
公司管理相關(guān)推薦
鄂ICP備17016276號(hào)-1