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

騰訊公司財付通支付網(wǎng)關(guān)商戶開發(fā)指南 2007ll 第一章 文檔 描述 1 文檔說明 本操作手冊用來指導(dǎo) 財付通用戶 實現(xiàn)與電子商務(wù)支付網(wǎng)關(guān)系統(tǒng)的順利 對接 。請相關(guān)技術(shù)人員詳細(xì)閱讀本手冊。 文中 黑粗 的內(nèi)容表示要重點注意的內(nèi)容。 2 版本 接口程序使用 件技術(shù)實現(xiàn)， 的 發(fā)平臺均支持 件 的調(diào)用。 請 按照具體平臺下的 件調(diào)用方法進(jìn)行調(diào)用。 3 閱讀對象 商戶開發(fā)人員 騰訊科技 (深圳 )有限公司 財付通支付網(wǎng)關(guān)相關(guān)技術(shù)人員 4接口聯(lián)系人 職責(zé) 業(yè)務(wù)支持 姓名 陳菁菁 電話 0755Q 88881507 職責(zé) 技術(shù)支持 姓名 朱磊 電話 0755Q 88881491 職責(zé) 技術(shù)支持 姓名 陳進(jìn)盛 電話 0755Q 88881481 第二章 業(yè)務(wù)功能描述 1 作業(yè) 流程簡述 1) 商戶根據(jù)客戶的支付行為生成訂單，包括商戶號、訂單號、金額、等 支付要素，并提交付款請求 。 2) 用戶支付成功，財付通將 后臺調(diào)用方式 將支付結(jié)果實時返回商戶系統(tǒng)。 3) 商戶接收到支付成功請求后， 輸出反饋信息 給 財付通 ，并 完成相關(guān)業(yè)務(wù)邏輯 。 4) 財付通 接收到商戶返回的成功信息，再將 用戶引導(dǎo)回商戶網(wǎng)站 。 2 接口通知 流程 1) 返回結(jié)果 在此通知接口模式中，商戶需要 確保 定可靠 。該 成接收財付通 發(fā)送的 支付結(jié)果信息，交易結(jié)果信息 將以 式傳遞至商戶。財付通只將支付成功的訂單進(jìn)行返回。 在傳送給商戶的參數(shù)中，包含使用財付通私鑰 (非對稱加密中的述語 )對交易結(jié)果數(shù)據(jù)的數(shù)字簽名。商戶應(yīng)該先用財付通的公鑰文件驗證該數(shù)字簽名，確認(rèn)該通知信息的合法性。 然后完成相關(guān)業(yè)務(wù)邏輯。 2) 輸出反饋 財付通要求商戶系統(tǒng) 出以下代碼： ; 付通不允許在 發(fā)生任何跳轉(zhuǎn)，并要求商戶系統(tǒng)第一時間輸出 此為 財付通系統(tǒng)判斷是否 成功返回支付結(jié)果的唯一憑證 。 3) 用戶返回 財付通接收到以上反饋信息后，將引導(dǎo)用戶返回 財付通 采用加密和數(shù)字簽名認(rèn)證體系 2 通訊使用 議（ 128 位），對數(shù)據(jù)進(jìn)行加密 3 商 戶和財付通間數(shù)據(jù)交互都使用加密，并使用數(shù)字簽名進(jìn)行數(shù)據(jù)驗證，確保數(shù)據(jù)的完整性和不可抵賴性 第三章 系統(tǒng)原理 1 支付流程 支付功能面對用戶，為商家和客戶提供資金流動的服務(wù)。此處對其中步驟進(jìn)行詳細(xì)描述，請仔細(xì)閱讀。 財 付 通 用 戶 在 線 支 付 流 程財 付 通 在 線 支 付 平 臺（ W E B 服 務(wù) 等 ）財 付 通 在 線 支 付 平 臺（ W E B 服 務(wù) 等 ）商 家 營 銷 系 統(tǒng)（ W E B 服 務(wù) ）商 家 營 銷 系 統(tǒng)（ W E B 服 務(wù) ）用 戶（ 瀏 覽 器 ）用 戶（ 瀏 覽 器 ）登 陸 商 戶 網(wǎng) 站 ， 選 購 物 品生 成 支 付 請 求 表 單用 戶 確 認(rèn) 訂 單 信 息 ， 選 擇 支 付驗 證 訂 單 有 效 性 ， 生 成 支 付 引 導(dǎo) 頁 面用 戶 選 擇 支 付 方 式 ， 填 寫 付 款帳 號 和 帳 號 密 碼 ， 發(fā) 起 支 付驗 證 付 款 帳 號 信 息 ， 扣 款 并 轉(zhuǎn) 入 商 戶在 財 付 通 的 內(nèi) 部 帳 戶后 臺 通 知 商 戶 支 付 結(jié) 果驗 證 支 付 結(jié) 果 ， 記 錄 ， 并返 回 結(jié) 果 通 知 頁 面驗 證 通 知 結(jié) 果 ， 取 結(jié) 果 顯示 U R 成 功78結(jié) 果 顯 示 U R L 頁 面交 易 結(jié) 束9 ： 成 功支 付 失 敗 頁 面 6 。 1 ： 失 敗前 臺 通 知 商 戶 支 付 結(jié) 果9 。 1 ： 失 敗1 0結(jié) 果 通 知 頁 面1 11. 用戶在商戶系統(tǒng)挑選所需商品。 2. 商戶系統(tǒng)按照財付通 支付請求 格式生成訂單確認(rèn)頁面展示給用戶。 a) 定支付成功之后，接收財付通支付結(jié)果通知的商戶系統(tǒng) . 用戶確認(rèn)訂單信息，選 擇支付方式，并確認(rèn)提交給財付通。 4. 財付通驗證交易單信息，生成支付引導(dǎo)頁面展示給用戶。 5. 用戶填寫付款帳戶信息，并確認(rèn)提交給財付通或者銀行。 6. 財付通執(zhí)行或者接收扣款結(jié)果信息，如果失敗則展示支付失敗信息給用戶（如圖 如果成功則繼續(xù)（如圖 6） 7. 財付通后臺按照 支付應(yīng)答 格式通知商戶系統(tǒng)支付成功結(jié)果給 . 財付通接收商戶系統(tǒng) 反饋信息 ，分析報文格式，如果正確則認(rèn)為同步成功，取商戶反饋的 展示給用戶（如圖 9）；否則使用按照 支付應(yīng)答 展示給用戶（如圖 9. 支付成功結(jié)束，展示給用戶成功信息。 10. 用戶側(cè) 支付應(yīng)答 前臺調(diào)用。 11. 商戶系統(tǒng)反饋的結(jié)果信息給用戶。 2查詢流程 查詢功能是財付通提供的輔助功能，用來協(xié)助商戶系統(tǒng)處理網(wǎng)絡(luò)異常引發(fā)的各類掉單問題，商戶系統(tǒng)可以根據(jù)自己的需求來開發(fā)自己的訂單查詢功能。商戶可以在用戶查看自己購買的物品時觸發(fā)查詢，流程如下： 財 付 通 商 戶 訂 單 查 詢 流 程財 付 通 支 付 平 臺財 付 通 支 付 平 臺商 戶 系 統(tǒng)商 戶 系 統(tǒng)用 戶用 戶登 陸 商 戶 系 統(tǒng) ， 查看 已 經(jīng) 購 買 的 物 品檢 索 此 用 戶 為 確 定支 付 狀 態(tài) 的 訂 單 ，發(fā) 起 查 詢查 詢 支 付 狀 態(tài) ， 返回 結(jié) 果驗 證 結(jié) 果 信 息 ， 更新 訂 單 狀 態(tài)檢 索 此 用 戶 已 經(jīng) 支付 的 訂 單 信 息 ， 生成 成 功 購 買 物 品 列表 頁 面物 品 列 表 顯 示123451. 用戶查看自己已經(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ī)則，將交易款項存放到商家設(shè)定的帳號中。此處從略，若有疑問可以聯(lián)系財付通業(yè)務(wù)支持人員。 第四章 支付請求 接口協(xié)議 1 接入 , 財付通支付支付接口填 1 填 商戶日期 ：如 20051212 填 銀行類型 :財付通支付填 0 填 交易的 商品名稱 選 用戶 (買方 )的財付通帳戶 ,可以為空 填 商家的商戶號 ,有騰訊公司唯一分配 填 交易號 (訂單號 )，由商戶網(wǎng)站產(chǎn)生 (建議順序累加 )，一對請求和應(yīng)答的交易號必須相同）。 28 位長的數(shù)值，其中前 10 位為 商戶 網(wǎng)站編號(由財付通統(tǒng)一分配；之后 8 位為訂單產(chǎn)生的日期，如 20050415；最后10 位 商戶 需要保證一天內(nèi)不同的事務(wù)（用戶訂購 一次商品 或 購買 一次服務(wù)），其相同。 填 商戶系統(tǒng)內(nèi)部的定單號，此參數(shù)僅在對賬時提供。 填 總金額，以分為單位 填 現(xiàn)金支付幣種，目前只支持人民幣，碼編請參見附件中的 填 接收財付通返回結(jié)果的 薦使用 填 商家數(shù)據(jù)包，原樣返回 填 例 如 ： “ &0051219& 000000301& 000000301200512190000012138& 111&300& &” 注意：以上拼湊值不要有空格！ 使用標(biāo)準(zhǔn) 密結(jié)果全部轉(zhuǎn)換成大寫后，即為我們所需的訂單 驗碼，將其寫入 第五章 支付 通知接口協(xié)議 1 通知 戶提供的 通知方式 式 3 協(xié)議參數(shù) 付 通知 目的 字段名 填寫類型 說明 填 任務(wù)代碼 1 填 支付結(jié)果，詳見“返回值編碼定義” , 0成功 選 支付結(jié)果信息，支付成功時為空 填 商戶日期 填 賣方賬號 （商戶 填 財付通交易號 (訂單號 ) 填 商戶系統(tǒng)內(nèi)部的定單號，此參數(shù)僅在對賬時提供。 填 訂單 總金額，以分為單位 填 現(xiàn)金支付幣種 填 商家數(shù)據(jù) 包，原樣返回 填 例如： & 0051220&000000301200512200000000004& 00& &000000301 注意：以上拼湊值不要有空格！ 使用標(biāo)準(zhǔn) 密結(jié)果全部轉(zhuǎn)換成大寫后，即為我們所需 的訂單 驗碼 第六章 查詢接口協(xié)議 1 接入 , 財付通支付 查詢 接口填 2 填 商戶 訂單 日期 ：如 20051212 填 商家的商戶號 ,有騰訊公司唯一分配 填 財付通 交易 單 號 (訂單號 )。 填 商戶系統(tǒng)內(nèi)部的定單號， 此參數(shù)僅在對賬時提供。 填 接收財付通返回結(jié)果的 薦使用 填 商家數(shù)據(jù)包，原樣返回 填 例如： &0051219&000000301& 000000301200512190000012138& 111&：以上拼湊值不要有空格！ 使用標(biāo)準(zhǔn) 密結(jié)果全部轉(zhuǎn)換成大寫后，即為我們所需 的訂單 驗碼 第七章 查詢通知接口協(xié)議 1 通知 戶提供的 通知方式 式 3 協(xié)議參數(shù) 詢通知 目的 段名 填寫類型 說明 填 任務(wù)代碼 2 填 支付結(jié)果，詳見“返回值編碼定義” , 0成功 選 支付結(jié)果信息，支付成功時為 空 填 商戶日期 填 賣方賬號 （商戶 填 財付通交易號 (訂單號 ) 填 商戶系統(tǒng)內(nèi)部的定單號，此參數(shù)僅在對賬時提供。 填 訂單 總金額，以分為單位 填 現(xiàn)金支付幣種 填 商家數(shù)據(jù)包，原樣返回 填 例如： “&0051220& 000000301200512200000000004& 00& 000000301” 注意：以上拼湊值不要有空格！ 使用標(biāo)準(zhǔn) 密結(jié)果全部轉(zhuǎn)換成大寫后，即為我們所需 的訂單 驗碼 第八章 枚舉類型 1 銀行代碼 0 財付通 1001 招商銀行 1002 中國工商銀行 1003 中國建設(shè)銀行 1004 上海 浦東發(fā)展銀行 1005 中國農(nóng)業(yè)銀行 1006 中國民生銀行 1008 深圳發(fā)展銀行 1009 興業(yè)銀行 1028 廣州銀聯(lián) 1032 北京銀行 2 支付類型 1 快速支付 2 付 3 貨幣類型 1 人民幣 2 - 美元 3 - 港幣 4 返回值編碼 回值編碼 ： 0 成功 5 自動補單機制 財付通支持自動補單，