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

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

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

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

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

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

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

7、算規(guī)則，將交易款項(xiàng)存放到商家設(shè)定的帳號(hào)中。此處從略，若有疑問可以聯(lián)系財(cái)付通業(yè)務(wù)支持人員。 第四章 支付請(qǐng)求接口協(xié)議1 接入url2 接入方式post/get方式 3 協(xié)議參數(shù)字段名填寫類型說明cmdno必填業(yè)務(wù)代碼, 財(cái)付通支付支付接口填 1 date必填商戶日期：如20051212bank_type必填銀行類型:財(cái)付通支付填0desc必填交易的商品名稱purchaser_id可選用戶(買方)的財(cái)付通帳戶,可以為空bargainor_id必填商家的商戶號(hào),有騰訊公司唯一分配transaction_id必填交易號(hào)(訂單號(hào))，由商戶網(wǎng)站產(chǎn)生(建議順序累加)，一對(duì)請(qǐng)求和應(yīng)答的交易號(hào)必須相同）。tra

8、nsaction_id 為28位長的數(shù)值，其中前10位為商戶網(wǎng)站編號(hào)(spid)，由財(cái)付通統(tǒng)一分配；之后8位為訂單產(chǎn)生的日期，如20050415；最后10位商戶需要保證一天內(nèi)不同的事務(wù)（用戶訂購一次商品或購買一次服務(wù)），其id不相同。sp_billno必填商戶系統(tǒng)內(nèi)部的定單號(hào)，此參數(shù)僅在對(duì)賬時(shí)提供。 total_fee必填總金額，以分為單位fee_type必填現(xiàn)金支付幣種，目前只支持人民幣，碼編請(qǐng)參見附件中的return_url必填接收財(cái)付通返回結(jié)果的url(推薦使用ip)attach必填商家數(shù)據(jù)包，原樣返回sign必填md5簽名例如：“cmdno=1&date=20051219& barga

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

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

11、transaction_id=1000000301200512200000000004& sp_billno=k0000000001&total_fee=100& fee_type=1&attach=test_attach&key=1000000301注意：以上拼湊值不要有空格！使用標(biāo)準(zhǔn)md5算法對(duì)該字符串進(jìn)行加密，加密結(jié)果全部轉(zhuǎn)換成大寫后，即為我們所需的訂單md5 校驗(yàn)碼第六章 查詢接口協(xié)議1 接入url2 接入方式該接口接入方式為post3 協(xié)議參數(shù)字段名填寫類型說明cmdno必填業(yè)務(wù)代碼, 財(cái)付通支付查詢接口填 2 date必填商戶訂單日期：如20051212bargainor_id必填

12、商家的商戶號(hào),有騰訊公司唯一分配transaction_id必填財(cái)付通交易單號(hào)(訂單號(hào))。sp_billno必填商戶系統(tǒng)內(nèi)部的定單號(hào)，此參數(shù)僅在對(duì)賬時(shí)提供。 return_url必填接收財(cái)付通返回結(jié)果的url(推薦使用ip)attach必填商家數(shù)據(jù)包，原樣返回sign必填md5簽名例如：cmdno=2&date=20051219&bargainor_id=1000000301& transaction_id=1000000301200512190000012138& sp_billno=1111&return_url= key=1000000301注意：以上拼湊值不要有空格！使用標(biāo)準(zhǔn)md5算法

13、對(duì)該字符串進(jìn)行加密，加密結(jié)果全部轉(zhuǎn)換成大寫后，即為我們所需的訂單md5 校驗(yàn)碼 第七章 查詢通知接口協(xié)議1 通知url用戶提供的return_url2 通知方式get 方式3 協(xié)議參數(shù)md5查詢通知目的url$ return_url商戶查詢請(qǐng)求中填寫的url字段名填寫類型說明cmdno必填任務(wù)代碼 2pay_result必填支付結(jié)果，詳見“返回值編碼定義”, 0成功pay_info可選支付結(jié)果信息，支付成功時(shí)為空date必填商戶日期bargainor_id必填賣方賬號(hào)（商戶spid）transaction_id必填財(cái)付通交易號(hào)(訂單號(hào)) sp_billno必填商戶系統(tǒng)內(nèi)部的定單號(hào)，此參數(shù)僅在對(duì)

14、賬時(shí)提供。 total_fee必填訂單總金額，以分為單位fee_type必填現(xiàn)金支付幣種attach必填商家數(shù)據(jù)包，原樣返回sign必填md5簽名例如：“cmdno=2&pay_result=0&date=20051220& transaction_id=1000000301200512200000000004& sp_billno=k0000000001&total_fee=100&fee_type=1& attach=test_attach&key=1000000301”注意：以上拼湊值不要有空格！使用標(biāo)準(zhǔn)md5算法對(duì)該字符串進(jìn)行加密，加密結(jié)果全部轉(zhuǎn)換成大寫后，即為我們所需的訂單md5 校驗(yàn)碼第八章 枚舉類型1 銀行代碼0 財(cái)付通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