中國(guó)某銀行網(wǎng)上銀行C2C在線支付接口說(shuō)明V1001

1、中國(guó)工商商銀行網(wǎng)網(wǎng)上銀行行C2CC在線支支付接口口說(shuō)明一、C22C流程程說(shuō)明：1、客戶戶在商戶戶網(wǎng)站瀏瀏覽商品品信息，簽訂訂訂單；2、商戶戶按照工工行C22C訂單單數(shù)據(jù)規(guī)規(guī)范形成成提交數(shù)數(shù)據(jù)，并并使用工工行提供供APII和商戶戶證書(shū)對(duì)對(duì)訂單數(shù)數(shù)據(jù)簽名名，形成成forrm表單單返回客客戶瀏覽覽器，表表單acctioon地址址指向工工行接收收商戶CC2C訂單單信息的的serrvleet；3、客戶戶確認(rèn)使使用工行行支付后后，提交交此表單單到工行行；4、工行行網(wǎng)銀系系統(tǒng)接收收此筆CC2C訂單單，對(duì)訂訂單信息息和商戶戶信息進(jìn)進(jìn)行檢查查，通過(guò)過(guò)檢查則則顯示工工行C22C支付付頁(yè)面；5、客戶戶在此頁(yè)頁(yè)面可以

2、以查詢客客戶在銀銀行的預(yù)預(yù)留信息息；也可可以輸入入支付卡卡號(hào)、支支付密碼碼、驗(yàn)證證碼進(jìn)行行C2CC支付；6、工行行檢查客客戶信息息，通過(guò)過(guò)檢查后后顯示確確認(rèn)頁(yè)面面；客戶戶確認(rèn)提提交后工工行進(jìn)行行支付指指令處理理；7、工行行進(jìn)行支支付指令令處理后后，如果果商戶需需要工行行實(shí)時(shí)通通知，則則工行將將處理結(jié)結(jié)果使用用htttp協(xié)議議posst方式式將通知知消息數(shù)數(shù)據(jù)提交交到商戶戶網(wǎng)站（這個(gè)接接收銀行行通知消消息的商商戶端地地址是隨隨商戶訂訂單數(shù)據(jù)據(jù)提交銀銀行的mmerUURL字字段），商戶返返回取貨貨地址或或關(guān)閉這這個(gè)銀行行與其建建立的連連接后，銀行才才顯示交交易結(jié)果果頁(yè)面給給客戶。（注意意1、發(fā)發(fā)送

3、通知知和顯示示結(jié)果頁(yè)頁(yè)面是串串行的，所以商商戶端接接收銀行行通知處處理時(shí)間間太長(zhǎng)可可能導(dǎo)致致客戶等等待超時(shí)時(shí)，造成成銀行不不能將交交易結(jié)果果頁(yè)面顯顯示給客客戶。22、此連連接是銀銀行服務(wù)務(wù)器自動(dòng)動(dòng)和商戶戶進(jìn)行的的連接，商戶返返回也是是直接返返回給銀銀行，商商戶端不不能對(duì)銀銀行的這這個(gè)請(qǐng)求求進(jìn)行重重定向。）8、工行行進(jìn)行支支付指令令處理后后，如果果商戶不不需要工工行實(shí)時(shí)時(shí)通知，則工行行直接顯顯示交易易結(jié)果給給客戶。二、C22C接口口數(shù)據(jù)說(shuō)說(shuō)明：接口數(shù)據(jù)據(jù)格式定定義通過(guò)過(guò)接口名名稱和接接口版本本號(hào)來(lái)標(biāo)標(biāo)識(shí)，以以便將來(lái)來(lái)的擴(kuò)展展；以下下數(shù)據(jù)格格式為“1.00.0.1”版的“ICBBC_PPERBBA

4、NKK_C2C”接口定定義。C2C商商戶提交交表單接接口定義義：1版本變量名稱稱變量命名名長(zhǎng)度定義義（以字字節(jié)為單單位）說(shuō)明接口名稱稱inteerfaaceNNameeMAX(30)必輸，簽簽名，取值：“ICBBC_PPERBBANKK_C22C”接口版本本號(hào)inteerfaaceVVerssionnMAX(15)必輸，簽簽名，取值：“1.00.0.1”訂單號(hào)ordeerIDDMAX(30)必輸，簽簽名，客戶支付付后商戶戶網(wǎng)站產(chǎn)產(chǎn)生的一一個(gè)唯一一的定單單號(hào)，該該訂單號(hào)號(hào)應(yīng)該在在相當(dāng)長(zhǎng)長(zhǎng)的時(shí)間間內(nèi)不重重復(fù)。工工行通過(guò)過(guò)訂單號(hào)號(hào)加訂單單日期來(lái)來(lái)唯一確確認(rèn)一筆筆訂單的的重復(fù)性性。訂單金

5、額額amouuntMAX(10)必輸，簽簽名，客戶支付付訂單的的總金額額，一筆筆訂單一一個(gè)，以以分為單單位。不不可以為為零，必必需符合合金額標(biāo)標(biāo)準(zhǔn)。商城收費(fèi)費(fèi)金額merFFeeAAmtMAX(10)必輸，簽簽名，可為零，必需符符合金額額標(biāo)準(zhǔn)。支付幣種種curTTypee= 3必輸，簽簽名，用來(lái)區(qū)分分一筆支支付的幣幣種，目目前工行行只支持持使用人人民幣（0011）支付付。取值： “0011”商戶代碼碼merIIDMAX(20)必輸，簽簽名，唯一確定定一個(gè)商商戶的代代碼，由由商戶在在工行開(kāi)開(kāi)戶時(shí)，由工行行告知商商戶。商城賬號(hào)號(hào)merAAccttMAX(19)必輸，簽簽名，商城收費(fèi)費(fèi)入賬賬賬號(hào) （只

6、能交交易時(shí)指指定）。賣(mài)家收款款卡號(hào)vendderCCarddNummMAX(19)必輸，簽簽名，支持工行行靈通卡卡、E時(shí)時(shí)代卡、理財(cái)金金卡、信信用卡、貸記卡卡；不支支持國(guó)際際卡賣(mài)家收款款名稱vendderNNameeMAX(40)必輸，簽簽名。檢驗(yàn)聯(lián)名名標(biāo)志veriifyJJoinnFlaag=1必輸，簽簽名。取值“11”：客戶戶支付時(shí)時(shí)，網(wǎng)銀銀判斷該該客戶是是否與商商戶聯(lián)名名，是則則按上送送金額扣扣帳，否否則展現(xiàn)現(xiàn)未聯(lián)名名錯(cuò)誤；取值“00”：不檢檢驗(yàn)客戶戶是否與與商戶聯(lián)聯(lián)名，按按上送金金額扣帳帳。通知類(lèi)型型notiifyTTypee= 2必輸，簽簽名，在交易轉(zhuǎn)轉(zhuǎn)賬處理理完成后后把交易易結(jié)果通

7、通知商戶戶的處理理模式。取值“HHS”：在交交易完成成后實(shí)時(shí)時(shí)將通知知信息以以HTTTP協(xié)議議POSST方式式，主動(dòng)動(dòng)發(fā)送給給商戶，發(fā)送地地址為商商戶端隨隨訂單數(shù)數(shù)據(jù)提交交的接收收工行支支付結(jié)果果的URRL即表表單中的的merrURLL字段；取值“AAG”：在交交易完成成后不通通知商戶戶。商戶戶需使用用瀏覽器器登錄工工行的CC2C商戶戶服務(wù)網(wǎng)網(wǎng)站，或或者使用用工行提提供的客客戶端程程序APPI主動(dòng)動(dòng)獲取通通知信息息。接收支付付結(jié)果信信息通知知程序地地址merUURLMAX (2000)選輸，簽簽名，使用HSS通知類(lèi)類(lèi)型的商商戶用來(lái)來(lái)接收工工行訂單單支付結(jié)結(jié)果的UURL；銀行使使用HTTTP協(xié)協(xié)

8、議POOST方方式向此此地址發(fā)發(fā)送通知知信息；目前只只支持880端口口。使用“AAG”通知類(lèi)類(lèi)型的商商戶,該該字段可可以為空空或者不不上送該該字段；但在簽簽名數(shù)據(jù)據(jù)中必須須包含此此項(xiàng)，取取值可為為空。取值舉例例：htttp:/wwww.merr.coom/ggetIICBCCPayyRessultt.jssp（注意需需要寫(xiě)上上“htttp:/”）結(jié)果發(fā)送送類(lèi)型resuultTTypee=1選輸，簽簽名。取值“00”：無(wú)論論支付成成功或者者失敗，銀行都都向商戶戶發(fā)送交交易通知知信息；取值“11”，銀行行只向商商戶發(fā)送送交易成成功的通通知信息息。只有通知知方式為為HS時(shí)時(shí)此值有有效，如如果使用用A

9、G方方式，可可不上送送此項(xiàng)，但簽名名數(shù)據(jù)中中必須包包含此項(xiàng)項(xiàng)，取值值可為空空。商品編號(hào)號(hào)gooddsIDDMAX(30)選輸商品名稱稱gooddsNaameMAX(60)選輸商品數(shù)量量gooddsNuumMAX(10)選輸已含運(yùn)費(fèi)費(fèi)金額carrriaggeAmmtMAX(18)選輸商城提示示merHHinttMAX(1200)選輸交易日期期時(shí)間ordeerDaate=14必輸，簽簽名，格式為：YYYYYMMMDDHHHmmmss要求在銀銀行系統(tǒng)統(tǒng)當(dāng)前時(shí)時(shí)間的前前1小時(shí)時(shí)和后112小時(shí)時(shí)范圍內(nèi)內(nèi)，否則則判定交交易時(shí)間間非法。訂單簽名名數(shù)據(jù)merSSignnMsgg無(wú)限制必輸，商戶使用用工行提提供

10、的簽簽名APPI接口口和商戶戶證書(shū)將將交易數(shù)數(shù)據(jù)按一一定格式式進(jìn)行簽簽名，然然后進(jìn)行行BASSE644編碼后后得到的的字符串串。（格格式單獨(dú)獨(dú)說(shuō)明）商城證書(shū)書(shū)公鑰merCCertt無(wú)限制必輸，商戶用二二進(jìn)制方方式讀取取證書(shū)公公鑰文件件后，進(jìn)進(jìn)行BAASE664編碼碼后產(chǎn)生生的字符符串。備注字段段1remaark11MAX(1000)選輸備注字段段2remaark22MAX(1000)選輸語(yǔ)言版本本LangguaggeMAX(10)選輸，默默認(rèn)為中中文版取值：“EN_US”為英文文版；取值：“ZH_CN”或其他為中中文版。注意：大大小寫(xiě)敏敏感。（注意數(shù)數(shù)據(jù)值中中不能包包含“&”“=”，此字字符為

11、銀銀行端程程序保留留字符；中文變變量使用用GBKK編碼）商戶提交交表單簽簽名meerSiignMMsg格格式：根據(jù)訂單單中各數(shù)數(shù)據(jù)項(xiàng)，使用&符進(jìn)行行連接成成簽名明明文，各各字段順順序固定定；每個(gè)個(gè)數(shù)據(jù)項(xiàng)項(xiàng)由變量量名稱加加等號(hào)加加變量值值組成；如果變變量值為為空仍需需保留字字段位置置；格式說(shuō)明明如下：接口名稱稱&接口口版本號(hào)號(hào)&訂單單號(hào)&訂訂單金額額&商城城收費(fèi)金金額&支支付幣種種&商城城代碼&商城賬賬號(hào)&賣(mài)賣(mài)家收款款卡號(hào)&賣(mài)家收收款名稱稱&校驗(yàn)驗(yàn)聯(lián)名標(biāo)標(biāo)志&通通知類(lèi)型型&通知知地址&結(jié)果發(fā)發(fā)送類(lèi)型型&交易易日期時(shí)時(shí)間inteerfaaceNNamee=值&innterrfacceVeersii

12、on=值&orrderrID=值&ammounnt=值值&meerFeeeAmmt=值值&cuurTyype=值&meerIDD=值&meerAccct=值&veendeerCaardNNum=值& vvendderNNamee =值值&veeriffyJooinFFlagg=值&nootiffyTyype=值&meerURRL=值值&reesulltTyype=值&orrderrDatte=值值舉例：inteerfaaceNNamee=ICCBC_PERRBANNK_CC2C &intterffaceeVerrsioon=0&orrderrID=0011&ammounnt=9

13、9999999999&mmerFFeeAAmt=100000&currTyppe=0001&merrID=ABCC0011&meerAccct=0200002291009000001188331&vvendderCCarddNumm=9555888002200112411357720&張三&verrifyyJoiinFllag=0&nnotiifyTTypee=AGG&meerURRL=&ressulttTyppe=&ordderDDatee=2000500713310003344C2C通通知商戶戶交易結(jié)結(jié)果接口口定義：1版本變量名稱稱變量命名名長(zhǎng)度定義義（以字字節(jié)為單單位）說(shuō)明

14、接口名稱稱inteerfaaceNNameeMAX(30)取值：“ICBBC_PPERBBANKK_C22C”接口版本本號(hào)inteerfaaceVVerssionnMAX(15)取值：“1.00.0.1”訂單號(hào)ordeerIDDMAX(30)客戶支付付后商戶戶網(wǎng)站產(chǎn)產(chǎn)生的一一個(gè)唯一一的定單單號(hào)，該該訂單號(hào)號(hào)應(yīng)該在在相當(dāng)長(zhǎng)長(zhǎng)的時(shí)間間內(nèi)不重重復(fù)。工工行通過(guò)過(guò)訂單號(hào)號(hào)加訂單單日期來(lái)來(lái)唯一確確認(rèn)一筆筆訂單的的重復(fù)性性。銀行指令令序號(hào)TrannSerriallNoMAX(30)銀行端指指令流水水號(hào)訂單金額額amouuntMAX(10)客戶支付付訂單的的總金額額，一筆筆訂單一一個(gè)，以以分為單單位。不不可以

15、為為零，必必需符合合金額標(biāo)標(biāo)準(zhǔn)。商城收費(fèi)費(fèi)金額merFFeeAAmtMAX(10)可為零，必需符符合金額額標(biāo)準(zhǔn)。支付幣種種curTTypee= 3用來(lái)區(qū)分分一筆支支付的幣幣種，目目前工行行只支持持使用人人民幣（0011）支付付。取值： “0011”商戶代碼碼merIIDMAX(20)唯一確定定一個(gè)商商戶的代代碼，由由商戶在在工行開(kāi)開(kāi)戶時(shí)，由工行行告知商商戶。商城賬號(hào)號(hào)merAAccttMAX(19)商城收費(fèi)費(fèi)入賬賬賬號(hào) （只能交交易時(shí)指指定）。賣(mài)家收款款卡號(hào)vendderCCarddNummMAX(19)支持工行行靈通卡卡、E時(shí)時(shí)代卡、理財(cái)金金卡、信信用卡、貸記卡卡；不支支持國(guó)際際卡賣(mài)家收款款

16、名稱vendderNNameeMAX(40)賣(mài)家收款款名稱買(mǎi)家付款款卡號(hào)custtomCCarddNummMAX(19)“付款卡卡號(hào)”后四位位進(jìn)行隱隱含如：95558880022001124113*買(mǎi)家付款款名稱custtomNNameeMAX(20)“付款人人名”從第二二位漢字字開(kāi)始隱隱含，如如：鄭*檢驗(yàn)聯(lián)名名標(biāo)志veriifyJJoinnFlaag=1取值“11”：客戶戶支付時(shí)時(shí)，網(wǎng)銀銀判斷該該客戶是是否與商商戶聯(lián)名名，是則則按上送送金額扣扣帳，否否則展現(xiàn)現(xiàn)未聯(lián)名名錯(cuò)誤；取值“00”：不檢檢驗(yàn)客戶戶是否與與商戶聯(lián)聯(lián)名，按按上送金金額扣帳帳?？蛻袈?lián)名名標(biāo)志JoinnFlaag=1客戶在銀銀行

17、端是是否與商商城聯(lián)名名標(biāo)志位位。1客客戶聯(lián)名名 0客客戶未聯(lián)聯(lián)名聯(lián)名會(huì)員員號(hào)UserrNummMAX(40)聯(lián)名客戶戶在商戶戶的會(huì)員員號(hào)。結(jié)果發(fā)送送類(lèi)型resuultTTypee=1取值“00”：無(wú)論論支付成成功或者者失敗，銀行都都向商戶戶發(fā)送交交易通知知信息；取值“11”，銀行行只向商商戶發(fā)送送交易成成功的通通知信息息。交易日期期時(shí)間ordeerDaate=14格式為：YYYYYMMMDDHHHmmmss要求在銀銀行系統(tǒng)統(tǒng)當(dāng)前時(shí)時(shí)間的前前1小時(shí)時(shí)和后112小時(shí)時(shí)范圍內(nèi)內(nèi)，否則則判定交交易時(shí)間間非法。返回通知知日期時(shí)時(shí)間notiifyDDateeMAX(14)格式為：YYYYYMMMDDHHH

18、mmmss訂單處理理狀態(tài)trannStaat=11-“交交易成功功，已清清算”；2-“交交易失敗敗”；3-“交交易可疑疑”錯(cuò)誤描述述commmenttMAX(1000)錯(cuò)誤描述述備注1remaark11MAX(1000)備注備注2remaark22MAX(1000)備注通知消息息銀行簽簽名數(shù)據(jù)據(jù)bankkSiggnMssg無(wú)限制銀行使用用自己證證書(shū)對(duì)商商戶通知知消息按按照一定定格式進(jìn)進(jìn)行的簽簽名,然然后進(jìn)行行BASSE644編碼后后的字符符串。（格式單單獨(dú)描述述）通知消息息銀行簽簽名數(shù)據(jù)據(jù)bannkSiignMMsg格格式：根據(jù)消息息中各數(shù)數(shù)據(jù)項(xiàng)，使用&符進(jìn)行行連接成成銀行端端簽名明明文，各各

19、字段順順序固定定；每個(gè)個(gè)數(shù)據(jù)項(xiàng)項(xiàng)由變量量名稱加加等號(hào)加加變量值值組成；如果變變量值為為空仍保保留字段段位置；格式說(shuō)明明：接口名稱稱&接口口版本號(hào)號(hào)&訂單單號(hào)&指指令序號(hào)號(hào)&訂單單金額&商城收收費(fèi)金額額&支付付幣種&商城代代碼&商商城賬號(hào)號(hào)&賣(mài)家家收款卡卡號(hào)&賣(mài)賣(mài)家收款款名稱&買(mǎi)家收收款卡號(hào)號(hào)&買(mǎi)家家付款名名稱&校校驗(yàn)聯(lián)名名標(biāo)志 &客戶戶聯(lián)名標(biāo)標(biāo)志&聯(lián)聯(lián)名會(huì)員員號(hào)&結(jié)結(jié)果發(fā)送送類(lèi)型&交易日日期時(shí)間間&返回回通知日日期時(shí)間間&訂單單處理狀狀態(tài)&錯(cuò)錯(cuò)誤描述述&備注注1&備備注2inteerfaaceNNamee=值&intterffaceeVerrsioon=值值&orrderrID=值& TTra

20、nnSerriallNo =值&ammounnt=值值&meerFeeeAmmt=值值&cuurTyype=值&meerIDD=值&meerAccct=值&veendeerCaardNNum=值&veendeerNaame =值&ccusttomCCarddNumm=值&cusstommNamme=值值&veeriffyJooinFFlagg=值&JoiinFllag=值&UseerNuum =值&reesulltTyype=值&orrderrDatte=值值&nootiffyDaate=值&trranSStatt=值&commmennt=值值remaark11=值& rremaark22=值

21、提示：以以上格式式為銀行行端簽名名明文格格式，對(duì)對(duì)于銀行行簽名字字段baankSSignnMsgg，得到到密文后后進(jìn)行了了BASSE644編碼，所有字字段在發(fā)發(fā)出前取取值部分分都經(jīng)過(guò)過(guò)urllEcoode編編碼（包包括baankSSignnMsgg字段）。商戶可能能收到的的銀行通通知：指令成功功：只能有一一筆成功功、且要要驗(yàn)證銀銀行簽名名、訂單單金額等等信息是是否與商商戶端記記錄一致致。指令失敗敗：注意可能能收到多多筆失敗敗。客戶戶支付失失敗時(shí)可可以重提提此筆訂訂單到銀銀行支付付。指令可疑疑：由于網(wǎng)銀銀系統(tǒng)與與后臺(tái)業(yè)業(yè)務(wù)處理理系統(tǒng)間間通訊異異常，造造成網(wǎng)銀銀不能確確認(rèn)支付付指令結(jié)結(jié)果，則則此筆

22、指指令為可可疑指令令；可疑疑指令將將被自動(dòng)動(dòng)批復(fù)，商戶、客戶可可于第二二日查詢?cè)冎噶顮顮顟B(tài)。沒(méi)有收到到銀行通通知：由于銀行行、商戶戶兩端服服務(wù)器或或者互聯(lián)聯(lián)網(wǎng)通訊訊等原因因可能造造成商戶戶端接收收不到銀銀行通知知。當(dāng)沒(méi)沒(méi)有收到到銀行通通知時(shí)，可登錄錄工行商商戶服務(wù)務(wù)網(wǎng)站手手工查詢?cè)冎噶顮顮顟B(tài)或者者商戶調(diào)調(diào)用查詢?cè)兘涌谧宰詣?dòng)處理理。商戶返回回取貨地地址：取貨地址址（也可可稱為商商戶收到到銀行成成功支付付后的商商戶端確確認(rèn)地址址）：如果有取取貨地址址則及時(shí)時(shí)返回取取貨地址址，沒(méi)有有取貨地地址需及及時(shí)關(guān)閉閉連接；因?yàn)殂y銀行端先先進(jìn)行訂訂單支付付清算，然后給給商戶發(fā)發(fā)送通知知，在商商戶返回回取貨地地址

23、或者者關(guān)閉連連接后，才顯示示交易結(jié)結(jié)果給客客戶，整整個(gè)過(guò)程程是串行行的；如如果商戶戶在收到到銀行通通知后，不及時(shí)時(shí)返回或或關(guān)閉連連接，將將可能造造成客戶戶端等待待超時(shí)，無(wú)法顯顯示最終終的交易易結(jié)果頁(yè)頁(yè)面。如果商戶戶端接收收到銀行行通知消消息，進(jìn)進(jìn)行后續(xù)續(xù)檢查和和處理時(shí)時(shí)，商戶戶自己程程序出現(xiàn)現(xiàn)異常，不應(yīng)將將錯(cuò)誤信信息返回回給銀行行。銀行行只接收收取貨地地址的返返回，商商戶程序序異常時(shí)時(shí)，應(yīng)及及時(shí)關(guān)閉閉和銀行行的連接接。如果果商戶返返回其他他非取貨貨地址的的信息，銀行端端將驗(yàn)證證返回信信息不是是有效的的URLL而記錄錄錯(cuò)誤日日志，在在給客戶戶的交易易結(jié)果頁(yè)頁(yè)面不會(huì)會(huì)有商戶戶返回的的內(nèi)容。三、安全

24、全APII說(shuō)明：為了保證證商戶提提交訂單單數(shù)據(jù)和和銀行通通知信息息數(shù)據(jù)的的完整性性，不可可抵賴性性，現(xiàn)提提供一套套用于信信息簽名名、驗(yàn)簽簽和BAASE664編解解碼的函函數(shù)。商商戶開(kāi)發(fā)發(fā)時(shí)使用用這套函函數(shù)和工工行頒發(fā)發(fā)的商戶戶證書(shū)進(jìn)進(jìn)行商戶戶訂單信信息簽名名；簽名名數(shù)據(jù)項(xiàng)項(xiàng)和順序序均固定定，具體體格式可可參見(jiàn)上上一節(jié)的的數(shù)據(jù)定定義；同同時(shí)使用用這套AAPI和和銀行公公鑰可以以驗(yàn)證銀銀行通知知消息的的有效性性。安全APPI的使使用方法法可參見(jiàn)見(jiàn)【開(kāi)發(fā)發(fā)APII接口】目錄中中不同開(kāi)開(kāi)發(fā)語(yǔ)言言的說(shuō)明明和deemo程程序；四、開(kāi)發(fā)發(fā)步驟商戶程序序需在銀銀行模擬擬測(cè)試環(huán)環(huán)境上進(jìn)進(jìn)行聯(lián)調(diào)調(diào)后，再再投產(chǎn)，以

25、下說(shuō)說(shuō)明聯(lián)調(diào)調(diào)開(kāi)發(fā)步步驟。生成訂單單：商戶和當(dāng)當(dāng)?shù)匦新?lián)聯(lián)系，申申請(qǐng)聯(lián)調(diào)調(diào)測(cè)試；由當(dāng)?shù)氐匦性谀ＤM測(cè)試試環(huán)境錄錄入商戶戶信息，生成商商戶證書(shū)書(shū)（pffx格式式）；并并提供銀銀行模擬擬測(cè)試環(huán)環(huán)境的銀銀行證書(shū)書(shū)公鑰文文件（用用于驗(yàn)證證銀行簽簽名時(shí)使使用）；商戶或者者銀行用用證書(shū)拆拆分工具具將pffx格式式的商戶戶證書(shū)拆拆分成擴(kuò)擴(kuò)展名為為crtt的公鑰鑰文件和和擴(kuò)展名名為keey的私私鑰文件件；（這這兩個(gè)文文件用于于商戶開(kāi)開(kāi)發(fā)APPI調(diào)用用來(lái)進(jìn)行行商戶訂訂單數(shù)據(jù)據(jù)簽名）商戶進(jìn)行行開(kāi)發(fā)，準(zhǔn)備【C2CC商戶提提交表單單接口定定義】一一節(jié)中要要求的訂訂單數(shù)據(jù)據(jù)；其中訂單單簽名數(shù)數(shù)據(jù)meerSiignMMsg

26、字字段需要要根據(jù)【商戶提提交表單單簽名mmerSSignnMsgg格式】一一節(jié)中規(guī)規(guī)定數(shù)據(jù)據(jù)項(xiàng)和順順序來(lái)拼拼接成明明文串；然后使使用提供供的APPI函數(shù)數(shù)和商戶戶私鑰進(jìn)進(jìn)行簽名名，得到到簽名串串，然后后做BAASE664編碼碼；其中商城城證書(shū)公公鑰meerCeert字字段需要要使用AAPI函函數(shù)做BBASEE64編編碼；準(zhǔn)備好訂訂單數(shù)據(jù)據(jù)，即完完成訂單單提交的的開(kāi)發(fā)；之后只只要將訂訂單提交交銀行接接收入口口“htttps:/銀行地地址/sservvlett/ICCBCIINBSSEBuusinnesssSerrvleet”，銀行行來(lái)處理理C2CC指令的的資金支支付；接收通知知：如果商戶戶需要銀

27、銀行實(shí)時(shí)時(shí)發(fā)送交交易結(jié)果果，則需需要在訂訂單的通通知類(lèi)型型nottifyyTyppe設(shè)置置成“HS” ，并并設(shè)置有有效的接接收銀行行通知的的接收地地址meerURRL字段段，銀行行在支付付處理完完成后會(huì)會(huì)向此地地址poost交交易結(jié)果果表單，表單數(shù)數(shù)據(jù)項(xiàng)已已在【CC2C通通知商戶戶交易結(jié)結(jié)果接口口定義】中說(shuō)明明；商戶接收收到銀行行通知后后，需使使用開(kāi)發(fā)發(fā)APII和銀行行公鑰來(lái)來(lái)驗(yàn)證銀銀行簽名名，以確確保通知知消息的的有效性性，以下下簡(jiǎn)要說(shuō)說(shuō)明驗(yàn)證證步驟：商戶收到到銀行通通知，即即接收到到【C2CC通知商商戶交易易結(jié)果接接口定義義】中說(shuō)說(shuō)明的各各字段；各字段段使用UURLeencoode，如果商

28、商戶端wweb服服務(wù)器沒(méi)沒(méi)有自動(dòng)動(dòng)將各字字段進(jìn)行行URLLdeccodee，則商商戶程序序需手工工進(jìn)行UURL解解碼；獲得各字字段取值值后，根根據(jù)【通通知消息息銀行簽簽名數(shù)據(jù)據(jù)bannkSiignMMsg格格式】格格式中說(shuō)說(shuō)明的數(shù)數(shù)據(jù)項(xiàng)和和順序，拼成銀銀行端簽簽名數(shù)據(jù)據(jù)明文；使用商戶戶開(kāi)發(fā)AAPI和和銀行公公鑰文件件對(duì)表單單中的銀銀行簽名名bannkSiignMMsg進(jìn)進(jìn)行驗(yàn)簽簽；驗(yàn)簽成功功后，為為確保數(shù)數(shù)據(jù)一致致，建議議商戶比比較一下下通知消消息中訂訂單金額額、賣(mài)家家卡號(hào)等等關(guān)鍵信信息和自自己記錄錄的是否否一致；商戶根據(jù)據(jù)交易結(jié)結(jié)果trranSStatt來(lái)更新新自己的的指令狀狀態(tài)和相相關(guān)數(shù)據(jù)

29、據(jù)庫(kù)信息息；如果商戶戶沒(méi)有信信息返回回給銀行行則直接接關(guān)閉此此連接；如果商商戶需要要提供客客戶取貨貨地址或或者希望望客戶到到商戶自自己的確確認(rèn)頁(yè)面面，則需需要返回回取貨地地址或確確認(rèn)頁(yè)面面的URRL給銀銀行，銀銀行將在在顯示給給客戶的的交易結(jié)結(jié)果頁(yè)面面顯示此此URLL的鏈接接供客戶戶點(diǎn)擊；五、樣例例：商戶提交交訂單fformm1、訂單單只能使使用POOST方方式提交交；使用用htttps協(xié)協(xié)議通訊訊；2、接收收serrvleet名稱稱固定為為：/sservvlett/ICCBCIINBSSEBuusinnesssSerrvleet3、銀行行地址：如果是是生產(chǎn)則則為“n”，若為為模擬測(cè)測(cè)試環(huán)境境

30、則為“”接口名稱稱固定為為“ICBBC_PPERBBANKK_C22C”接口版本本目前為為“1.00.0.0”訂單號(hào)商商戶端產(chǎn)產(chǎn)生，一一天內(nèi)不不能重復(fù)復(fù)。金額以分分為單位位金額以分分為單位位幣種目前前只支持持人民幣幣，代碼碼為“0011”銀行提供供銀行提供供工行牡丹丹卡中文使用用GBKK編碼“1”判判斷該客客戶是否否與商戶戶聯(lián)名；取值“0”不檢驗(yàn)驗(yàn)客戶是是否與商商戶聯(lián)名名。HS方式式實(shí)時(shí)發(fā)發(fā)送通知知；AGG方式不不發(fā)送通通知；接收銀行行通知地地址，目目前只支支持htttp協(xié)協(xié)議800端口當(dāng)通知方方式是“HS”是有效效；取值“00”：無(wú)論論支付成成功或者者失敗，銀行都都向商戶戶發(fā)送交交易通知知信

31、息；取值“1”，銀行行只向商商戶發(fā)送送交易成成功的通通知信息息。14位時(shí)時(shí)間戳商戶簽名名數(shù)據(jù)BBASEE64編編碼商戶證書(shū)書(shū)公鑰BBASEE64編編碼 以上五個(gè)個(gè)字段用用于客戶戶支付頁(yè)頁(yè)面顯示示備注字段段備注字段段Langguagge, ENN_USS為英文文版 注意商商戶提交交訂單數(shù)數(shù)據(jù)不能能提交接接口中沒(méi)沒(méi)有定義義的字段段，提交交按鈕不不能設(shè)置置namme屬性性，如果果設(shè)置了了，提交交按鈕的的值將作作為一個(gè)個(gè)變量提提交，可可能造成成數(shù)據(jù)檢檢查錯(cuò)誤誤。銀行通知知htttp報(bào)文文：（此樣例例為銀行行通知消消息的hhttpp報(bào)文的的數(shù)據(jù)內(nèi)內(nèi)容部分分，省略略htttp報(bào)頭頭）inteerfaace

32、NNamee=ICCBC_PERRBANNK_CC2C&iinteerfaaceVVerssionn=1.0.00.0&ordderIID=0001&TraanSeeriaalNoo=10080555000&ammounnt=220000&meerFeeeAmmt=11&cuurTyype=0011&meerIDD=02200EEC30000000111&meerAccct=0200002291009000003300779&vvendderCCarddNumm=9555888002200110011319909&vennderrNamme=%D5%D4%C0%DA&cusstommCarrd

33、Nuum=&cusstommNamme=&verrifyyJoiinFllag=0&JJoinnFlaag=&UseerNuum=&ressulttTyppe=00&orrderrDatte=2200550800215524113&nnotiifyDDatee=2000500802215224599&trranSStatt=&ccommmentt=3119900-%C4%FA%B5%C4%B8%F6%C8%CB%CD%F8%C9%CF%D2%F8%D0%D0%D6%A7%B8%B6%C3%DC%C2%EB%B2%BB%D5%FD%C8%B7%A3%AC%C7%EB%D6%D8%D0%C2%CA%E4%C8%EB%A1%A3+&reemarrk1=%D55%E22%C00%EFF%BFF%C99%D22%D44%CAA%E44%C88%EBB50%B8%F6%BA%BA%D7%D6&remmarkk2=%D5%E2%C0%EF%BF%C9%D2%D4%CA%E4%C8%EB550%BB8%FF6%BBA%B