騰訊公司財付通支付網(wǎng)關(guān)商戶開發(fā)指南

1、騰訊公司財付通支付網(wǎng)關(guān)商戶開發(fā)指南Version: 2.0Public date: 2007-12-20All copyright reservedT第一章 文檔描述1 文檔說明本操作手冊用來指導(dǎo)財付通用戶實現(xiàn)與電子商務(wù)支付網(wǎng)關(guān)系統(tǒng)的順利對接。請相關(guān)技術(shù)人員詳細閱讀本手冊。文中黑粗的內(nèi)容表示要重點注意的內(nèi)容。2 版本接口程序使用WindowsCOM組件技術(shù)實現(xiàn)，Windows下的PHP、JSP和DotNET開發(fā)平臺均支持COM組件的調(diào)用。請按照具體平臺下的COM組件調(diào)用方法進行調(diào)用。3 閱讀對象商戶開發(fā)人員騰訊科技(深圳)有限公司財付通支付網(wǎng)關(guān)相關(guān)技術(shù)人員4 接口聯(lián)系人職責業(yè)

2、務(wù)支持姓名陳菁菁電話0755-7756EQQ職責技術(shù)支持姓名朱磊電話0755-8285QQ職責技術(shù)支持姓名陳進盛電話0755-8709QQ第二章 業(yè)務(wù)功能描述1 作業(yè)流程簡述1) 商戶根據(jù)客戶的支付行為生成訂單，包括商戶號、訂單號、金額、等支付要素，并提交付款請求。2) 用戶支付成功，財付通將后臺調(diào)用方式將支付結(jié)果實時返回商戶系統(tǒng)。3) 商戶接收到支付成功請求后，輸出反饋信息給財付通，并完成相關(guān)業(yè)務(wù)邏輯。4) 財付通接收到商戶返回的成功信息，再將用戶引導(dǎo)回商戶網(wǎng)站。2 接口通

3、知流程1) 返回結(jié)果在此通知接口模式中，商戶需要確保return_url穩(wěn)定可靠。該return_url完成接收財付通發(fā)送的支付結(jié)果信息，交易結(jié)果信息將以GET方式傳遞至商戶。財付通只將支付成功的訂單進行返回。在傳送給商戶的參數(shù)中，包含使用財付通私鑰(非對稱加密中的述語)對交易結(jié)果數(shù)據(jù)的數(shù)字簽名。商戶應(yīng)該先用財付通的公鑰文件驗證該數(shù)字簽名，確認該通知信息的合法性。然后完成相關(guān)業(yè)務(wù)邏輯。2) 輸出反饋財付通要求商戶系統(tǒng)return_url輸出以下代碼：-window.location.href=http:/back_url;-財付通不允許在return_url中發(fā)生任何跳轉(zhuǎn)，并要求商戶系統(tǒng)第一時

4、間輸出此為財付通系統(tǒng)判斷是否成功返回支付結(jié)果的唯一憑證。3) 用戶返回財付通接收到以上反饋信息后，將引導(dǎo)用戶返回http:/back_url進行瀏覽3 安全控制1 財付通采用加密和數(shù)字簽名認證體系2 通訊使用SSL協(xié)議（128位），對數(shù)據(jù)進行加密3 商戶和財付通間數(shù)據(jù)交互都使用加密，并使用數(shù)字簽名進行數(shù)據(jù)驗證，確保數(shù)據(jù)的完整性和不可抵賴性第三章 系統(tǒng)原理1 支付流程支付功能面對用戶，為商家和客戶提供資金流動的服務(wù)。此處對其中步驟進行詳細描述，請仔細閱讀。1. 用戶在商戶系統(tǒng)挑選所需商品。2. 商戶系統(tǒng)按照財付通支付請求格式生成訂單確認頁面展示給用戶。a) return_url指定支付成功之后，

5、接收財付通支付結(jié)果通知的商戶系統(tǒng)URL3. 用戶確認訂單信息，選擇支付方式，并確認提交給財付通。4. 財付通驗證交易單信息，生成支付引導(dǎo)頁面展示給用戶。5. 用戶填寫付款帳戶信息，并確認提交給財付通或者銀行。6. 財付通執(zhí)行或者接收扣款結(jié)果信息，如果失敗則展示支付失敗信息給用戶（如圖6.1），如果成功則繼續(xù)（如圖6）7. 財付通后臺按照支付應(yīng)答格式通知商戶系統(tǒng)支付成功結(jié)果給return_url8. 財付通接收商戶系統(tǒng)反饋信息，分析報文格式，如果正確則認為同步成功，取商戶反饋的result_url,并展示給用戶（如圖9）；否則使用按照支付應(yīng)答展示給用戶（如圖9.1）9. 支付成功結(jié)束，展示給用戶

6、成功信息。10. 用戶側(cè)支付應(yīng)答前臺調(diào)用。11. 商戶系統(tǒng)反饋的結(jié)果信息給用戶。2 查詢流程查詢功能是財付通提供的輔助功能，用來協(xié)助商戶系統(tǒng)處理網(wǎng)絡(luò)異常引發(fā)的各類掉單問題，商戶系統(tǒng)可以根據(jù)自己的需求來開發(fā)自己的訂單查詢功能。商戶可以在用戶查看自己購買的物品時觸發(fā)查詢，流程如下：1. 用戶查看自己已經(jīng)付款的商品列表2. 商戶系統(tǒng)對未確定的交易單發(fā)起訂單查詢，按照查詢請求組織請求報文3. 財付通將查詢到的交易信息，返照查詢應(yīng)答格式組織回應(yīng)報文，通知商戶系統(tǒng)4. 商戶系統(tǒng)驗證訂單信息，并更新訂單狀態(tài)5. 商戶系統(tǒng)檢索已經(jīng)支付的物品清單，展現(xiàn)給用戶3 結(jié)算流程財付通將按照商談確定的結(jié)算規(guī)則，將交易款項

7、存放到商家設(shè)定的帳號中。此處從略，若有疑問可以聯(lián)系財付通業(yè)務(wù)支持人員。 第四章 支付請求接口協(xié)議1 接入URL/cgi-bin/v1.0/pay_gate.cgi2 接入方式POST/GET方式 3 協(xié)議參數(shù)字段名填寫類型說明cmdno必填業(yè)務(wù)代碼, 財付通支付支付接口填 1 date必填商戶日期：如bank_type必填銀行類型:財付通支付填0desc必填交易的商品名稱purchaser_id可選用戶(買方)的財付通帳戶,可以為空bargainor_id必填商家的商戶號,有騰訊公司唯一分配transaction_id必填交易號(訂單號)，由商戶網(wǎng)站產(chǎn)

8、生(建議順序累加)，一對請求和應(yīng)答的交易號必須相同）。transaction_id 為28位長的數(shù)值，其中前10位為商戶網(wǎng)站編號(SPID)，由財付通統(tǒng)一分配；之后8位為訂單產(chǎn)生的日期，如；最后10位商戶需要保證一天內(nèi)不同的事務(wù)（用戶訂購一次商品或購買一次服務(wù)），其ID不相同。sp_billno必填商戶系統(tǒng)內(nèi)部的定單號，此參數(shù)僅在對賬時提供。 total_fee必填總金額，以分為單位fee_type必填現(xiàn)金支付幣種，目前只支持人民幣，碼編請參見附件中的return_url必填接收財付通返回結(jié)果的URL(推薦使用ip)attach必填商家數(shù)據(jù)包，原樣返回sign必填MD5簽名例如：“cmdno=

9、1&date=& bargainor_id=& transaction_id=& sp_billno=1111&total_fee=1300& fee_type=1&return_url=/tenpay1.aspx& attach=1&key=”注意：以上拼湊值不要有空格！使用標準MD5算法對該字符串進行加密，加密結(jié)果全部轉(zhuǎn)換成大寫后，即為我們所需的訂單MD5 校驗碼，將其寫入sign字段即可。 第五章 支付通知接口協(xié)議1 通知url用戶提供的return_url2 通知方式Get 方式3 協(xié)議參數(shù)MD5支付通知目的URL$ return_url商戶支付請求中

10、填寫的return_url 字段名填寫類型說明cmdno必填任務(wù)代碼 1pay_result必填支付結(jié)果，詳見“返回值編碼定義”, 0成功pay_info可選支付結(jié)果信息，支付成功時為空date必填商戶日期bargainor_id必填賣方賬號（商戶spid）transaction_id必填財付通交易號(訂單號) sp_billno必填商戶系統(tǒng)內(nèi)部的定單號，此參數(shù)僅在對賬時提供。 total_fee必填訂單總金額，以分為單位fee_type必填現(xiàn)金支付幣種attach必填商家數(shù)據(jù)包，原樣返回sign必填MD5簽名例如：cmdno=1&pay_result=0& date=&transaction

11、_id=& sp_billno=k&total_fee=100& fee_type=1&attach=test_attach&key=注意：以上拼湊值不要有空格！使用標準MD5算法對該字符串進行加密，加密結(jié)果全部轉(zhuǎn)換成大寫后，即為我們所需的訂單MD5 校驗碼第六章 查詢接口協(xié)議1 接入url/cgi-bin/cfbi_query_order.cgi2 接入方式該接口接入方式為post3 協(xié)議參數(shù)字段名填寫類型說明cmdno必填業(yè)務(wù)代碼, 財付通支付查詢接口填 2 date必填商戶訂單日期：如bargainor_id必填商家的商戶號,有騰訊公司唯一分配tr

12、ansaction_id必填財付通交易單號(訂單號)。sp_billno必填商戶系統(tǒng)內(nèi)部的定單號，此參數(shù)僅在對賬時提供。 return_url必填接收財付通返回結(jié)果的URL(推薦使用ip)attach必填商家數(shù)據(jù)包，原樣返回sign必填MD5簽名例如：cmdno=2&date=&bargainor_id=& transaction_id=& sp_billno=1111&return_url=/tenpay1.aspx&attach=1& key=注意：以上拼湊值不要有空格！使用標準MD5算法對該字符串進行加密，加密結(jié)果全部轉(zhuǎn)換成大寫后，即為我們所需的訂單MD

13、5 校驗碼 第七章 查詢通知接口協(xié)議1 通知url用戶提供的return_url2 通知方式Get 方式3 協(xié)議參數(shù)MD5查詢通知目的URL$ return_url商戶查詢請求中填寫的URL字段名填寫類型說明cmdno必填任務(wù)代碼 2pay_result必填支付結(jié)果，詳見“返回值編碼定義”, 0成功pay_info可選支付結(jié)果信息，支付成功時為空date必填商戶日期bargainor_id必填賣方賬號（商戶spid）transaction_id必填財付通交易號(訂單號) sp_billno必填商戶系統(tǒng)內(nèi)部的定單號，此參數(shù)僅在對賬時提供。 total_fee必填訂單總金額，以分為單位fee_ty

14、pe必填現(xiàn)金支付幣種attach必填商家數(shù)據(jù)包，原樣返回sign必填MD5簽名例如：“cmdno=2&pay_result=0&date=& transaction_id=& sp_billno=k&total_fee=100&fee_type=1& attach=test_attach&key=”注意：以上拼湊值不要有空格！使用標準MD5算法對該字符串進行加密，加密結(jié)果全部轉(zhuǎn)換成大寫后，即為我們所需的訂單MD5 校驗碼第八章 枚舉類型1 銀行代碼0 財付通1001 招商銀行 1002 中國工商銀行 1003 中國建設(shè)銀行 1004 上海浦東發(fā)展銀行 1005 中國農(nóng)業(yè)銀行 1006 中國民生銀行 1008 深圳發(fā)展銀行 1009 興業(yè)銀行 1028 廣州銀聯(lián)1032 北京銀行2 支付類型 1 快速支付2 B2C支付3 貨幣類型1 RMB 人民幣2 - USD 美元3 - HKD 港幣4 返回值編碼pay_result返回值編碼 ：0 成功5