中國(guó)工商銀行網(wǎng)上銀行網(wǎng)上支付接口規(guī)范-文庫(kù)吧
2025-03-23 22:46 本頁(yè)面
【正文】 ue=xxxxxxx，則一定注意在引號(hào)內(nèi)不要包含空格，不要寫(xiě)成“mer URL ”，如果拼寫(xiě)錯(cuò)誤或者多了空格，將造成數(shù)據(jù)無(wú)法識(shí)別，無(wú)法正常進(jìn)行支付接口名稱和版本號(hào)一定要和上表中相同.。商戶提交數(shù)據(jù)中的空格將被認(rèn)為是有效字符被接收，請(qǐng)商戶開(kāi)發(fā)時(shí)注意對(duì)多余空格的控制。tranData交易數(shù)據(jù)的xml串需要有xml的頭，即?xml version= encoding=GBK standalone=no? tranData數(shù)據(jù)定義變量名稱變量命名長(zhǎng)度定義說(shuō)明接口名稱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í)間非法。訂單號(hào)orderidMAX(30)必輸，客戶支付后商戶網(wǎng)站產(chǎn)生的一個(gè)唯一的定單號(hào)，該訂單號(hào)應(yīng)該在相當(dāng)長(zhǎng)的時(shí)間內(nèi)不重復(fù)。工行通過(guò)訂單號(hào)加訂單日期來(lái)唯一確認(rèn)一筆訂單的重復(fù)性。訂單金額amountMAX(10)必輸，客戶支付訂單的總金額，一筆訂單一個(gè)，以分為單位。不可以為零，必需符合金額標(biāo)準(zhǔn)。支付幣種curType= 3必輸，用來(lái)區(qū)分一筆支付的幣種，目前工行只支持使用人民幣（001）支付。取值： “001”商戶代碼merIDMAX(20)必輸，唯一確定一個(gè)商戶的代碼，由商戶在工行開(kāi)戶時(shí)，由工行告知商戶。商戶賬號(hào)merAcctMAX(19)必輸，商戶入賬賬號(hào)，只能交易時(shí)指定。（商戶付給銀行手續(xù)費(fèi)的賬戶，可以在開(kā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)名，按上送金額扣帳。語(yǔ)言版本LanguageMAX(10)選輸，默認(rèn)為中文版取值：“EN_US”為英文版；取值：“ZH_CN”或其他為中文版。注意：大小寫(xiě)敏感。商品編號(hào)goodsIDMAX(30)選輸商品名稱goodsNameMAX(60)選輸商品數(shù)量goodsNumMAX(10)選輸已含運(yùn)費(fèi)金額carriageAmtMAX(10)選輸商城提示merHintMAX(120)選輸備注字段1remark1MAX(100)選輸 單位：字節(jié)備注字段2remark2MAX(100)選輸 單位：字節(jié)返回商戶URLmerURLMAX(1024)必輸必須合法的URL，交易結(jié)束，將客戶引導(dǎo)到商戶的此url，即通過(guò)客戶瀏覽器post交易結(jié)果信息到商戶的此URL返回商戶變量merVARMAX(1024)選輸商戶自定義，當(dāng)返回銀行結(jié)果時(shí)，作為一個(gè)隱藏域變量，商戶可以用此變量維護(hù)session等等。由客戶端瀏覽器支付完成后提交通知結(jié)果時(shí)是明文傳輸，建議商戶對(duì)此變量使用額外安全防范措施，如簽名、base64 tranData格式定義tranData格式(xml格式固定，選輸字段的取值可以為空，標(biāo)簽需保留)?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
公司管理相關(guān)推薦
鄂ICP備17016276號(hào)-1