中國工商銀行網(wǎng)上銀行B2C在線支付API 接口

B2C在線支付接口說明一、B2C流程說明：1、客戶在商戶網(wǎng)站掃瞄商品信息，簽訂訂單；2B2CAPI和商戶證書對訂單數(shù)據(jù)簽名，形成form表單返回客戶掃瞄器，表單action地址指向工行接收商戶B2C訂單信servlet；3、客戶確認使用工行支付后，提交此表單到工行；4、工行網(wǎng)銀系統(tǒng)接收此筆B2C訂單，對訂單信息和商戶信息進展檢查，通過檢查則顯示工B2C支付頁面；5、客戶在此頁面可以查詢客戶在銀行的預留信息；也可以輸入支付卡號、支付密碼、驗證碼進展B2C支付；67、工行進展支付指令處理后，假設(shè)商戶需要工行實時通知，則工行將處理結(jié)果使用協(xié)議post方式將通知消息數(shù)據(jù)提交到商戶網(wǎng)站〔這個接收銀行通知消息的商戶端地址是隨商戶訂單數(shù)據(jù)提交銀行的merURL字段，商戶返回取貨地址或關(guān)閉這個銀行與其建立的連接后，銀行才顯示交易結(jié)果頁面給客戶〔留意1、發(fā)送通知和顯示結(jié)果頁面是串行的，所以商戶端接收銀行通知處理時間太長可能導致客戶等待超時2商戶端不能對銀行的這個懇求進展重定向〕8、工行進展支付指令處理后，假設(shè)商戶不需要工行實時通知，則工行直接顯示交易結(jié)果給客戶。二、B2C接口數(shù)據(jù)說明：接口數(shù)據(jù)格式定義通過接口名稱和接口版本號來標識，以便將來的擴展；以下數(shù)據(jù)格式為“”版的“ICBC_PERBANK_B2C”接口定義。B2C商戶提交表單接口定義：版本變量名稱變量命名長度定義說明接口名稱interfaceNameMAX(30)必輸，簽名，ICBC_PERBANK_B2C”接口版本號interfaceVersionMAX(15)必輸，簽名，訂單號orderidMAX(30)1.0.0.”必輸，簽名，客戶支付后商戶網(wǎng)站產(chǎn)生的一個唯一的定單號，該訂單號應當在相當長的時間內(nèi)不重復。工行通過訂單號加訂單日期來唯一確認一筆訂單的重復性。訂單金額amountMAX(10)必輸，簽名，客戶支付訂單的總金額，一筆訂單一個，以分為單位。不行以為零，必需符合金額標準。支付幣種curType=3必輸，簽名，用來區(qū)分一筆支付的幣種，目前工行只支持使用人民幣〔001〕支付。商戶代碼merIDMAX(20)取值：“001”必輸，簽名，唯一確定一個商戶的代碼，由商戶在工行開戶時，由工行告知商戶。商城賬號merAcctMAX(19)必輸，簽名，商城收費入賬賬號〔只能交易時指定。檢驗聯(lián)名標志verifyJoinFlag=1必輸，簽名。取值“1客戶是否與商戶聯(lián)名，是則按上送金額扣帳，否則呈現(xiàn)未聯(lián)名錯誤；取值“0名，按上送金額扣帳。通知類型notifyType=2必輸，簽名，在交易轉(zhuǎn)賬處理完成后把交易結(jié)果通知商戶的處理模式。取值“HS”：在交易完成后實時將通POST發(fā)送給商戶，發(fā)送地址為商戶端隨訂單數(shù)據(jù)提交的接收工行支付結(jié)果的URL即表單中的merURL取值“AG”：在交易完成后不通知商戶。商戶需使用掃瞄器登錄工行的B2C商戶效勞網(wǎng)站，或者使用工行提API息。接收支付結(jié)果merURLMAX(200)選輸，簽名，信息通知程序使用HS通知類型的商戶用來接收工地址行訂單支付結(jié)果的URL；銀行使用POST方式向此地址發(fā)送80端口。使用“AG”通知類型的商戶,該字段可以為空或者不上送該字段；但在簽名數(shù)據(jù)中必需包含此項取值可為空。取 值 舉 例 ：“://mer/getICBCPayResult“://mer/getICBCPayResult結(jié)果發(fā)送類型resultType=1.jsp選輸，簽名。取值“0銀行都向商戶發(fā)送交易通知信息；取值“1功的通知信息。只有通知方式為HS時此值有效，如AG方式，可不上送此項，但簽名數(shù)據(jù)中必需包含此項，取值可為空。商品編號goodsIDMAX(30)選輸商品名稱goodsNameMAX(60)選輸商品數(shù)量goodsNumMAX(10)選輸已含運費金額carriageAmtMAX(10)選輸商城提示merHintMAX(120)選輸交易日期時間orderDate=14必輸，簽名，格式為：YYYYMMDDHHmmss1小時12間非法。訂單簽名數(shù)據(jù)merSignMsg無限制必輸，商戶使用工行供給的簽名API接口和商戶證書將交易數(shù)據(jù)按肯定格式進展簽名，然后進展BASE64編碼后得到〔格式單獨說明〕商城證書公鑰merCert無限制必輸，商戶用二進制方式讀取證書公鑰文件BASE64編碼后產(chǎn)生的字符串。1remark1MAX(100)保存2remark2MAX(100)保存語言版本LanguageMAX(10)選輸，默認為中文版EN_U”為英文版；ZH_C”或其他為中文版。留意：大小寫敏感。版本商戶提交表單簽名merSignMsg格式：1、組織要簽名的數(shù)據(jù)串(挨次固定；被商戶簽名的串為各輸入項的值)：接口名稱的值+接口版本號的值+商城代碼的值+商城賬號的值+通知地址的值+通知類型的值+訂單號的值+訂單金額的值+支付幣種的值+結(jié)果發(fā)送類型的值+交易日期時間的值+校驗聯(lián)名標志的值2、舉例：以下是需要簽名的數(shù)據(jù)名稱及對應值interfaceName=ICBC_PERBANK_B2C&interfaceVersion=&merID=0200EC20000012&merAcct=0200029109000030106&merU“://geticbcmsg.cn/servlet%26notifyType%3DHS%26orderid%3D000000001%26amount%3D100“RL=://geticbcmsg.cn/servlet¬ifyType=HS&orderid=000000001&amount=100&curType=001&resultType=0&orderDate=20050801192556&verifyJoinFlag=0“://geticbcmsg.c/“ICBC_PERBANK_B2C0200EC200000120200029109000030106://geticbcmsg.c“://geticbcmsg.c/“ICBC_PERBANK_B2C0200EC200000120200029109000030106://geticbcmsg.cn/servletHS0000000011000010200508011925560簽名后〔用測試私鑰user.key〕SFVdS3Kca6d/wetLFwynBl1q5nDIyxxEUXCzniIa47mhxs1BM9mPsnRc2lOqqrfwBdwBjSE82jS/iBHYKolf2sppjEyOImVZycv96321QPDgPA1yleO83K1XA1rmB3zxsIuwLKIICSWwdttn1XPYOQLJ/WAtZ5DFYFog7J8pXw0=SFVdS3Kca6d/wetLFwynBl1q5nDIyxxEUXCzniIa47mhxs1BM9mPsnRc2lOqqrfwBdwBjSE82jS/iBHYKolf2sppjEyOImVZycv96321QPDgPA1yleO83K1XA1rmB3zxsIuwLKIICSWwdttn1XPYOQLJ/WAtZ5DFYFog7J8pXw0=merCert為〔用測試證書user.crt〕MIICVjCCAb+gAwIBAgIKI9fKEDP6AAAO3DANBgkqhkiG9w0BAQUFADA0MRgwFgYDVQQDEw9wYmouaWNiYy5MIICVjCCAb+gAwIBAgIKI9fKEDP6AAAO3DANBgkqhkiG9w0BAQUFADA0MRgwFgYDVQQDEw9wYmouaWNiYy5jb20uY24xGDAWBgNVBAoTD3Biai5pY2JjLmNvbS5jbjAeFw0yMDA5MjAwOTI3NDFaFw0yMTA5MjAwOTI3NDFaMEMxGDAWBgNVBAMTD2JpYW5sdTIyLmUuMDIwMDENMAsGA1UECxMEMDIwMDEYMBYGA1UEChMPcGJqLmljYmMuY29tLmNuMIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDG+u/C5pad0ZbwvAk9Gv1rr+SpknfFUsTMhJLcI2KiYa+XLSf5vCib0OclOoDDXKIWPt/hkMEz+ED8YukQpsstXHvnxVFxVtPh23dubQjB8/kJ7X5EbwngsHMLFEXqr3UvNfcGZHuAFqMRPtr8ys3YnL3UG43Xienc3cD8jXFdQQIDAQABo2AwXjBLBgNVHR8ERDBCMECgPqA8pDowODEOMAwGA1UEAxMFY3JsMTMxDDAKBgNVBAsTA2NybDEYMBYGA1UEChMPcGJqLmljYmMuY29tLmNuMA8GA1UdYwQIAwYA/wAAAAAwDQYJKoZIhvcNAQEFBQADgYEAQe6tLhKaNX8OPNT2XzH7dTXIFmTm37hSvmbEL/Q/pWV386KVrNSCnyN3fowanMt5TE9qZFn9enVvyDJw4nAUx38F2PFn2Tt7JUtzt/pNKC5FiebpFJH48AXIP1Xt5GjdcBx0oXM9QNBtYvY0189t357EH4UaBfO+c+L8fkOt37o=B2C通知商戶交易結(jié)果接口定義：版本變量名稱變量名稱接口名稱接口版本號訂單號變量命名 長度定義interfaceName MAX(30)interfaceVersion MAX(15)orderid MAX(30)說明C1.0.0.”客戶支付后商戶網(wǎng)站產(chǎn)生的一個唯一的定單號，該訂單號應當在相當長的時間內(nèi)不重復。工行通過訂單號加訂單日期來唯一確認一筆訂單的重復性。銀行指令序號TranSerialNoMAX(30)銀行端指令流水號訂單金額amountMAX(10)客戶支付訂單的總金額，一筆訂單一個，以分為單位。不行以為零，必需符合金額標準。支付幣種curType=3用來區(qū)分一筆支付的幣種，目前工行只支持使用人民幣〔001〕支付。商戶代碼merIDMAX(20)取值：“001”唯一確定一個商戶的代碼，由商戶在工行開戶時，由工行告知商戶。商城賬號merAcctMAX(19)商城收費入賬賬號〔只能交易時指定。檢驗聯(lián)名標志verifyJoinFlag=1取值“1客戶是否與商戶聯(lián)名，是則按上送金額扣帳，否則呈現(xiàn)未聯(lián)名錯誤；取值“0名，按上送金額扣帳?？蛻袈?lián)名標志JoinFlag=1客戶在銀行端是否與商城聯(lián)名標志位。1客戶聯(lián)名0客戶未聯(lián)名聯(lián)名會員號UserNumMAX(40)聯(lián)名客戶在商戶的會員號。結(jié)果發(fā)送類型resultType=1取值“0銀行都向商戶發(fā)送交易通知信息；取值“1功的通知信息。交易日期時間orderDate=14格式為：YYYYMMDDHHmmss1小時12間非法。返回通知日期notifyDateMAX(14)格式為：YYYYMMDDHHmmss時間訂單處理狀態(tài)tranStat=1123-“交易可疑”錯誤描述commentMAX(100)錯誤描述1remark1MAX(100)保存2remark2MAX(100)保存通知消息銀行signMsg無限制銀行使用自己證書對商戶通知消息按簽名數(shù)據(jù)照肯定格式進展的簽名,然后進展BASE64編碼后的字符串〔格式單獨描述〕〔留意與C2C通知接口定義變量名區(qū)分〕通知消息銀行簽名數(shù)據(jù)signMsg格式：1、組織要簽名的數(shù)據(jù)串(挨次固定；銀行通知消息簽名的串為以下格式，請留意與商戶簽名串的格式不同)：接口名稱=值&接口版本號=值&訂單號=值&指令序號=值&訂單金額=值&支付幣種=值&商城代碼=值&商城賬號=值&校驗聯(lián)名標志=值&客戶聯(lián)名標志=值&聯(lián)名會員號=值&結(jié)果發(fā)送類型=值&交易日期時間=值&返回通知日期時間=值&訂單處理狀態(tài)=值&錯誤描述=值&1=值&2=值interfaceName=值&interfaceVersion=值&orderid=值&TranSerialNo=值&amount=值&curType=值&merID=值&merAcct=值&verifyJoinFlag=值&JoinFlag=值&UserNum=值&resultType=值&orderDate值¬ifyDate值&tranStat值&comment值&remark1值&remark2=值舉例：interfaceName=ICBC_PERBANK_B2C&interfaceVersion=&orderid=000000001&TranSeriainterfaceName=ICBC_PERBANK_B2C&interfaceVersion=&orderid=000000001&TranSerialNo=&amount=100&curType=001&merID=0200EC20000012&merAcct=0200029109000030106&verifyJoinFlag=0&JoinFlag=&UserNum=&resultType=0&orderDate=20050801192556¬ifyDate=20050824165910&tranStat=2&comment=failure,Error_code:32147ErrorMsg:提交支付表單時間數(shù)據(jù)不在有效時間范圍。&remark1=&remark2=signMsg為Yp4CVHY5rHtcQ9kOxHc70k1PKgpv1jXk0LZgSH0O+iEcFA3KKxBRjAhvCvV0hDc9X0WXswMfcGuaKMoCJSMHmdq3lVTYr2hfT1/K3nPI6IdCGmo4wJWha8ha4ujyLkQFa36f+7C1g9keBro59GPIBHHaRs1Ggmnb2aNimdMAAiM=商戶可能收到的銀行通知：指令成功：只能有一筆成功、且要驗證銀行簽名、訂單金額等信息是否與商戶端記錄全都。指令失?。毫粢饪赡苁盏蕉喙P失敗?？蛻糁Ц妒r可以重提此筆訂單到銀行支付。指令可疑：筆指令為可疑指令；可疑指令將被自動批復，商戶、客戶可于其次日查詢指令狀態(tài)。沒有收到銀行通知：由于銀行、商戶兩端效勞器或者互聯(lián)網(wǎng)通訊等緣由可能造成商戶端接收不到銀行通知。自動處理。商戶返回取貨地址：取貨地址〔也可稱為商戶收到銀行成功支付后的商戶端確認地址：結(jié)果給客戶，整個過程是串行的；假設(shè)商戶在收到銀行通知后，不準時返回或關(guān)閉連接，將可能造成客戶端等待超時，無法顯示最終的交易結(jié)果頁面。API說明：于信息簽名、驗簽和BASE64編解碼的函數(shù)。商戶開發(fā)時使用這套函數(shù)和工行頒發(fā)的商戶證書進展商戶訂單信息簽名同時使用這套API和銀行公鑰可以驗證銀行通知消息的有效性。安全APIAPIdemo程序；四、開發(fā)步驟商戶程序需在銀行模擬測試環(huán)境上進展聯(lián)調(diào)后，再投產(chǎn)，以下說明聯(lián)調(diào)開發(fā)步驟。生成訂單：1、商戶和當?shù)匦新?lián)系，申請聯(lián)調(diào)測試；由當?shù)匦性谀M測試環(huán)境錄入商戶信息，生成商戶證書pfx格式；并供給銀行模擬測試環(huán)境的銀行證書公鑰文件〔用于驗證銀行簽名時使用；2pfxcrt的公鑰文件和擴展名為key〔這兩個文件用于商戶開發(fā)API名〕3B2C商戶提交表單接口定義】一節(jié)中要求的訂單數(shù)據(jù)；4、其中訂單簽名數(shù)據(jù)merSignMsgmerSignMsgAPI到簽名串，然后做BASE64編碼；5merCert字段需要使用API函數(shù)做BASE64編碼；6s://銀行地址/servlet/ICBCINBSEBusinessServletB2C指令的資金支付；接收通知：假設(shè)商戶需要銀行實時發(fā)送交易結(jié)果，則需要在訂單的通知類型 notifyType設(shè)置成“HS”，并設(shè)置有效的接收銀行通知的接收地址merURL字段，銀行在支付處理完成后會向此地址postB2C商戶接收到銀行通知后，需使用開發(fā)API和銀行公鑰來驗證銀行簽名，以確保通知消息的有效性，以下簡要說明驗證步驟：1B2C通知商戶交易結(jié)果接口定義】中說明的各字段；各字段使用URLencodeweb效勞器沒有自動將各字段進展URLdecode，則商戶程序需手工進展URL解碼；2、獲得各字段取值后，依據(jù)【通知消息銀行簽名數(shù)據(jù)signMsg格式】格式中說明的數(shù)據(jù)項和挨次，拼成銀行端簽名數(shù)據(jù)明文；3API和銀行公鑰文件對表單中的銀行簽名signMsg進展驗簽；4、驗簽成功后，為確保數(shù)據(jù)全都，建議商戶比較一下通知消息中訂單金額、賣家卡號等關(guān)鍵信息和自己記錄的是否全都；5tranStat來更自己的指令狀態(tài)和相關(guān)數(shù)據(jù)庫信息；6期望客戶到商戶自己確實認頁面，則需要返回取貨地址或確認頁面的URL給銀行，銀行將在顯示給客戶的交易結(jié)果頁面顯示此URL的鏈接供客戶點擊；五、樣例：商戶提交訂單form<FORM name=“order“METHOD=POSTACTION=“s://銀行地址/servlet/ICBCINBSEBusinessServlet“>1、訂單只能使用POST方式提交；使用s協(xié)議通訊；2、接收servlet名稱固定為：/servlet/ICBCINBSEBusinessServlet3、銀行地址：假設(shè)是生產(chǎn)則為“mybank.icbc.cn“mybank.dccnet.cn”<INPUTNAME=“interfaceName“TYPE=“text“value=“ICBC_PERBANK_B2C“>接口名稱固定為“ICBC_PERBANK_B2C”<INPUTNAME=“interfaceVersion“TYPE=“text“value=““>接口版本目前為“”<INPUTNAME=“orderid“TYPE=“text“value=“000000001“>訂單號商戶端產(chǎn)生，一天內(nèi)不能重復。<INPUTNAME=“amount“TYPE=“text“value=“100“>金額以分為單位<INPUTNAME=“curType“TYPE=“text“value=“001“>幣種目前只支持人民幣，代碼為“001”<INPUTNAME=“merID“TYPE=“text“value=“0200EC20000012“>銀行供給<INPUTNAME=“merAcct“TYPE=“text“value=“0200029109000030106“>銀行供給<INPUTNAME=“verifyJoinFlag“TYPE=“text“value=“0“>“1”推斷該客戶是否與商戶聯(lián)名；取值“0”不檢驗客戶是否與商戶聯(lián)名。<INPUTNAME=“notifyType“TYPE=“text“value=“HS“>HS方式實時發(fā)送通知；AG方式不發(fā)送通知；<INPUTNAME=“merURL“TYPE=“text“value=“://geticbcmsg.cn/servlet“>接收銀行通知地址，目前只支持80端口<INPUTNAME=“resultType“TYPE=“text“ value=“0“>對于HS0<INPUTNAME=“orderDate“TYPE=“text“value=“20050801192556“>14位時間戳<INPUT NAME=“merSignMsg“ TYPE=“text“value=“SFVdS3Kca6d/wetLFwynBl1q5nDIyxxEUXCzniIa47mhxs1BM9mPsnRc2lOqqrfwBdwBjSE82jS/iBHYKolf2sppjEyOImVZycv96321QPDgPA1yleO83K1XA1rmB3zxsIuwLKIICSWwdttn1XPYOQLJ/WAtZ5DFYFog7J8pXw0=“>商戶簽名數(shù)據(jù)BASE64編碼<INPUT NAME=“merCert“ TYPE=“text“value=“MIICVjCCAb+gAwIBAgIKI9fKEDP6AAAO3DANBgkqhkiG9w0BAQUFADA0MRgwFgYDVQQDEw9wYmouaWNiYy5jb20uY24xGDAWBgNVBAoTD3Biai5pY2JjLmNvbS5jbjAeFw0yMDA5MjAwOTI3NDFaFw0yMTA5MjAwOTI3NDFaMEMxGDAWBgNVBAMTD2JpYW5sdTIyLmUuMDIwMDENMAsGA1UECxMEMDIwMDEYMBYGA1UEChMPcGJqLmljYmMuY29tLmNuMIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDG+u/C5pad0ZbwvAk9Gv1rr+SpknfFUsTMhJLcI2KiYa+XLSf5vCib0OclOoDDXKIWPt/hkMEz+ED8YukQpsstXHvnxVFxVtPh23dubQjB8/kJ7X5EbwngsHMLFEXqr3UvNfcGZHuAFqMRPtr8ys3YnL3UG43Xienc3cD8jXFdQQIDAQABo2AwXjBLBgNVHR8ERDBCMECgPqA8pDowODEOMAwGA1UEAxMFY3JsMTMxDDAKBgNVBAsTA2NybDEYMBYGA1UEChMPcGJqLmljYmMuY29tLmNuMA8GA1UdYwQIAwYA/wAAAAAwDQYJKoZIhvcNAQEFBQADgYEAQe6tLhKaNX8OPNT2XzH7dTXIFmTm37hSvmbEL/Q/pWV386KVrNSCnyN3fowanMt5TE9qZFn9enVvyDJw4nAUx38F2PFn2Tt7JUtzt/pNKC5FiebpFJH48AXIP1Xt5GjdcBx0oXM9QNBtYvY0189t357EH4UaBfO+c+L8fkOt37o=“>商戶證書公鑰BASE64編碼<INPUTNAME=“goodsID“TYPE=“text“value=“abcd001“><INPUTNAME=“goodsName“TYPE=“text“value=“小氈帽“><INPUTNAME=“goodsNum“TYPE=“text“value=“1“><INPUTNAME=“carriageAmt“TYPE=“text“value=“100“>金額以分為單位<INPUTNAME=“merHint“TYPE=“text“value=“跳樓甩賣！“ size=“60“>以上五個字段用于客戶支付頁面顯示<INPUTNAME=“remark1“TYPE=“text“value=““>備注字段<INPUTNAME=“remark2“TYPE=“text“value=““>備注字段<INPUTNAME=“Language“TYPE=“text“value=“EN_US“>Language,EN_US為英文版<INPUTTYPE=“submit“value=“提交訂單“>留意商戶提交訂單數(shù)據(jù)不能提交接口中沒有定義的字段，提交按鈕不能設(shè)置name屬性，假設(shè)設(shè)置了，提交按鈕的值將作為一個變量提交，可能造成數(shù)據(jù)檢查錯誤。</form>報文：〔此樣例為銀行通知消息的〕interfaceName=ICBC_PERBANK_B2C&interfaceVersion=&orderid=000000001&TranSeriainterfaceName=ICB