中國工商銀行網上銀行網上支付接口規(guī)范-在線瀏覽
2025-05-25 22:46本頁面
【正文】 需要銀行通知交易結果而是商戶主動查詢；當需要通知時，需要在訂單中提供商戶接收銀行通知地址，當銀行處理結束后，會在銀行的后臺服務器請求商戶的此地址，將交易結果用連接post表單形式提交給商戶，然后返回客戶交易結果頁面。在從銀行交易頁面返回商戶時，將交易結果作為表單數據提交到商戶此返回地址。以下簡述處理流程：1. 客戶在商戶網站瀏覽商品信息，簽訂訂單；2. ，并使用工行提供API和商戶證書對訂單數據簽名，形成form表單返回客戶瀏覽器，表單action地址指向工行接收商戶訂單信息的servlet；3. 客戶確認使用工行支付后，提交此表單到工行；4. 工行網銀系統(tǒng)接收此筆訂單，對訂單信息和商戶信息進行檢查；5. 通過檢查則顯示工行支付頁面，；6. 客戶輸入后提交；7. 銀行查詢客戶相關信息；8. 返回客戶在銀行的預留信息；9. 客戶確認；10. 返回交易確認頁面；11. 不同類型客戶使用各自認證方式進行交易確認，支持靜態(tài)支付密碼、動態(tài)口令卡、證書簽名；12. 銀行校驗后進行支付處理；13. 將結果形成通知消息并有銀行端簽名信息，返回客戶端；14. 引導客戶返回商戶網站，地址是訂單中提供的商戶url，此url支持和及自定義端口；B2C在線支付接口版本說明：（基本支付）（支持英文界面）（內部保留）（，優(yōu)化通知方式）（商戶訂單中指定支付卡，不強制使用e卡支付，不允許客戶的支付卡透支支付，專門用于基金商戶進行基金直銷業(yè)務，）通知消息模式區(qū)別：原有模式：支付處理后，后臺發(fā)送商戶通知；新增模式：支付完成后或客戶點擊“返回商戶”，利用客戶瀏覽器跳轉，完成商戶通知的轉發(fā)，后臺不再單獨發(fā)送商戶通知?！?、“=”，這些字符為銀行端程序保留字符；中文變量使用GBK編碼。商戶提交數據中的空格將被認為是有效字符被接收，請商戶開發(fā)時注意對多余空格的控制。訂單號orderidMAX(30)必輸，客戶支付后商戶網站產生的一個唯一的定單號，該訂單號應該在相當長的時間內不重復。訂單金額amountMAX(10)必輸，客戶支付訂單的總金額，一筆訂單一個，以分為單位。支付幣種curType= 3必輸，用來區(qū)分一筆支付的幣種，目前工行只支持使用人民幣（001）支付。商戶賬號merAcctMAX(19)必輸，商戶入賬賬號，只能交易時指定。語言版本LanguageMAX(10)選輸，默認為中文版取值：“EN_US”為英文版；取值：“ZH_CN”或其他為中文版。商品編號goodsIDMAX(30)選輸商品名稱goodsNameMAX(60)選輸商品數量goodsNumMAX(10)選輸已含運費金額carriageAmtMAX(10)選輸商城提示merHintMAX(120)選輸備注字段1remark1MAX(100)選輸 單位：字節(jié)備注字段2remark2MAX(100)選輸 單位：字節(jié)返回商戶URLmerURLMAX(1024)必輸必須合法的URL，交易結束，將客戶引導到商戶的此url，即通過客戶瀏覽器post交易結果信息到商戶的此URL返回商戶變量merVARMAX(1024)選輸商戶自定義，當返回銀行結果時，作為一個隱藏域變量，商戶可以用此變量維護session等等。由客戶端瀏覽器支付完成后提交通知結果時是明文傳輸，建議商戶對此變量使用額外安全防范措施，如簽名、base64，銀行端將此字段原樣返回通知結果數據notifyData無限制銀行通知消息，xml格式定義見下文，提交商戶時對xml明文串進行了base64編碼；xml串中沒有回車換行和多余空格；包含xml頭屬性，且格式固定；銀行對通知結果的簽名數據signMsg無限制銀行使用自己證書對商戶通知消息notifyData字段的xml格式明文串進行的簽名，然后進行BASE64編碼后的字符串。訂單號orderidMAX(30)客戶支付后商戶網站產生的一個唯一的定單號，該訂單號應該在相當長的時間內不重復。訂單金額amountMAX(10)客戶支付訂單的總金額，一筆訂單一個，以分為單位。支付幣種curType= 3用來區(qū)分一筆支付的幣種，目前工行只支持使用人民幣（001）支付。商戶賬號merAcctMAX(19)商戶收費入賬賬號 （只能交易時指定）。客戶聯名標志JoinFlag=1客戶在銀行端是否與商城聯名標志位。銀行指令序號TranSerialNoMAX(30)銀行端指令流水號返回通知日期時間notifyDateMAX(14)格式為：YYYYMMDDHHmmss訂單處理狀態(tài)tranStat=11“交易成功，已清算”；2“交易失敗”；3“交易可疑”錯誤描述mentMAX(100)錯誤描述 notifyData格式定義notifyData格式(xml格式固定，選輸字段的取值可以為空，標簽需保留)?xml version= encoding=GBK standalone=no?B2CRes interfaceName/interfaceName interfaceVersion/interfaceVersion orderInfo orde
公司管理相關推薦
鄂ICP備17016276號-1