中國工商銀行網(wǎng)上銀行網(wǎng)上支付接口規(guī)范-文庫吧
2025-03-23 22:46 本頁面
【正文】 ue=xxxxxxx，則一定注意在引號內(nèi)不要包含空格，不要寫成“mer URL ”，如果拼寫錯誤或者多了空格，將造成數(shù)據(jù)無法識別，無法正常進行支付接口名稱和版本號一定要和上表中相同.。商戶提交數(shù)據(jù)中的空格將被認為是有效字符被接收，請商戶開發(fā)時注意對多余空格的控制。tranData交易數(shù)據(jù)的xml串需要有xml的頭，即?xml version= encoding=GBK standalone=no? tranData數(shù)據(jù)定義變量名稱變量命名長度定義說明接口名稱interfaceName＝16必輸，取值：“ICBC_PERBANK_B2C”接口版本號interfaceVersionMAX(15)必輸，取值：“”交易日期時間orderDate=14必輸，格式為：YYYYMMDDHHmmss要求在銀行系統(tǒng)當前時間的前1小時和后12小時范圍內(nèi)，否則判定交易時間非法。訂單號orderidMAX(30)必輸，客戶支付后商戶網(wǎng)站產(chǎn)生的一個唯一的定單號，該訂單號應該在相當長的時間內(nèi)不重復。工行通過訂單號加訂單日期來唯一確認一筆訂單的重復性。訂單金額amountMAX(10)必輸，客戶支付訂單的總金額，一筆訂單一個，以分為單位。不可以為零，必需符合金額標準。支付幣種curType= 3必輸，用來區(qū)分一筆支付的幣種，目前工行只支持使用人民幣（001）支付。取值： “001”商戶代碼merIDMAX(20)必輸，唯一確定一個商戶的代碼，由商戶在工行開戶時，由工行告知商戶。商戶賬號merAcctMAX(19)必輸，商戶入賬賬號，只能交易時指定。（商戶付給銀行手續(xù)費的賬戶，可以在開戶的時候指定，也可以用交易指定方式；用交易指定方式則使用此商戶賬號）檢驗聯(lián)名標志verifyJoinFlag=1必輸， 取值“1”：客戶支付時，網(wǎng)銀判斷該客戶是否與商戶聯(lián)名，是則按上送金額扣帳，否則展現(xiàn)未聯(lián)名錯誤；取值“0”：不檢驗客戶是否與商戶聯(lián)名，按上送金額扣帳。語言版本LanguageMAX(10)選輸，默認為中文版取值：“EN_US”為英文版；取值：“ZH_CN”或其他為中文版。注意：大小寫敏感。商品編號goodsIDMAX(30)選輸商品名稱goodsNameMAX(60)選輸商品數(shù)量goodsNumMAX(10)選輸已含運費金額carriageAmtMAX(10)選輸商城提示merHintMAX(120)選輸備注字段1remark1MAX(100)選輸 單位：字節(jié)備注字段2remark2MAX(100)選輸 單位：字節(jié)返回商戶URLmerURLMAX(1024)必輸必須合法的URL，交易結(jié)束，將客戶引導到商戶的此url，即通過客戶瀏覽器post交易結(jié)果信息到商戶的此URL返回商戶變量merVARMAX(1024)選輸商戶自定義，當返回銀行結(jié)果時，作為一個隱藏域變量，商戶可以用此變量維護session等等。由客戶端瀏覽器支付完成后提交通知結(jié)果時是明文傳輸，建議商戶對此變量使用額外安全防范措施，如簽名、base64 tranData格式定義tranData格式(xml格式固定，選輸字段的取值可以為空，標簽需保留)?xml version= encoding=GBK standalone=no?B2CReq interfaceName/interfaceName interfaceVersion/interfaceVersion orderInfo orderDate/orderDate orderid/orderid amount/amount curType/curType merID/merID merAcct/merAcct /orderInfo custom verifyJoinFlag/verifyJoinFlag Language/Language /custom message goodsID/goodsID goodsName/goodsName goodsNum/goodsNum carriageAmt/carriageAmt merHint/merHint remark1/remark1 remark2/remark2 merURL/merURL merVAR/merVAR /message/B2CReq 表單樣例表單數(shù)據(jù)：INPUT NAME=interfaceName TYPE=text value=ICBC_PERBANK_B2C INPUT NAME=interfaceVersion TYPE=text value=INPUT NAME=tranData TYPE=text value=PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iR0JLIiBzdGFuZGFsb25lPSJubyI/PjxCMkNSZXE+PGludGVyZmFjZU5hbWU+SUNCQ19QRVJCQU5LX0IyQzwvaW50ZXJmYWNlTmFtZT48aW50ZXJmYWNlVmVyc2lvbj4xLjAuMC4zPC9pbn
公司管理相關推薦
鄂ICP備17016276號-1