中國工商銀行網(wǎng)上銀行網(wǎng)上支付接口規(guī)范-文庫吧在線文庫
【正文】 goodsIDMAX(30)選輸商品名稱goodsNameMAX(60)選輸商品數(shù)量goodsNumMAX(10)選輸已含運費金額carriageAmtMAX(10)選輸商城提示merHintMAX(120)選輸備注字段1remark1MAX(100)選輸 單位：字節(jié)備注字段2remark2MAX(100)選輸 單位：字節(jié)返回商戶URLmerURLMAX(1024)必輸必須合法的URL，交易結(jié)束，將客戶引導(dǎo)到商戶的此url，即通過客戶瀏覽器post交易結(jié)果信息到商戶的此URL返回商戶變量merVARMAX(1024)選輸商戶自定義，當(dāng)返回銀行結(jié)果時，作為一個隱藏域變量，商戶可以用此變量維護(hù)session等等。支付幣種curType= 3用來區(qū)分一筆支付的幣種，目前工行只支持使用人民幣（001）支付?？蛻糁Ц妒r可以重提此筆訂單到銀行支付。商戶接收到銀行通知后，需使用開發(fā)API和銀行公鑰來驗證銀行簽名，以確保通知消息的有效性，以下簡要說明驗證步驟： 獲得各字段取值后，注意提交的明文需要進(jìn)行base64解碼才能獲得。商戶提交的訂單信息和銀行返回的通知消息都是xml串，并且進(jìn)行了BASE64編碼；提交和返回的xml都應(yīng)有xml頭；第 3 章 安全API說明為了保證商戶提交訂單數(shù)據(jù)和銀行通知信息數(shù)據(jù)的完整性，不可抵賴性，現(xiàn)提供一套用于信息簽名、驗簽和BASE64編解碼的函數(shù)?？蛻袈?lián)名標(biāo)志JoinFlag=1客戶在銀行端是否與商城聯(lián)名標(biāo)志位。訂單號orderidMAX(30)客戶支付后商戶網(wǎng)站產(chǎn)生的一個唯一的定單號，該訂單號應(yīng)該在相當(dāng)長的時間內(nèi)不重復(fù)。商戶賬號merAcctMAX(19)必輸，商戶入賬賬號，只能交易時指定。商戶提交數(shù)據(jù)中的空格將被認(rèn)為是有效字符被接收，請商戶開發(fā)時注意對多余空格的控制。（擴(kuò)充語言字段以支持英文版）在訂單中要求商戶選擇通知方式，即需要銀行通知交易結(jié)果，不需要銀行通知交易結(jié)果而是商戶主動查詢；當(dāng)需要通知時，需要在訂單中提供商戶接收銀行通知地址，當(dāng)銀行處理結(jié)束后，會在銀行的后臺服務(wù)器請求商戶的此地址，將交易結(jié)果用連接post表單形式提交給商戶，然后返回客戶交易結(jié)果頁面。對于不同類型商戶接口區(qū)別：第 2 章 商戶接口接口定義通過接口名稱和接口版本號來標(biāo)識，以便將來的擴(kuò)展；新通知方式的B2C接口稱為新模式B2C接口；原有后臺發(fā)送通知的方式稱為原模式接口； 支付接口 支付接口表單定義新模式接口的交易數(shù)據(jù)整合到一個xml格式串，作為表單的一項整體提交，不再同原來每個字段都是keyvalue形式；FORM表單數(shù)據(jù)如下：變量名稱變量命名長度定義說明接口名稱interfaceNameMAX(30)必輸，取值：“ICBC_PERBANK_B2C”接口版本號interfaceVersionMAX(15)必輸，取值：“”交易數(shù)據(jù)tranData無限制必輸，簽名；整合所有交易數(shù)據(jù)形成的xml明文串，并做BASE64編碼；具體格式定義見下文；注意：需有xml頭屬性；整個字段使用BASE64編碼；xml明文中沒有回車換行和多余空格；訂單簽名數(shù)據(jù)merSignMsg無限制必輸，商戶使用工行提供的簽名API和商戶證書將tranData的xml明文串進(jìn)行簽名，得到二進(jìn)制簽名數(shù)據(jù)，然后進(jìn)行BASE64編碼后得到可視的merSignMsg；注意：簽名時是針對tranData的xml明文，不是將tranData進(jìn)行BASE64編碼后的串；商城證書公鑰merCert無限制必輸，商戶用二進(jìn)制方式讀取證書公鑰文件后，進(jìn)行BASE64編碼后產(chǎn)生的字符串；注：數(shù)據(jù)中不能包含“|”、“amp。不可以為零，必需符合金額標(biāo)準(zhǔn)。由客戶端瀏覽器支付完成后提交通知結(jié)果時是明文傳輸，建議商戶對此變量使用額外安全防范措施，如簽名、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
公司管理相關(guān)推薦
鄂ICP備17016276號-1