中國工商銀行網(wǎng)上銀行網(wǎng)上支付接口規(guī)范-資料下載頁
2025-04-07 22:46本頁面
【正文】 kFjY3Q+MDIwMDAyMDQwOTAxNTAyOTEzMDwvbWVyQWNjdD48L29yZGVySW5mbz48Y3VzdG9tPjx2ZXJpZnlKb2luRmxhZz4wPC92ZXJpZnlKb2luRmxhZz48Sm9pbkZsYWc+PC9Kb2luRmxhZz48VXNlck51bT48L1VzZXJOdW0+PC9jdXN0b20+PGJhbms+PFRyYW5TZXJpYWxObz48L1RyYW5TZXJpYWxObz48bm90aWZ5RGF0ZT4yMDA3MDcyNTExMDQwMDwvbm90aWZ5RGF0ZT48dHJhblN0YXQ+MTwvdHJhblN0YXQ+PGNvbW1lbnQ+vbvS17PJuaajoTwvY29tbWVudD48L2Jhbms+PC9CMkNSZXM+INPUT TYPE=hidden NAME=signMsg VALUE=UYE6nBdgkaV1uxZPzyIG5BYZmVvDl29tIvmp4XxWBsVxsw++yNwi86pYO/Wa8Kb7yMa8SueJA1Md8rDOlLGiSi/qSuJZ/lz/zM6lqpDvZgCjXSwFfcgoZJgZAFFxGOHjqBzOlp5k/WnG+9JJO20ROoF2a5lLhKXa509H6Mk4YUY=notifyData對應的明文：?xml version= encoding=GBK standalone=no ?B2CResinterfaceNameICBC_PERBANK_B2C/interfaceNameinterfaceVersion/interfaceVersionorderInfoorderDate20070725105014/orderDateorderid200707251050142134062548/orderidamount20/amountcurType001/curTypemerID0200EC20000875/merIDmerAcct0200020409015029130/merAcct/orderInfocustomverifyJoinFlag0/verifyJoinFlagJoinFlag/JoinFlagUserNum/UserNum/custombankTranSerialNo/TranSerialNonotifyDate20070725110400/notifyDatetranStat1/tranStatment交易成功！/ment/bank/B2CRes 說明商戶可能收到的銀行通知指令成功：只能有一筆成功、且要驗證銀行簽名、訂單金額等信息是否與商戶端記錄一致。指令失?。鹤⒁饪赡苁盏蕉喙P失敗?？蛻糁Ц妒r可以重提此筆訂單到銀行支付。指令可疑：由于網(wǎng)銀系統(tǒng)與后臺業(yè)務處理系統(tǒng)間通訊異常，造成網(wǎng)銀不能確認支付指令結果，則此筆指令為可疑指令；可疑指令將被自動批復，商戶、客戶可于第二日查詢指令狀態(tài)。沒有收到客戶瀏覽器轉發(fā)的銀行通知：由于客戶瀏覽器端或互聯(lián)網(wǎng)通訊等原因可能造成商戶端接收不到客戶瀏覽器提交的銀行通知。當沒有收到銀行通知時，可登錄工行商戶服務網(wǎng)站手工查詢指令狀態(tài)或者商戶調用查詢接口自動處理。商戶提交的訂單信息和銀行返回的通知消息都是xml串，并且進行了BASE64編碼；提交和返回的xml都應有xml頭；第 3 章 安全API說明為了保證商戶提交訂單數(shù)據(jù)和銀行通知信息數(shù)據(jù)的完整性，不可抵賴性，現(xiàn)提供一套用于信息簽名、驗簽和BASE64編解碼的函數(shù)。商戶開發(fā)時使用這套函數(shù)和工行頒發(fā)的商戶證書進行商戶訂單信息簽名；簽名數(shù)據(jù)項和順序均固定，具體格式可參見上文的數(shù)據(jù)定義；同時使用這套API和銀行公鑰可以驗證銀行通知消息的有效性。安全API的使用方法可參見相關開發(fā)語言的說明和demo程序；第 4 章 開發(fā)步驟商戶程序需在銀行模擬測試環(huán)境上進行聯(lián)調后，再投產，以下說明聯(lián)調開發(fā)步驟。生成訂單： 商戶和當?shù)匦新?lián)系，申請聯(lián)調測試；由當?shù)匦性谀M測試環(huán)境錄入商戶信息，生成商戶證書（pfx格式）；并提供銀行模擬測試環(huán)境的銀行證書公鑰文件（用于驗證銀行簽名時使用）； 商戶或者銀行用證書拆分工具將pfx格式的商戶證書拆分成擴展名為crt的公鑰文件和擴展名為key的私鑰文件；（這兩個文件用于商戶開發(fā)API調用來進行商戶訂單數(shù)據(jù)簽名） 商戶進行開發(fā)，準備要求的訂單數(shù)據(jù)； 其中訂單簽名數(shù)據(jù)merSignMsg字段是對明文的簽名數(shù)據(jù)；需要使用提供的API函數(shù)和商戶私鑰進行簽名，得到簽名串，然后做BASE64編碼； 其中商城證書公鑰merCert字段需要使用API函數(shù)做BASE64編碼； 準備好訂單數(shù)據(jù)，即完成訂單提交的開發(fā)；之后只要將訂單提交銀行接收入口“://銀行地址/servlet/ICBCINBSEBusinessServlet”，銀行來處理B2C指令的資金支付；接收通知：交易處理后，會將客戶定向回商戶網(wǎng)站，此時包含交易結果信息和銀行簽名。商戶接收到銀行通知后，需使用開發(fā)API和銀行公鑰來驗證銀行簽名，以確保通知消息的有效性，以下簡要說明驗證步驟： 獲得各字段取值后，注意提交的明文需要進行base64解碼才能獲得。使用商戶開發(fā)API和銀行公鑰文件對表單中的銀行簽名signMsg進行驗簽； 驗簽成功后，為確保數(shù)據(jù)一致，建議商戶比較一下通知消息中訂單金額、賣家卡號等關鍵信息和自己記錄的是否一致； 商戶根據(jù)交易結果tranStat來更新自己的指令狀態(tài)和相關數(shù)據(jù)庫信息；13 / 13
公司管理相關推薦
鄂ICP備17016276號-1