中國工商銀行網(wǎng)上銀行c2c在線支付接口說明v1001(編輯修改稿)
2025-05-04 22:46 本頁面
【文章內(nèi)容簡介】 ，銀行只向商戶發(fā)送交易成功的通知信息。交易日期時(shí)間orderDate=14格式為：YYYYMMDDHHmmss要求在銀行系統(tǒng)當(dāng)前時(shí)間的前1小時(shí)和后12小時(shí)范圍內(nèi)，否則判定交易時(shí)間非法。返回通知日期時(shí)間notifyDateMAX(14)格式為：YYYYMMDDHHmmss訂單處理狀態(tài)tranStat=11“交易成功，已清算”；2“交易失敗”；3“交易可疑”錯(cuò)誤描述mentMAX(100)錯(cuò)誤描述備注1remark1MAX(100)備注備注2remark2MAX(100)備注通知消息銀行簽名數(shù)據(jù)bankSignMsg無限制銀行使用自己證書對(duì)商戶通知消息按照一定格式進(jìn)行的簽名,然后進(jìn)行BASE64編碼后的字符串。（格式單獨(dú)描述）通知消息銀行簽名數(shù)據(jù)bankSignMsg格式：根據(jù)消息中各數(shù)據(jù)項(xiàng)，使用amp。符進(jìn)行連接成銀行端簽名明文，各字段順序固定；每個(gè)數(shù)據(jù)項(xiàng)由變量名稱加等號(hào)加變量值組成；如果變量值為空仍保留字段位置；格式說明：接口名稱amp。接口版本號(hào)amp。訂單號(hào)amp。指令序號(hào)amp。訂單金額amp。商城收費(fèi)金額amp。支付幣種amp。商城代碼amp。商城賬號(hào)amp。賣家收款卡號(hào)amp。賣家收款名稱amp。買家收款卡號(hào)amp。買家付款名稱amp。校驗(yàn)聯(lián)名標(biāo)志 amp?？蛻袈?lián)名標(biāo)志amp。聯(lián)名會(huì)員號(hào)amp。結(jié)果發(fā)送類型amp。交易日期時(shí)間amp。返回通知日期時(shí)間amp。訂單處理狀態(tài)amp。錯(cuò)誤描述amp。備注1amp。備注2interfaceName=值amp。interfaceVersion=值amp。orderID=值amp。 TranSerialNo =值amp。amount=值amp。merFeeAmt=值amp。curType=值amp。merID=值amp。merAcct=值amp。venderCardNum=值amp。venderName =值amp。customCardNum=值amp。customName=值amp。verifyJoinFlag=值amp。JoinFlag=值amp。UserNum =值amp。resultType=值amp。orderDate=值amp。notifyDate=值amp。tranStat=值amp。ment=值remark1=值amp。 remark2=值提示：以上格式為銀行端簽名明文格式，對(duì)于銀行簽名字段bankSignMsg，得到密文后進(jìn)行了BASE64編碼，所有字段在發(fā)出前取值部分都經(jīng)過urlEcode編碼（包括bankSignMsg字段）。商戶可能收到的銀行通知：指令成功：只能有一筆成功、且要驗(yàn)證銀行簽名、訂單金額等信息是否與商戶端記錄一致。指令失?。鹤⒁饪赡苁盏蕉喙P失敗?？蛻糁Ц妒r(shí)可以重提此筆訂單到銀行支付。指令可疑：由于網(wǎng)銀系統(tǒng)與后臺(tái)業(yè)務(wù)處理系統(tǒng)間通訊異常，造成網(wǎng)銀不能確認(rèn)支付指令結(jié)果，則此筆指令為可疑指令；可疑指令將被自動(dòng)批復(fù)，商戶、客戶可于第二日查詢指令狀態(tài)。沒有收到銀行通知：由于銀行、商戶兩端服務(wù)器或者互聯(lián)網(wǎng)通訊等原因可能造成商戶端接收不到銀行通知。當(dāng)沒有收到銀行通知時(shí)，可登錄工行商戶服務(wù)網(wǎng)站手工查詢指令狀態(tài)或者商戶調(diào)用查詢接口自動(dòng)處理。商戶返回取貨地址：取貨地址（也可稱為商戶收到銀行成功支付后的商戶端確認(rèn)地址）：如果有取貨地址則及時(shí)返回取貨地址，沒有取貨地址需及時(shí)關(guān)閉連接；因?yàn)殂y行端先進(jìn)行訂單支付清算，然后給商戶發(fā)送通知，在商戶返回取貨地址或者關(guān)閉連接后，才顯示交易結(jié)果給客戶，整個(gè)過程是串行的；如果商戶在收到銀行通知后，不及時(shí)返回或關(guān)閉連接，將可能造成客戶端等待超時(shí)，無法顯示最終的交易結(jié)果頁面。如果商戶端接收到銀行通知消息，進(jìn)行后續(xù)檢查和處理時(shí)，商戶自己程序出現(xiàn)異常，不應(yīng)將錯(cuò)誤信息返回給銀行。銀行只接收取貨地址的返回，商戶程序異常時(shí)，應(yīng)及時(shí)關(guān)閉和銀行的連接。如果商戶返回其他非取貨地址的信息，銀行端將驗(yàn)證返回信息不是有效的URL而記錄錯(cuò)誤日志，在給客戶的交易結(jié)果頁面不會(huì)有商戶返回的內(nèi)容。三、安全API說明：為了保證商戶提交訂單數(shù)據(jù)和銀行通知信息數(shù)據(jù)的完整性，不可抵賴性，現(xiàn)提供一套用于信息簽名、驗(yàn)簽和BASE64編解碼的函數(shù)。商戶開發(fā)時(shí)使用這套函數(shù)和工行頒發(fā)的商戶證書進(jìn)行商戶訂單信息簽名；簽名數(shù)據(jù)項(xiàng)和順序均固定，具體格式可參見上一節(jié)的數(shù)據(jù)定義；同時(shí)使用這套API和銀行公鑰可以驗(yàn)證銀行通知消息的有效性。安全API的使用方法可參見【開發(fā)API接口】目錄中不同開發(fā)語言的說明和demo程序；四、開發(fā)步驟商戶程序需在銀行模擬測(cè)試環(huán)境上進(jìn)行聯(lián)調(diào)后，再投產(chǎn)，以下說明聯(lián)調(diào)開發(fā)步驟。生成訂單： 商戶和當(dāng)?shù)匦新?lián)系，申請(qǐng)聯(lián)調(diào)測(cè)試；由當(dāng)?shù)匦性谀M測(cè)試環(huán)境錄入商戶信息，生成商戶證書（pfx格式）；并提供銀行模擬測(cè)試環(huán)境的銀行證書公鑰文件（用于驗(yàn)證銀行簽名時(shí)使用）； 商戶或者銀行用證書拆分工具將pfx格式的商戶證書拆分成擴(kuò)展名為crt的公鑰文件和擴(kuò)展名為key的私鑰文件；（這兩個(gè)文件用于商戶開發(fā)API調(diào)用來進(jìn)行商戶訂單數(shù)據(jù)簽名） 商戶進(jìn)行開發(fā)，準(zhǔn)備【C2C商戶提交表單接口定義
公司管理相關(guān)推薦
鄂ICP備17016276號(hào)-1