中國(guó)工商銀行網(wǎng)上銀行網(wǎng)上支付接口規(guī)范-展示頁(yè)
2025-04-16 22:46本頁(yè)面
【正文】 通知接口表單定義變量名稱變量命名長(zhǎng)度定義說明返回商戶變量merVAR無限制取值：商戶提交接口中merVAR字段當(dāng)返回銀行結(jié)果時(shí)，作為一個(gè)隱藏域變量，商戶可以用此變量維護(hù)session等等。注意：大小寫敏感。（商戶付給銀行手續(xù)費(fèi)的賬戶，可以在開戶的時(shí)候指定，也可以用交易指定方式；用交易指定方式則使用此商戶賬號(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è)商戶的代碼，由商戶在工行開戶時(shí)，由工行告知商戶。不可以為零，必需符合金額標(biāo)準(zhǔn)。工行通過訂單號(hào)加訂單日期來唯一確認(rèn)一筆訂單的重復(fù)性。tranData交易數(shù)據(jù)的xml串需要有xml的頭，即?xml version= encoding=GBK standalone=no? tranData數(shù)據(jù)定義變量名稱變量命名長(zhǎ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í)間非法。 從商戶Post過來的數(shù)據(jù)，參數(shù)名的名稱必須與上表中完全相同，名稱中的字母大小寫均要相同，不能進(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)不要包含空格，不要寫成“mer URL ”，如果拼寫錯(cuò)誤或者多了空格，將造成數(shù)據(jù)無法識(shí)別，無法正常進(jìn)行支付接口名稱和版本號(hào)一定要和上表中相同.。對(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ù)如下：變量名稱變量命名長(zhǎng)度定義說明接口名稱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。處理的優(yōu)點(diǎn)：強(qiáng)制完成交易閉環(huán)；無需銀行后臺(tái)發(fā)送通知，客戶不需要等待商戶接收銀行通知后才能看到交易結(jié)果頁(yè)面，縮短響應(yīng)時(shí)間；通知方式不再局限于連接和80端口，返回商戶的地址可以使用方式和其他商戶支持的端口，提高安全性；銀行作為交易的一方，支持眾多商戶和客戶時(shí)，存在一定的帶寬和服務(wù)器處理壓力，使用客戶返回商戶方式提供交易結(jié)果，可有效減少交易掉單現(xiàn)象，只要客戶到了銀行的結(jié)果頁(yè)面，如果還出現(xiàn)掉單問題，則可能是客戶和商戶的通訊等方面的問題。，和接收銀行通知的地址；此版本要求商戶在提交訂單時(shí)，提供交易處理后返回商戶的地址，即完成客戶從商戶轉(zhuǎn)向到銀行進(jìn)行支付，處理后又從銀行定向回商戶網(wǎng)站的閉環(huán)。 商戶手冊(cè)中國(guó)工商銀行軟件開發(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ò)充語(yǔ)言字段以支持英文版）在訂單中要求商戶選擇通知方式，即需要銀行通知交易結(jié)果，不
公司管理相關(guān)推薦
鄂ICP備17016276號(hào)-1