招商銀行網(wǎng)上支付商戶手冊(cè)

1、招商銀行網(wǎng)上支付商戶手冊(cè)修訂日期：2005年8月1日目錄TOC o 1-3 h z HYPERLINK l _Toc110673354 手冊(cè)說(shuō)明明 PAGEREF _Toc110673354 h 2 HYPERLINK l _Toc110673355 1本手手冊(cè)的讀讀者范圍圍 PAGEREF _Toc110673355 h 2 HYPERLINK l _Toc110673356 2前提提條件和和相關(guān)信信息 PAGEREF _Toc110673356 h 2 HYPERLINK l _Toc110673357 3相對(duì)對(duì)以前版版本的更更新 PAGEREF _Toc110673357 h 2 HYP

2、ERLINK l _Toc110673358 一招商商銀行網(wǎng)網(wǎng)上支付付簡(jiǎn)介 PAGEREF _Toc110673358 h 2 HYPERLINK l _Toc110673359 1什么么是招商商銀行網(wǎng)網(wǎng)上支付付 PAGEREF _Toc110673359 h 2 HYPERLINK l _Toc110673360 2如何何成為招招商銀行行網(wǎng)上支支付特約約商戶 PAGEREF _Toc110673360 h 2 HYPERLINK l _Toc110673361 3如何何使用招招商銀行行網(wǎng)上支支付系統(tǒng)統(tǒng) PAGEREF _Toc110673361 h 3 HYPERLINK l _Toc110

3、673362 4加入入招商銀銀行網(wǎng)上上支付，對(duì)商戶戶電腦系系統(tǒng)有什什么要求求 PAGEREF _Toc110673362 h 3 HYPERLINK l _Toc110673363 5如何何與招商商銀行聯(lián)聯(lián)系 PAGEREF _Toc110673363 h 3 HYPERLINK l _Toc110673364 6招商商銀行網(wǎng)網(wǎng)上支付付的安全全措施 PAGEREF _Toc110673364 h 3 HYPERLINK l _Toc110673365 二系統(tǒng)統(tǒng)管理 PAGEREF _Toc110673365 h 4 HYPERLINK l _Toc110673366 1實(shí)體體關(guān)系 PAGERE

4、F _Toc110673366 h 4 HYPERLINK l _Toc110673367 2系統(tǒng)統(tǒng)管理 PAGEREF _Toc110673367 h 5 HYPERLINK l _Toc110673368 三支付付交易 PAGEREF _Toc110673368 h 6 HYPERLINK l _Toc110673369 1連接接方式11 PAGEREF _Toc110673369 h 6 HYPERLINK l _Toc110673370 2連接接方式22 PAGEREF _Toc110673370 h 7 HYPERLINK l _Toc110673371 3連接接方式33 PAGER

5、EF _Toc110673371 h 10 HYPERLINK l _Toc110673372 四人工工定單管管理 PAGEREF _Toc110673372 h 12 HYPERLINK l _Toc110673373 1操作作員登錄錄 PAGEREF _Toc110673373 h 12 HYPERLINK l _Toc110673374 2結(jié)帳帳 PAGEREF _Toc110673374 h 12 HYPERLINK l _Toc110673375 3部分分結(jié)帳 PAGEREF _Toc110673375 h 12 HYPERLINK l _Toc110673376 4撤銷銷 PAGE

6、REF _Toc110673376 h 12 HYPERLINK l _Toc110673377 5自動(dòng)動(dòng)撤消 PAGEREF _Toc110673377 h 13 HYPERLINK l _Toc110673378 6退款款 PAGEREF _Toc110673378 h 13 HYPERLINK l _Toc110673379 五程序序定單管管理 PAGEREF _Toc110673379 h 13 HYPERLINK l _Toc110673380 1程序序定單管管理簡(jiǎn)介介 PAGEREF _Toc110673380 h 13 HYPERLINK l _Toc110673381 2商戶戶

7、開發(fā)指指引 PAGEREF _Toc110673381 h 13 HYPERLINK l _Toc110673382 21采用支支付方式式1的商戶戶 PAGEREF _Toc110673382 h 14 HYPERLINK l _Toc110673383 22采用支支付方式式2、3的商戶戶 PAGEREF _Toc110673383 h 14 HYPERLINK l _Toc110673384 23分頁(yè)方方式查詢?cè)兊氖褂糜梅椒?PAGEREF _Toc110673384 h 15 HYPERLINK l _Toc110673385 24交易管管理開發(fā)發(fā)包使用用注意事事項(xiàng)和建建議 PAGEREF

8、 _Toc110673385 h 15 HYPERLINK l _Toc110673386 六舊商商戶系統(tǒng)統(tǒng)用戶須須知 PAGEREF _Toc110673386 h 15 HYPERLINK l _Toc110673387 附錄：開開發(fā)包接接口參考考 PAGEREF _Toc110673387 h 16 HYPERLINK l _Toc110673388 1. DDLL版版本的開開發(fā)包 PAGEREF _Toc110673388 h 16 HYPERLINK l _Toc110673389 1. 11. 使使用Liib形式式的商戶戶開發(fā)包包 PAGEREF _Toc110673389 h 1

9、6 HYPERLINK l _Toc110673390 12. 使用用Dlll形式的的商戶開開發(fā)包 PAGEREF _Toc110673390 h 16 HYPERLINK l _Toc110673391 13. DLLL的其其他使用用形式 PAGEREF _Toc110673391 h 16 HYPERLINK l _Toc110673392 14開發(fā)包包中的AAPI說(shuō)明明： PAGEREF _Toc110673392 h 16 HYPERLINK l _Toc110673393 2. 控控件版本本的交易易管理開開發(fā)包 PAGEREF _Toc110673393 h 21 HYPERLINK

10、 l _Toc110673394 21注冊(cè)控控件 PAGEREF _Toc110673394 h 21 HYPERLINK l _Toc110673395 22開發(fā)包包中的AAPI說(shuō)說(shuō)明 PAGEREF _Toc110673395 h 21 HYPERLINK l _Toc110673396 3. JJavaa版本的的交易管管理開發(fā)發(fā)包 PAGEREF _Toc110673396 h 24 HYPERLINK l _Toc110673397 1. 使使用Jaava版版商戶開開發(fā)包前前的準(zhǔn)備備工作 PAGEREF _Toc110673397 h 24 HYPERLINK l _Toc110673

11、398 2檢驗(yàn)驗(yàn)數(shù)字簽簽名APPI說(shuō)明明 PAGEREF _Toc110673398 h 25 HYPERLINK l _Toc110673399 2定單單管理AAPI說(shuō)說(shuō)明 PAGEREF _Toc110673399 h 26手冊(cè)說(shuō)明明1本手手冊(cè)的讀讀者范圍圍本手冊(cè)適適用于希希望成為為招商銀銀行網(wǎng)上上支付商商戶，或或者已經(jīng)經(jīng)成為招招商銀行行網(wǎng)上支支付商戶戶的業(yè)務(wù)務(wù)管理人人員、電電腦系統(tǒng)統(tǒng)開發(fā)人人員。2前提提條件和和相關(guān)信信息前提條件件是對(duì)IInteerneet、電電腦有初初步的了了解，對(duì)對(duì)一些常常見的技技術(shù)名詞詞有一定定的認(rèn)識(shí)識(shí)。3相對(duì)對(duì)以前版版本的更更新相對(duì)以前前版本，本文更更新了商商戶內(nèi)

12、部部管理模模式，增增加了新新的管理理功能，增強(qiáng)了了連接方方式。一招商商銀行網(wǎng)網(wǎng)上支付付簡(jiǎn)介1什么么是招商商銀行網(wǎng)網(wǎng)上支付付招商銀行行網(wǎng)上支支付是招招商銀行行提供的的網(wǎng)上付付款結(jié)算算平臺(tái)，通過(guò)這這個(gè)平臺(tái)臺(tái)，數(shù)千千萬(wàn)招商商銀行持持卡人可可以向特特約商戶戶進(jìn)行網(wǎng)網(wǎng)上付款款，全國(guó)國(guó)聯(lián)網(wǎng)，實(shí)時(shí)到到帳。2如何何成為招招商銀行行網(wǎng)上支支付特約約商戶商戶與當(dāng)當(dāng)?shù)卣猩躺蹄y行的的分行個(gè)個(gè)人銀行行部聯(lián)系系，申請(qǐng)請(qǐng)成為我我行的網(wǎng)網(wǎng)上特約約商戶，填寫相相關(guān)資料料。聯(lián)系系方式及及聯(lián)系人人，請(qǐng)查查閱招商商銀行網(wǎng)網(wǎng)站（hhttpp:/wwww.cmmbchhinaa.coom）。辦理簽定定合約手手續(xù)。商戶在我我行開立立結(jié)算帳

13、帳戶。結(jié)結(jié)算帳戶戶設(shè)立浮浮動(dòng)備付付金，備備付金比比例按照照商戶資資信情況況確定。 根據(jù)銀行行提供的的技術(shù)接接口，商商戶聯(lián)通通與我行行的支付付網(wǎng)絡(luò)。 3如何何使用招招商銀行行網(wǎng)上支支付系統(tǒng)統(tǒng)付款通道道。付款款通道是是持卡人人進(jìn)行網(wǎng)網(wǎng)上付款款的界面面，商戶戶系統(tǒng)以以Intternnet超超鏈接的的方式，從商戶戶網(wǎng)站轉(zhuǎn)轉(zhuǎn)到銀行行的付款款通道，對(duì)商戶戶電腦系系統(tǒng)沒(méi)有有特殊要要求。商戶管理理。商戶戶可以通通過(guò)以下下幾種方方式管理理招商銀銀行的定定單：1 商戶業(yè)業(yè)務(wù)管理理網(wǎng)站：Webb界面，人工管管理定單單，為特特約商戶戶提供全全面的網(wǎng)上支支付業(yè)務(wù)務(wù)管理功功能。2 定單下下載工具具：方便便特約商商戶下載載

14、自己的的定單數(shù)數(shù)據(jù)，進(jìn)進(jìn)行進(jìn)一一步處理理。3 支付軟軟件開發(fā)發(fā)包：提提供二次次開發(fā)接接口，在在商戶系系統(tǒng)中嵌嵌入支付付管理功功能，自動(dòng)動(dòng)、實(shí)時(shí)時(shí)管理定定單。4加入入招商銀銀行網(wǎng)上上支付，對(duì)商戶戶電腦系系統(tǒng)有什什么要求求招商銀行行提高多多種方式式供商戶戶使用，商戶可可根據(jù)自自己的情情況選擇擇。最簡(jiǎn)單的的方式，商戶以以網(wǎng)頁(yè)中中的Innterrnett超鏈接接轉(zhuǎn)到銀銀行的付付款通道道，以商商戶業(yè)務(wù)務(wù)管理網(wǎng)網(wǎng)站管理理定單。在這種種情況下下，商戶戶甚至可可以沒(méi)有有自己的的電腦系系統(tǒng)。如果商戶戶不具備備程序開開發(fā)能力力，但有有常見的的辦公處處理軟件件使用經(jīng)經(jīng)驗(yàn)，可可以通過(guò)過(guò)定單下下載工具具下載數(shù)數(shù)據(jù)，結(jié)結(jié)

15、合商戶戶業(yè)務(wù)管管理網(wǎng)站站，自己己在辦公公處理軟軟件中處處理。如果商戶戶開發(fā)能能力較強(qiáng)強(qiáng)，可以以通過(guò)銀銀行提供供的軟件件開發(fā)包包開發(fā)軟軟件，把把自己的的系統(tǒng)和和銀行對(duì)對(duì)接，就就可以全全自動(dòng)、實(shí)時(shí)地地處理業(yè)業(yè)務(wù)。5如何何與招商商銀行聯(lián)聯(lián)系請(qǐng)到招商商銀行網(wǎng)網(wǎng)站（hhttpp:/wwww.cmmbchhinaa.coom）查查閱。6招商商銀行網(wǎng)網(wǎng)上支付付的安全全措施基本的網(wǎng)網(wǎng)上交易易的傳輸輸安全控控制手段段采用SSSL(Seccuree Soockeet LLayeer)，SSLL是一種種被廣泛泛使用的的INTTERNNET傳傳輸加密密標(biāo)準(zhǔn)。銀行端端的WEEB SSERVVER將將安裝一一個(gè)證書書(C

16、eertiificcatee)，客客戶端的的瀏覽器器發(fā)送CCGI請(qǐng)請(qǐng)求時(shí)使使用htttpss協(xié)議。所有用用htttps發(fā)發(fā)送的請(qǐng)請(qǐng)求以及及Webb Seerveer返回回的結(jié)果果都會(huì)自自動(dòng)使用用SSLL加密。對(duì)商戶來(lái)來(lái)說(shuō)，商商戶在其其管理電電腦上登登錄時(shí)，要提供供登錄密密碼。為為了增加加商戶登登錄的安安全性, 在登登錄頁(yè)之之前增加加了一個(gè)個(gè)預(yù)登錄錄頁(yè),商戶需需先輸入入預(yù)登錄錄密碼才才能進(jìn)入入到登錄錄頁(yè)，預(yù)預(yù)登錄密密碼不能能修改。每個(gè)商戶戶可以設(shè)設(shè)置多個(gè)個(gè)操作員員，每個(gè)個(gè)操作員員擁有不不同的密密碼，其其權(quán)限以以崗位的的方式組組織，每每個(gè)崗位位有不同同的權(quán)限限，以實(shí)實(shí)現(xiàn)企業(yè)業(yè)內(nèi)部的的安全管管理。對(duì)

17、對(duì)風(fēng)險(xiǎn)較較高的操操作，如如退款，還要求求配合企企業(yè)證書書IC卡操操作。二系統(tǒng)統(tǒng)管理1實(shí)體體關(guān)系商戶的系系統(tǒng)管理理包括以以下內(nèi)容容：店鋪店鋪是生生成定單單的基礎(chǔ)礎(chǔ)實(shí)體，每個(gè)商商戶至少少有一個(gè)個(gè)由銀行行自動(dòng)生生成的店店鋪，也也可以由由商戶自自行設(shè)置置多個(gè)店店鋪，以以便區(qū)分分不同的的交易，以及不不同的定定單管理理，等等等。注意，這這里的店店鋪并非非某些支支付平臺(tái)臺(tái)網(wǎng)站上上的“店鋪”概念，這里的的“店鋪”純粹是是為了商商戶分權(quán)權(quán)限管理理定單，例如為為沖值類類型支付付分配一一個(gè)“店鋪”，為購(gòu)購(gòu)物類型型支付分分配另一一個(gè)“店鋪”，等等等，數(shù)目目不會(huì)很很大，否否則商戶戶內(nèi)部管管理這些些權(quán)限將將是非常常煩瑣的

18、的。而支支付平臺(tái)臺(tái)網(wǎng)站上上“店鋪”，可能能是某個(gè)個(gè)公司，甚至某某個(gè)人在在支付平平臺(tái)上注注冊(cè)的基基本單位位，其數(shù)數(shù)目是相相當(dāng)龐大大的。定單每筆交易易視為一一個(gè)定單單，由商商戶生成成定單號(hào)號(hào)，以后后可對(duì)該該定單進(jìn)進(jìn)行后續(xù)續(xù)處理，如結(jié)帳帳（包括括結(jié)帳、部分結(jié)結(jié)帳、撤撤消）、退款、查詢等等。崗位崗位實(shí)際際上是權(quán)權(quán)限的組組合，可可以精細(xì)細(xì)到對(duì)不不同店鋪鋪生成的的定單進(jìn)進(jìn)行不同同的操作作權(quán)限，例如AA崗位能能對(duì)00001店店鋪定單單查詢，B崗位能能對(duì)00001、00002店鋪鋪定單結(jié)結(jié)帳、退退款，等等等。每每個(gè)崗位位可以管管理多個(gè)個(gè)店鋪，每個(gè)店店鋪也可可以由多多個(gè)崗位位管理。操作員操作員是是商戶管管理定單

19、單的直接接操作者者，每個(gè)個(gè)操作員員有一個(gè)個(gè)4位數(shù)數(shù)字的操操作員號(hào)號(hào)，每個(gè)個(gè)操作員員必須賦賦予至少少一個(gè)崗崗位，也也可以賦賦予多個(gè)個(gè)崗位，以適應(yīng)應(yīng)企業(yè)內(nèi)內(nèi)部靈活活的管理理方式。操作員員的權(quán)限限由其崗崗位決定定。系統(tǒng)管理理員系統(tǒng)管理理員可以以對(duì)店鋪鋪、崗位位、操作作員等進(jìn)進(jìn)行增加加、修改改、刪除除等操作作。以上實(shí)體體的關(guān)系系可用下下圖說(shuō)明明：2系系統(tǒng)管理理系統(tǒng)管管理指商商戶系統(tǒng)統(tǒng)管理員員對(duì)店鋪鋪、崗位位、操作作員等進(jìn)進(jìn)行增加加、修改改、刪除除等操作作。通過(guò)過(guò)系統(tǒng)管管理，商商戶可以以靈活配配置自己己的業(yè)務(wù)務(wù)模式，適應(yīng)自自己的業(yè)業(yè)務(wù)需求求。系統(tǒng)管理理員登錄錄每個(gè)商戶戶有一個(gè)個(gè)系統(tǒng)管管理員，商戶開開通招

20、商商銀行網(wǎng)網(wǎng)上支付付后，銀銀行自動(dòng)動(dòng)生成一一個(gè)系統(tǒng)統(tǒng)管理員員。系統(tǒng)統(tǒng)管理員員登錄需需要選擇擇開戶分分行，輸輸入商戶戶號(hào)和管管理員密密碼。店鋪管理理系統(tǒng)管理理員可以以增加、修改、刪除店店鋪。一一般來(lái)說(shuō)說(shuō)，一個(gè)個(gè)商戶只只需一個(gè)個(gè)店鋪即即可，但但如果需需要對(duì)定定單區(qū)別別處理，可以增增加新店店鋪。例例如跨地地區(qū)的商商戶需要要把北京京、上海海的定單單分開處處理；再再如需要要分配不不同的操操作員管管理不同同類型的的定單，等等。但是，店鋪不不宜太多多，一般般不要超超過(guò)5個(gè)個(gè)，否則則商戶內(nèi)內(nèi)部的管管理、權(quán)權(quán)限的分分配調(diào)整整等等將將比較煩煩瑣。崗位管理理系統(tǒng)管理理員可以以增加、修改、刪除崗崗位。崗崗位實(shí)際際上是

21、權(quán)權(quán)限的組組合，因因此崗位位不宜太太多，否否則商戶戶內(nèi)部的的管理、權(quán)限的的分配調(diào)調(diào)整等等等將比較較煩瑣。操作員管管理系統(tǒng)管理理員可以以增加、修改、刪除操操作員。每個(gè)操操作員必必須賦予予至少一一個(gè)崗位位，也可可以賦予予多個(gè)崗崗位。三支付付交易1連接接方式11在網(wǎng)上交交易過(guò)程程中，用用戶先在在商戶網(wǎng)網(wǎng)頁(yè)中選選擇商品品。當(dāng)用用戶在支支付網(wǎng)頁(yè)頁(yè)中選擇擇招商銀銀行網(wǎng)上上支付付付款時(shí)，商戶支支付網(wǎng)頁(yè)頁(yè)向銀行行WEBB系統(tǒng)發(fā)發(fā)出支付付命令(見圖一一)。銀行行WEBB系統(tǒng)處處理完支支付請(qǐng)求求后，將將回送用用戶支付付結(jié)果頁(yè)頁(yè)面。 銀行 WEB 商戶 WEB(1)生成支付網(wǎng)頁(yè)(2)支付命令(3)支付結(jié)果頁(yè) 用戶瀏

22、覽器 連接方式式1支付命命令格式式如下：htttpss:/wwww.cmmbchhinaa.coom/nnetppaymmentt/BaaseHHttpp.dlll?PPrePPayCC?BraanchhID=xxxxx&CooNo=xxxxxxxx&BiillNNo=xxxxxxxx&Amoountt=xxxx.xxx&DDatee=YYYYYMMMDDD參數(shù)說(shuō)說(shuō)明：BrrancchIDD:商戶開開戶分行行號(hào)，請(qǐng)請(qǐng)咨詢開開戶的招招商銀行行分支機(jī)機(jī)構(gòu)；CooNo:商戶號(hào)號(hào)，6位數(shù)字字，由銀銀行在商商戶開戶戶時(shí)確定定；BiillNNo:定單號(hào)號(hào)，6位或110位數(shù)數(shù)字，由由商戶系系統(tǒng)生成成，一天天

23、內(nèi)不能能重復(fù)；Ammounnt:定單總總金額，格式為為：xxxxx.xx元元；Daate:交易日日期，格格式：YYYYYYMMDDD。支付頁(yè)頁(yè)面提交交的FOORM格格式示例例如下：定單單號(hào)00000023金額8118.666日期20005001011連接方式式1的特點(diǎn)點(diǎn)是商戶戶WEBB系統(tǒng)通通過(guò)支付付頁(yè)面把把控制引引導(dǎo)到銀銀行WEEB系統(tǒng)統(tǒng)，銀行行WEBB系統(tǒng)處處理完支支付請(qǐng)求求后回送送支付結(jié)結(jié)果頁(yè)面面給用戶戶，控制制沒(méi)有再再回到商商戶WEEB系統(tǒng)統(tǒng)。商戶在銀銀行網(wǎng)站站進(jìn)行定定單管理理時(shí)可以以知道定定單的付付款情況況。如果果商戶系系統(tǒng)需要要立刻核核實(shí)定單單付款情情況，可可以使用用一個(gè)銀銀行提供

24、供的開發(fā)發(fā)包中的的定單狀狀態(tài)查詢?cè)兘涌谙蛳蜚y行WWEB系系統(tǒng)查詢?cè)兡硞€(gè)定定單的狀狀態(tài)。有有關(guān)直聯(lián)聯(lián)定單狀狀態(tài)查詢?cè)兘涌谡?qǐng)請(qǐng)見附錄錄。2連接接方式22某些商戶戶在用戶戶完成支支付過(guò)程程后希望望控制能能夠從銀銀行WEEB系統(tǒng)統(tǒng)自動(dòng)轉(zhuǎn)轉(zhuǎn)回商戶戶WEBB系統(tǒng)，并且商商戶WEEB系統(tǒng)統(tǒng)能夠知知道用戶戶的付款款情況。比如，出售信信息產(chǎn)品品的商戶戶，在支支付成功功的情況況下，商商戶的結(jié)結(jié)果頁(yè)除除包含支支付成功功通知信信息外，還可以以包含用用戶購(gòu)買買的信息息產(chǎn)品。為了解決決這個(gè)問(wèn)問(wèn)題，要要求商戶戶WEBB系統(tǒng)必必須提供供一個(gè)支支付結(jié)果果通知命命令。銀銀行WEEB系統(tǒng)統(tǒng)在收到到支付網(wǎng)網(wǎng)頁(yè)發(fā)出出的支付付命令后后，

25、先執(zhí)執(zhí)行扣款款操作，然后調(diào)調(diào)用商戶戶WEBB系統(tǒng)的的支付結(jié)結(jié)果通知知命令，把支付付結(jié)果通通知商戶戶WEBB系統(tǒng)，同時(shí)取取得商戶戶WEBB系統(tǒng)生生成的支支付結(jié)果果頁(yè)面(由支付付結(jié)果通通知命令令生成)。最后后，銀行行WEBB系統(tǒng)把把由商戶戶WEBB系統(tǒng)的的支付結(jié)結(jié)果通知知命令生生成的支支付結(jié)果果頁(yè)返回回用戶的的瀏覽器器。這就就是連接接方式22(見下下圖)。 商戶 WEB(1)生成支付網(wǎng)頁(yè)(3)支付結(jié)果通知命令(4)商戶結(jié)果頁(yè)(2)支付命令(5)支付結(jié)果頁(yè) 銀行 WEB 用戶瀏覽器 連接方式式2支付結(jié)果果通知命命令格式式型如：htttp:/wwww.mmercchannt.ccom/patth/PP

26、roccRessultt.dlll?SSuccceedd=.&BiillNNo=.&AAmouunt=.&Datte=.&MMsg=.&siggnatturee=.其中，ppathh和ProocReesullt.ddll由由商戶任任意確定定，并且且支付命命令中可可包含多多個(gè)paath，即可有有patth1/patth2/patth3。參數(shù)數(shù)說(shuō)明：Succceeed：取值Y(成功)或N(失敗敗)；BiillNNo:定單號(hào)號(hào)(由支付付命令送送來(lái))；Amoountt:實(shí)際支支付金額額(由支付付命令送送來(lái))；Daate:交易日日期(主機(jī)交交易日期期)；Msg:銀行通通知用戶戶的支付付結(jié)果消消息。信信息

27、的前前38個(gè)個(gè)字符格格式為：4位分分行號(hào)6位商商戶號(hào)8位銀銀行接受受交易的的日期20位位銀行流流水號(hào)；可以利利用交易易日期銀行流流水號(hào)對(duì)對(duì)該定單單進(jìn)行結(jié)結(jié)帳處理理；Siggnatturee:銀行用用自己的的Priivatte KKey對(duì)對(duì)通知命命令的簽簽名。注意意:商戶系統(tǒng)統(tǒng)如果對(duì)對(duì)銀行通通知命令令的真實(shí)實(shí)性有較較高要求求，必須須用銀行行提供的的開發(fā)包包中的函函數(shù)，結(jié)結(jié)合銀行行的Puubliic KKey（可從網(wǎng)網(wǎng)上下載載或向銀銀行索取取）驗(yàn)證證。具體體用法請(qǐng)請(qǐng)參考附附錄。在Succceeed為Y時(shí)，商商戶在支支付結(jié)果果通知命命令中必必須判斷斷Amoountt的值，該值為為用戶的的實(shí)際支支付金

28、額額，以此此金額為為準(zhǔn)。不不能以之之前系統(tǒng)統(tǒng)產(chǎn)生定定單時(shí)的的金額為為準(zhǔn)！這這是為了了防止用用戶在得得到支付付頁(yè)面后后修改支支付金額額。銀行返回回的交易易日期是是銀行主主機(jī)的交交易日期期，對(duì)于于每天重重復(fù)使用用定單號(hào)號(hào)的商戶戶，可能能會(huì)在00點(diǎn)左右右與商戶戶日期有有1天的的差別，按日期期+定單單號(hào)對(duì)帳帳時(shí)，可可能和商商戶自己己的定單單記錄有有沖突。如果生生成定單單號(hào)永遠(yuǎn)遠(yuǎn)不重復(fù)復(fù)，則可可以按定定單號(hào)和和商戶自自己的定定單記錄錄對(duì)帳，無(wú)須核核對(duì)日期期，因此此不會(huì)有有沖突問(wèn)問(wèn)題，但但是，永永遠(yuǎn)不重重復(fù)的66位定單單號(hào)，部部分商戶戶可能不不夠用，建議這這些商戶戶使用110位的的定單號(hào)號(hào)。在正式交交易中

29、不不要使用用00000000的定單單號(hào)，因因?yàn)闇y(cè)試試接口在在發(fā)通知知時(shí)，定定單號(hào)固固定為00000000。連接方式式2的支付付命令格格式有別別于連接接方式11，其格格式為：htttpss:/wwww.cmmbchhinaa.coomt/nettpayymennt/BBaseeHtttp.ddll?PreePayyC1?BBrannchIID=xxxxxx&CooNo=.&BilllNoo=.& AAmouunt=.&Datte=.&MMercchanntUrrl=.前五個(gè)參參數(shù)同連連接方式式1，第六六個(gè)參數(shù)數(shù)MerrchaantUUrl為為支付結(jié)結(jié)果通知知命令中中參數(shù)部部分之前前的部分分，也就

30、就是htttp:/m/paath/ProocReesullt.ddll。注意：MerrchaantUUrl不不能帶商商戶參數(shù)數(shù)。在方式22中，若若用戶付付款后銀銀行WEEB系統(tǒng)統(tǒng)或者商商戶WEEB系統(tǒng)統(tǒng)出現(xiàn)故故障，則則可能出出現(xiàn)用戶戶已付款款但是商商戶WEEB系統(tǒng)統(tǒng)不知道道的情況況，或者者出現(xiàn)用用戶已付付款但是是用戶瀏瀏覽器未未接收到到結(jié)果頁(yè)頁(yè)的情況況。這類類情況屬屬于正常常情況，商戶可可以主動(dòng)動(dòng)從銀行行系統(tǒng)查查詢?cè)摱ǘ▎蔚恼嬲嬲隣顩r況。商戶戶系統(tǒng)應(yīng)應(yīng)當(dāng)考慮慮相應(yīng)的的解決辦辦法，而而不能依依賴于這這個(gè)通知知到達(dá)與與否，決決定是否否給消費(fèi)費(fèi)者提供供商品或或服務(wù)。和方式11比較，方式2在用戶戶完成

31、支支付操作作后控制制又回到到商戶的的系統(tǒng)(用戶處處于商戶戶WEBB系統(tǒng)生生成的支支付結(jié)果果頁(yè)中)，增加加了銀行行WEBB系統(tǒng)調(diào)調(diào)用商戶戶WEBB系統(tǒng)的的支付結(jié)結(jié)果通知知命令的的過(guò)程。方式2比方式1復(fù)雜，并且商商戶WEEB系統(tǒng)統(tǒng)必須處處理異常常情況。但是方方式2功能較較強(qiáng)，使使支付過(guò)過(guò)程變得得平滑無(wú)無(wú)縫。在商戶的的Webb系統(tǒng)向向銀行返返回結(jié)果果網(wǎng)頁(yè)時(shí)時(shí)，網(wǎng)頁(yè)頁(yè)中應(yīng)當(dāng)當(dāng)有，供銀行行判斷是是否為有有效返回回網(wǎng)頁(yè)，以避免免商戶服服務(wù)器失失控后自自動(dòng)返回回未知的的信息而而使消費(fèi)費(fèi)者迷惑惑。不管管是商戶戶停機(jī)、網(wǎng)絡(luò)中中斷或者者Webb服務(wù)器器失控，銀行都都將屏蔽蔽商戶系系統(tǒng)的問(wèn)問(wèn)題，并并用正常常的網(wǎng)頁(yè)頁(yè)

32、替代商商戶網(wǎng)頁(yè)頁(yè)返回給給消費(fèi)者者，使消消費(fèi)者能能繼續(xù)正正確操作作?？紤]到方方式2比較復(fù)復(fù)雜，并并且需要要連接商商戶端程程序，我我們提供供了測(cè)試試接口以以方便商商戶開發(fā)發(fā)程序時(shí)時(shí)測(cè)試。使用該該測(cè)試接接口模擬擬真實(shí)的的數(shù)據(jù)流流程，但但無(wú)須真真實(shí)的商商戶代碼碼和付款款卡號(hào)，銀行系系統(tǒng)也不不記錄交交易數(shù)據(jù)據(jù)（商戶戶不能查查詢或結(jié)結(jié)帳使用用該測(cè)試試接口產(chǎn)產(chǎn)生的交交易數(shù)據(jù)據(jù)）。測(cè)測(cè)試接口口的使用用方法和和真實(shí)接接口一致致，只需需由真實(shí)實(shí)接口的的PreePayyC1改改為測(cè)試試接口的的TesstPrrepaayC11。即htttpss:/wwww.cmmbchhinaa.coom/nnetppaymment

33、t/BaaseHHttpp.dlll?PPrePPayCC1?BBrannchIID=xxxxxx&CooNo=.&BilllNoo=.& AAmouunt=.&Datte=.&MMercchanntUrrl=.改為httpps:/wwww.ccmbcchinna.ccom/nettpayymennt/BBaseeHtttp.ddll?TesstPrrePaayC1?BBrannchIID=xxxxxx&CooNo=.&BilllNoo=.& AAmouunt=.&Datte=.&MMercchanntUrrl=.。注意：為為防止用用戶利用用測(cè)試接接口擾亂亂商戶正正式運(yùn)行行的服務(wù)務(wù)器，銀銀行的

34、測(cè)測(cè)試接口口通知信信息中，BilllNoo始終為為“00000000”。建議：在本方式式中，雖雖然在消消費(fèi)者付付款成功功后向商商戶發(fā)通通知，但但由于IInteerneet線路路問(wèn)題、商戶網(wǎng)網(wǎng)絡(luò)配置置改變問(wèn)問(wèn)題、商商戶服務(wù)務(wù)器問(wèn)題題、商戶戶程序問(wèn)問(wèn)題等原原因，商商戶最終終接收銀銀行通知知的程序序可能收收不到銀銀行通知知，因此此，商戶戶不能僅僅僅憑是是否收到到銀行通通知確定定是否給給消費(fèi)者者提供服服務(wù)，在在商戶作作系統(tǒng)設(shè)設(shè)計(jì)時(shí)也也應(yīng)當(dāng)考考慮到這這個(gè)因素素。另外外，接收收通知的的程序應(yīng)應(yīng)當(dāng)能處處理重復(fù)復(fù)通知的的情況。3連接接方式33某些商戶戶在使用用連接方方式2后后，還需需要在銀銀行的支支付結(jié)果果通

35、知命命令中帶帶上商戶戶自己的的參數(shù)，比如商商戶希望望知道是是哪個(gè)分分支機(jī)構(gòu)構(gòu)的定單單，定單單在商戶戶內(nèi)部處處理的不不同于定定單號(hào)的的流水號(hào)號(hào)，或者者商戶希希望借助助這個(gè)參參數(shù)建立立完整的的sesssioon，等等等。為了解決決這個(gè)問(wèn)問(wèn)題，在在連接方方式2的的基礎(chǔ)上上，招商商銀行提提供帶商商戶參數(shù)數(shù)的連接接方式。這就是是連接方方式3。 商戶 WEB(3)支付結(jié)果通知命令(1)生成支付網(wǎng)頁(yè)(4)商戶結(jié)果頁(yè)(2)支付命令 用戶瀏覽器 銀行 WEB(5)支付結(jié)果頁(yè)圖三、連連接方式式3由圖示示可知，方式33的流程程與方式式2完全全一樣，只是在在命令格格式上增增加了商商戶參數(shù)數(shù)。連接方式式3的支支付命令令

36、格式有有別于連連接方式式2，其其格式為為：htttpss:/wwww.cmmbchhinaa.coom/nnetppaymmentt/BaaseHHttpp.dlll?PPrePPayCC2? BrrancchIDD=xxxxx&CoNoo=.&BiillNNo=.& Amoountt=.&Daate=.&MerrchaantUUrl=.&MerrchaantPParaa=.參數(shù)說(shuō)說(shuō)明：BrrancchIDD:商戶開開戶分行行號(hào)，請(qǐng)請(qǐng)咨詢開開戶的招招商銀行行分支機(jī)機(jī)構(gòu)；CooNo:商戶號(hào)號(hào)，6位數(shù)字字，由銀銀行在商商戶開戶戶時(shí)確定定；BiillNNo:定單號(hào)號(hào)，6位或110位數(shù)數(shù)字，由由商戶系

37、系統(tǒng)生成成，一天天內(nèi)不能能重復(fù)；Ammounnt:定單總總金額，格式為為：xxxxx.xx元元；Daate:交易日日期，格格式：YYYYYYMMDDD。MerrchaantUUrl支付結(jié)結(jié)果通知知命令中中參數(shù)部部分之前前的部分分，例如如httpp:/wwww.meerchhantt.coom/ccgi_binn/funnctiion.aspp。注意：MMercchanntUrrl自身身不能帶帶商戶參參數(shù)。MercchanntPaara商戶需需要銀行行在支付付結(jié)果通通知中轉(zhuǎn)轉(zhuǎn)發(fā)的商商戶參數(shù)數(shù)。支付結(jié)結(jié)果通知知命令格格式型如如：htttp:/wwww.mmercchannt.ccom/patth/

38、PProccRessultt.dlll?SSuccceedd=.&CooNo=.&=BiillNNo=.&Amouunt=.&Datte=&MerrchaantPParaa=&MMsg=.&siggnatturee=.參數(shù)說(shuō)說(shuō)明：Succceeed：取值Y(成功)或N(失敗敗)；CoNNo:商戶號(hào)號(hào)，6位長(zhǎng)數(shù)數(shù)字，由由銀行在在商戶開開戶時(shí)確確定；BilllNoo:定單號(hào)號(hào)(由支付付命令送送來(lái))；Amoountt:實(shí)際支支付金額額(由支付付命令送送來(lái))；Datte:交易日日期(由支付付命令送送來(lái))；Msg:銀行通通知用戶戶的支付付結(jié)果消消息。信信息的前前38個(gè)個(gè)字符格格式為：4位分分行號(hào)6位商商

39、戶號(hào)8位銀銀行接受受交易的的日期20位位銀行流流水號(hào)；可以利利用交易易日期銀行流流水號(hào)定單號(hào)號(hào)對(duì)該定定單進(jìn)行行結(jié)帳處處理；MerrchaantPParaa：商戶戶自己的的參數(shù)；Siggnatturee:銀行用用自己的的Priivatte KKey對(duì)對(duì)通知命命令的簽簽名。注意:商戶系統(tǒng)統(tǒng)如果對(duì)對(duì)銀行通通知命令令的真實(shí)實(shí)性有較較高要求求，必須須用銀行行提供的的開發(fā)包包中的函函數(shù)，結(jié)結(jié)合銀行行的Puubliic KKey（可從網(wǎng)網(wǎng)上下載載或向銀銀行索取?。?yàn)證證。具體體用法請(qǐng)請(qǐng)參考附附錄。在Succceeed為Y時(shí)，商商戶在支支付結(jié)果果通知命命令中必必須判斷斷Amoountt的值，該值為為用戶的的實(shí)

40、際支支付金額額，以此此金額為為準(zhǔn)。不不能以之之前系統(tǒng)統(tǒng)產(chǎn)生定定單時(shí)的的金額為為準(zhǔn)！這這是為了了防止用用戶在得得到支付付頁(yè)面后后修改支支付金額額。商戶如果果需要不不止一個(gè)個(gè)參數(shù)，可以自自行把參參數(shù)組合合、拼裝裝，但組組合后的的結(jié)果不不能帶有有&字符（如果帶帶有&字符，銀行收收到這樣樣的支付付請(qǐng)求時(shí)時(shí)將認(rèn)為為其后是是另一個(gè)個(gè)參數(shù)，其他可可能被瀏瀏覽器轉(zhuǎn)轉(zhuǎn)義的特特殊字符符也應(yīng)當(dāng)當(dāng)避免），總長(zhǎng)長(zhǎng)不能超超過(guò)1228個(gè)字字節(jié)。例例如，商商戶需要要銀行通通知中轉(zhuǎn)轉(zhuǎn)發(fā)RefeerennceNNo=11234456778&BBrannch=上海&SesssioonIDD=20001009011，則可以在在Pre

41、ePayyC2中中寫成MercchanntPaara=ReffereenceeNo=1233456678|Braanchh=上海海|SeessiionIID=22001109001銀行返回回的交易易日期是是銀行主主機(jī)的交交易日期期，對(duì)于于每天重重復(fù)使用用定單號(hào)號(hào)的商戶戶，可能能會(huì)在00點(diǎn)左右右與商戶戶日期有有1天的的差別，按日期期+定單單號(hào)對(duì)帳帳時(shí)，可可能和商商戶自己己的定單單記錄有有沖突。如果生生成定單單號(hào)永遠(yuǎn)遠(yuǎn)不重復(fù)復(fù)，則可可以按定定單號(hào)和和商戶自自己的定定單記錄錄對(duì)帳，無(wú)須核核對(duì)日期期，因此此不會(huì)有有沖突問(wèn)問(wèn)題，但但是，永永遠(yuǎn)不重重復(fù)的66位定單單號(hào)，部部分商戶戶可能不不夠用，建議這這些

42、商戶戶使用110位的的定單號(hào)號(hào)。在正式交交易中不不要使用用00000000的定單單號(hào)，因因?yàn)闇y(cè)試試接口在在發(fā)通知知時(shí)，定定單號(hào)固固定為00000000。在方式22中，若若用戶付付款后銀銀行WEEB系統(tǒng)統(tǒng)或者商商戶WEEB系統(tǒng)統(tǒng)出現(xiàn)故故障，則則可能出出現(xiàn)用戶戶已付款款但是商商戶WEEB系統(tǒng)統(tǒng)不知道道的情況況，或者者出現(xiàn)用用戶已付付款但是是用戶瀏瀏覽器未未接收到到結(jié)果頁(yè)頁(yè)的情況況。這類類情況屬屬于正常常情況，商戶可可以主動(dòng)動(dòng)從銀行行系統(tǒng)查查詢?cè)摱ǘ▎蔚恼嬲嬲隣顩r況。商戶戶系統(tǒng)應(yīng)應(yīng)當(dāng)考慮慮相應(yīng)的的解決辦辦法，而而不能依依賴于這這個(gè)通知知到達(dá)與與否，決決定是否否給消費(fèi)費(fèi)者提供供商品或或服務(wù)。和方式11

43、比較，方式33在用戶戶完成支支付操作作后控制制又回到到商戶的的系統(tǒng)(用戶處處于商戶戶WEBB系統(tǒng)生生成的支支付結(jié)果果頁(yè)中)，增加加了銀行行WEBB系統(tǒng)調(diào)調(diào)用商戶戶WEBB系統(tǒng)的的支付結(jié)結(jié)果通知知命令的的過(guò)程。方式33比方式1復(fù)雜，并且商商戶WEEB系統(tǒng)統(tǒng)必須處處理異常常情況。但是方方式3功功能較強(qiáng)強(qiáng)，使支支付過(guò)程程變得平平滑無(wú)縫縫?？紤]到方方式3比比較復(fù)雜雜，并且且需要連連接商戶戶端程序序，我們們提供了了測(cè)試接接口以方方便商戶戶開發(fā)程程序時(shí)測(cè)測(cè)試。使使用該測(cè)測(cè)試接口口模擬真真實(shí)的數(shù)數(shù)據(jù)流程程，但無(wú)無(wú)須真實(shí)實(shí)的商戶戶代碼和和支付卡卡號(hào)，銀銀行系統(tǒng)統(tǒng)也不記記錄交易易數(shù)據(jù)（商戶不不能查詢?cè)兓蚪Y(jié)帳帳使

44、用該該測(cè)試接接口產(chǎn)生生的交易易數(shù)據(jù)）。測(cè)試試接口的的使用方方法和真真實(shí)接口口一致，只需由由真實(shí)接接口的PPrePPayCC2改為為測(cè)試接接口的TTesttPreepayyC2。即由htttpss:/wwww.cmmbchhinaa.coom/nnetppaymmentt/BaaseHHttpp.dlll?PPrePPayCC2? BrrancchIDD=xxxxx&CoNNo=.&BBilllNo=.& Ammounnt=.&DDatee=.&MeerchhanttUrll=.&MeerchhanttParra=.改為htttpss:/wwww.cmmbchhinaa.coom/nnetppa

45、ymmentt/BaaseHHttpp.dlll?TTesttPreePayyC2? BrrancchIDD=xxxxx&CCoNoo=.&BiillNNo=.& Amoountt=.&Daate=.&MerrchaantUUrl=.&MerrchaantPParaa=。注意：為為防止用用戶利用用測(cè)試接接口擾亂亂商戶正正式運(yùn)行行的服務(wù)務(wù)器，銀銀行的測(cè)測(cè)試接口口通知信信息中，BilllNoo始終為為“00000000”。建議：雖然在消消費(fèi)者付付款成功功后向商商戶發(fā)通通知，但但由于IInteerneet線路路問(wèn)題、商戶網(wǎng)網(wǎng)絡(luò)配置置改變問(wèn)問(wèn)題、商商戶服務(wù)務(wù)器問(wèn)題題、商戶戶程序問(wèn)問(wèn)題等原原因，商商戶最

46、終終接收銀銀行通知知的程序序可能收收不到銀銀行通知知，因此此，商戶戶不能僅僅僅憑是是否收到到銀行通通知確定定是否給給消費(fèi)者者提供服服務(wù)，在在商戶作作系統(tǒng)設(shè)設(shè)計(jì)時(shí)也也應(yīng)當(dāng)考考慮到這這個(gè)因素素。商戶戶系統(tǒng)必必須能處處理重復(fù)復(fù)通知的的情況。四人工工定單管管理1操作作員登錄錄為方便商商戶業(yè)務(wù)務(wù)的管理理，商戶戶有必要要?jiǎng)?chuàng)建不不同的的的操作員員并對(duì)其其進(jìn)行權(quán)權(quán)限分配配。操作作員創(chuàng)建建后，就就可以以以定單操操作員的的身份登登錄商戶戶系統(tǒng)，在其權(quán)權(quán)限范圍圍內(nèi)進(jìn)行行查詢、結(jié)賬、部分結(jié)結(jié)賬、撤撤銷、退退款等不不同的操操作，完完成定單單管理工工作。2結(jié)帳帳對(duì)凍結(jié)結(jié)結(jié)賬的商商戶，需需要商戶戶自己手手動(dòng)處理理定單的的結(jié)

47、賬操操作。以以定單操操作員登登錄，先先選擇要要結(jié)賬的的未結(jié)賬賬定單，再進(jìn)行行提交。3部分分結(jié)帳以定單操操作員登登錄，先先選擇要要部分結(jié)結(jié)賬的未未結(jié)賬定定單，輸輸入部分分結(jié)賬金金額，再再進(jìn)行提提交。4撤銷銷以定單操操作員登登錄，先先選擇要要撤銷的的未結(jié)賬賬定單，再進(jìn)行行提交。5自動(dòng)動(dòng)撤消對(duì)凍結(jié)結(jié)結(jié)賬的商商戶，若若定單在在招商銀銀行預(yù)定定的時(shí)間間之內(nèi)沒(méi)沒(méi)有被處處理，系系統(tǒng)將對(duì)對(duì)其自動(dòng)動(dòng)撤銷。6退款款使用前前，商戶戶需要聯(lián)聯(lián)系招商商銀行開開通退款款功能。退款時(shí)需需要驗(yàn)證證操作者者身份，如企業(yè)業(yè)證書卡卡、密碼碼等信息息，退款款時(shí)按照照界面提提示進(jìn)行行操作。五程序序定單管管理1程序序定單管管理簡(jiǎn)介介如果

48、商戶戶每日定定單數(shù)量量不多，完全可可以通過(guò)過(guò)我行提提供的網(wǎng)網(wǎng)上商戶戶系統(tǒng)進(jìn)進(jìn)行查詢?cè)兒徒Y(jié)帳帳處理，則可以以跳過(guò)本本節(jié)。對(duì)于那些些網(wǎng)上支支付交易易較為頻頻繁的商商戶，每每天的交交易筆數(shù)數(shù)很多。如果采采用手工工結(jié)帳、對(duì)帳處處理，工工作量大大，繁瑣瑣而且還還容易出出錯(cuò)。招商銀行行網(wǎng)上支支付系統(tǒng)統(tǒng)提供了了“程序結(jié)結(jié)帳”功能，可以實(shí)實(shí)現(xiàn)商戶戶的查詢?cè)儗?duì)帳、結(jié)帳過(guò)過(guò)程全自自動(dòng)化，可以完完全不需需要人工工參與，還能夠夠?qū)崿F(xiàn)商商戶系統(tǒng)統(tǒng)和銀行行系統(tǒng)數(shù)數(shù)據(jù)整合合。招商銀行行網(wǎng)上支支付系統(tǒng)統(tǒng)的“程序定定單管理理”功能，是通過(guò)過(guò)“網(wǎng)上支支付系統(tǒng)統(tǒng)定單管管理開發(fā)發(fā)包”（簡(jiǎn)稱稱商戶開開發(fā)包）來(lái)實(shí)現(xiàn)現(xiàn)的。通通過(guò)這個(gè)個(gè)開發(fā)

49、包包，商戶戶可以通通過(guò)程序序自動(dòng)完完成以下下工作：查詢未結(jié)結(jié)帳定單單查詢已結(jié)結(jié)帳定單單對(duì)未結(jié)帳帳定單進(jìn)進(jìn)行處理理（結(jié)帳帳、部分分結(jié)帳或或者撤銷銷）此外，交交易管理理開發(fā)包包中也提提供了一一個(gè)“對(duì)銀行行簽名驗(yàn)驗(yàn)證的功功能”。該功功能與程程序定單單管理無(wú)無(wú)關(guān)。后后面有對(duì)對(duì)該功能能專門的的說(shuō)明（參見附附錄）?！罢猩蹄y銀行網(wǎng)上上支付系系統(tǒng)定單單管理開開發(fā)包”有DLLL版本本、控件件版本和和Javva版本本。不同同的版本本功能上上是完全全相同的的。商戶戶可以根根據(jù)自己己的情況況，選擇擇合適的的交易管管理開發(fā)發(fā)包版本本。2商戶戶開發(fā)指指引首先，應(yīng)應(yīng)該根據(jù)據(jù)自己的的情況，選擇一一個(gè)合適適版本的的開發(fā)包包。目

50、前前招商銀銀行網(wǎng)上上支付交交易管理理開發(fā)包包有3個(gè)個(gè)版本：DLLL版本、控件版版本和JJavaa版本。這里給出出開發(fā)包包一般使使用方法法，具體體每個(gè)版版本的使使用方法法，請(qǐng)參參考附錄錄。我們分兩兩種商戶戶：采用用支付方方式1的的商戶，和采用用支付方方式2、3的商商戶。下下面分別別說(shuō)明商商戶通常常使用的的系統(tǒng)結(jié)結(jié)構(gòu)，和和如何使使用開發(fā)發(fā)包實(shí)現(xiàn)現(xiàn)和銀行行系統(tǒng)對(duì)對(duì)接。21采用支支付方式式1的商商戶首先商戶戶有自己己的定單單系統(tǒng)，能夠產(chǎn)產(chǎn)生和記記錄每一一筆網(wǎng)上上支付的的定單信信息。商商戶通常常有一個(gè)個(gè)定期運(yùn)運(yùn)行的自自動(dòng)結(jié)帳帳程序。自動(dòng)結(jié)結(jié)帳程序序定期的的向銀行行查詢所所有的支支付成功功的定單單，然后后

51、根據(jù)查查詢結(jié)果果，更新新商戶自自己的定定單信息息。這類商戶戶的自動(dòng)動(dòng)結(jié)帳程程序，處處理過(guò)程程是這樣樣的：調(diào)用登錄錄接口，登錄調(diào)用“查查詢未結(jié)結(jié)帳定單單”功能，查詢未未結(jié)帳定定單，然然后將這這些定單單和商戶戶自己的的定單系系統(tǒng)中的的數(shù)據(jù)進(jìn)進(jìn)行對(duì)比比。根據(jù)對(duì)比比結(jié)果，更新商商戶自己己定單系系統(tǒng)中，相應(yīng)定定單的狀狀態(tài)，并并分別調(diào)調(diào)用開發(fā)發(fā)包中的的結(jié)帳、部分結(jié)結(jié)帳和撤撤銷功能能，對(duì)這這些定單單進(jìn)行結(jié)結(jié)帳、部部分結(jié)帳帳或者撤撤銷處理理。調(diào)用退出出接口，退出以上步驟驟定時(shí)進(jìn)進(jìn)行（比比如一天天一次，或者半半小時(shí)一一次）22采用支支付方式式2、33的商戶戶對(duì)于支付付支付方方式2和和支付方方式3的的商戶，由于商

52、商戶能夠夠及時(shí)收收到支付付成功的的通知，故商戶戶的定單單系統(tǒng)中中基本都都記錄了了已經(jīng)成成功完成成支付的的定單。這些商戶戶，通常常有兩個(gè)個(gè)相互獨(dú)獨(dú)立的程程序在使使用商戶戶開發(fā)包包：接受受銀行通通知的程程序，和和自動(dòng)對(duì)對(duì)帳/結(jié)結(jié)帳程序序。接受銀行行通知的的程序收到銀行行發(fā)來(lái)的的通知命命令調(diào)用開發(fā)發(fā)包中驗(yàn)驗(yàn)證銀行行數(shù)字簽簽名的AAPI，檢查通通知內(nèi)容容是否可可信更新商戶戶的定單單狀態(tài)，并登記記定單對(duì)對(duì)應(yīng)的銀銀行流水水號(hào)、銀銀行處理理日期等等信息返回給用用戶支付付成功的的信息。注意：接受銀行行通知的的程序應(yīng)應(yīng)該盡快快的返回回結(jié)果頁(yè)頁(yè)面，因因此處理理工作應(yīng)應(yīng)該盡量量少一些些。尤其其不要在在這個(gè)過(guò)過(guò)程中登

53、登錄銀行行系統(tǒng)進(jìn)進(jìn)行結(jié)帳帳操作。如果接接受通知知程序超超過(guò)規(guī)定定時(shí)間還還沒(méi)有返返回結(jié)果果頁(yè)面，則銀行行服務(wù)器器認(rèn)為通通知失敗敗。接受銀行行通知的的程序，必須能能夠處理理收到重重復(fù)通知知的情況況。自動(dòng)結(jié)帳帳程序由于這類類商戶能能收到銀銀行支付付成功的的通知，因此基基本上支支付成功功的定單單在商戶戶的定單單系統(tǒng)中中都有記記錄?？煽梢灾苯咏訉?duì)這些些定單進(jìn)進(jìn)行結(jié)帳帳、部分分結(jié)帳和和撤銷處處理。由于網(wǎng)絡(luò)絡(luò)、服務(wù)務(wù)器等各各方面的的原因，通知并并不總是是能夠到到達(dá)商戶戶。因此此，商戶戶仍然需需要一個(gè)個(gè)自動(dòng)結(jié)結(jié)帳程序序，對(duì)這這部分支支付成功功但沒(méi)有有通知到到的定單單進(jìn)行處處理。先調(diào)用開開發(fā)包中中的登錄錄功能登

54、登錄先根據(jù)商商戶自己己的定單單系統(tǒng)中中記錄的的定單，找出要要結(jié)帳的的定單以以及相應(yīng)應(yīng)的流水水號(hào)（在在銀行通通知參數(shù)數(shù)中有），調(diào)用用開發(fā)包包中的結(jié)結(jié)帳或者者部分結(jié)結(jié)帳接口口，進(jìn)行行結(jié)帳處處理調(diào)用開發(fā)發(fā)包中的的未結(jié)帳帳查詢接接口，對(duì)對(duì)比商戶戶自己的的定單數(shù)數(shù)據(jù)，更更新商戶戶定單系系統(tǒng)的狀狀態(tài)，并并進(jìn)行未未結(jié)帳定定單進(jìn)行行處理（結(jié)帳、部分結(jié)結(jié)帳或者者撤銷）。調(diào)用退出出功能，退出系系統(tǒng)23分頁(yè)方方式查詢?cè)兊氖褂糜梅椒楸苊庖灰淮尾樵冊(cè)兎祷睾芎芏鄶?shù)據(jù)據(jù)，影響響銀行交交易系統(tǒng)統(tǒng)的正常常運(yùn)行，請(qǐng)使用用分頁(yè)查查詢。不同版本本的開發(fā)發(fā)包，分分頁(yè)查詢?cè)兊奶幚砝矸椒ㄊ鞘穷愃频牡?。分?yè)頁(yè)查詢是是通過(guò)22個(gè)輔助助API

55、I配合具具體查詢?cè)兎椒▉?lái)來(lái)實(shí)現(xiàn)查查詢分頁(yè)頁(yè)的。PageeResset：第一次次調(diào)用查查詢方法法之前，先調(diào)用用一次本本方法，表示從從第一頁(yè)頁(yè)開始查查詢。HasNNexttPagge：用用來(lái)檢查查是否還還有數(shù)據(jù)據(jù)。不要同時(shí)時(shí)進(jìn)行不不同的分分頁(yè)查詢?cè)儯ū热缛缫贿呥M(jìn)進(jìn)行分頁(yè)頁(yè)的未結(jié)結(jié)帳查詢?cè)冞^(guò)程中中，又進(jìn)進(jìn)行分頁(yè)頁(yè)的已結(jié)結(jié)帳查詢?cè)儯?，這這樣會(huì)引引起混亂亂。24交易管管理開發(fā)發(fā)包使用用注意事事項(xiàng)和建建議每個(gè)調(diào)用用都有返返回值。商戶必必須檢查查返回值值，判斷斷所執(zhí)行行的功能能是否成成功完成成。使用分頁(yè)頁(yè)方式的的查詢，處理完完一頁(yè)的的定單，再查詢?cè)兿乱豁?yè)頁(yè)查詢不要要過(guò)于頻頻繁，不不要同時(shí)時(shí)多個(gè)登登錄進(jìn)行行查

56、詢。因?yàn)椴椴樵儗?duì)于于交易系系統(tǒng)會(huì)造造成一定定的負(fù)擔(dān)擔(dān)。如果果使用不不當(dāng)（例例如同時(shí)時(shí)發(fā)出多多個(gè)查詢?cè)儾僮?，返回大大量的定定單?shù)據(jù)據(jù)）將影影響交易易系統(tǒng)的的正常運(yùn)運(yùn)行。如如果出現(xiàn)現(xiàn)這種情情況，銀銀行將關(guān)關(guān)閉商戶戶的程序序定單管管理功能能。六舊商商戶系統(tǒng)統(tǒng)用戶須須知為了方方便商戶戶靈活的的管理和和配置業(yè)業(yè)務(wù)，滿滿足商戶戶當(dāng)前的的潛在需需求，招招商銀行行對(duì)原有有的商戶戶系統(tǒng)進(jìn)進(jìn)行了改改造，旨旨在為商商戶提供供一個(gè)更更加靈活活和完善善的電子子商務(wù)支支付平臺(tái)臺(tái)；同時(shí)時(shí)，必須須兼容原原商戶系系統(tǒng)。新的商商戶系統(tǒng)統(tǒng)提供了了基于店店鋪、崗崗位、操操作員的的靈活的的權(quán)限定定義及分分配策略略，提供供了更易易用的定

57、定單管理理功能。新的商商戶系統(tǒng)統(tǒng)主要包包括商戶戶系統(tǒng)管管理、商商戶定單單管理兩兩個(gè)子系系統(tǒng)，文文檔前面面已有所所述。新新的商戶戶系統(tǒng)引引入了“操作員員”的概念念，必須須輸入操操作員號(hào)號(hào)、操作作員密碼碼等信息息才能登登錄系統(tǒng)統(tǒng)進(jìn)行操操作。對(duì)每個(gè)個(gè)商戶都都會(huì)生成成1個(gè)缺缺省的店店鋪（店店鋪號(hào)“00001”，默認(rèn)認(rèn)情況下下，商戶戶生成的的定單屬屬于店鋪鋪“00001”），11個(gè)缺省省的系統(tǒng)統(tǒng)管理員員崗位（崗位號(hào)號(hào)“99999”），11個(gè)缺省省的具備備系統(tǒng)管管理員權(quán)權(quán)限的操操作員（操作員員號(hào)“99999”，操作作員密碼碼對(duì)應(yīng)原原來(lái)的商商戶密碼碼）。商商戶可以以憑以上上信息登登錄進(jìn)入入商戶系系統(tǒng)管理理（

58、在登登錄類型型中選擇擇“系統(tǒng)管管理員登登錄”）進(jìn)行行業(yè)務(wù)及及權(quán)限的的配置，也可以以直接登登錄進(jìn)入入商戶定定單管理理系統(tǒng)。一般情情況下，商戶通通過(guò)系統(tǒng)統(tǒng)管理員員來(lái)管理理店鋪、崗位、操作員員等資料料，通過(guò)過(guò)其他具具備不同同權(quán)限的的操作員員來(lái)管理理定單。原終端端商戶系系統(tǒng)的用用戶也具具備以上上特點(diǎn)，除此之之外，新新的商戶戶系統(tǒng)也也會(huì)生成成操作員員來(lái)對(duì)應(yīng)應(yīng)每個(gè)終終端（操操作員號(hào)號(hào)對(duì)應(yīng)原原來(lái)的終終端號(hào)，操作員員密碼對(duì)對(duì)應(yīng)原來(lái)來(lái)的終端端密碼）。使用新商商戶系統(tǒng)統(tǒng)的商戶戶，在使使用商戶戶開發(fā)包包時(shí)，默默認(rèn)用戶戶為99999（管理員員用戶），所以以登錄密密碼應(yīng)該該用管理理員用戶戶99999的登登錄密碼碼。附錄

59、：開開發(fā)包接接口參考考1. DDLL版版本的開開發(fā)包1. 11. 使使用Liib形式式的商戶戶開發(fā)包包Lib形形式的商商戶開發(fā)發(fā)包實(shí)際際上只是是對(duì)DLLL開發(fā)發(fā)包的一一個(gè)輸出出函數(shù)包包裝，其其真正實(shí)實(shí)現(xiàn)部分分還是在在 DLLL中。Libb開發(fā)包包可以在在C/CC+程程序中按按Libb的方式式直接加加入工程程，方便便C/CC+的的開發(fā)者者。把FirrmClliennt.ddll拷拷貝到系系統(tǒng)目錄錄下或者者結(jié)帳程程序自己己的目錄錄中，在在Winndowws 995/998/NNT/220000中，系系統(tǒng)目錄錄位于sysstemm32.在C/CC+源源文件中中InccluddeFirrmCllien

60、ntAPPI.hh；給C/CC+連連接器指指明FiirmCClieent.libb的位置置；調(diào)用FiirmCClieentAAPI.h 中中函數(shù)；12. 使用用Dlll形式的的商戶開開發(fā)包把FirrmClliennt.ddll拷拷貝到系系統(tǒng)目錄錄下或者者結(jié)帳程程序自己己的目錄錄中，在在Winndowws 995/998/NNT/220000中，系系統(tǒng)目錄錄位于sysstemm32。如果商戶戶開發(fā)語(yǔ)語(yǔ)言是CC或C+：. 申明明一個(gè)HHMODDULEE型變量量；. 調(diào)用用系統(tǒng)函函數(shù):LoaadLiibraary加加載FiirmCClieent.dlll；. 申明明dlll中的函函數(shù)指針針；. 調(diào)用