財付通即時到帳支付開發(fā)指南11111

1、騰訊公司財付通支付網關商戶開發(fā)指南Version: 5.0Public date: 2021-11-17All copyright reservedTenpay 文檔描述 文檔說明本操作手冊用來指導財付通用戶實現與電子商務支付網關系統(tǒng)的順利對接。請相關技術人員詳細閱讀本手冊。文中黑粗的內容表示要重點注意的內容。 版本2021-9-17增加字段spbill_create_ip改變文檔結構Magichu2021-3-18升級查詢接口Magichu 閱讀對象商戶開發(fā)人員騰訊科技(深圳)財付通支付網關相關技術人員 接口聯系人職責業(yè)務支持姓名田小姐 86013388-84564Emailorangeti

2、an tencent QQ88881486職責技術支持姓名許先生 86013388-82208Emailxiaoqiangxu tencent QQ88881535 業(yè)務功能描述 作業(yè)流程簡述商戶根據客戶的支付行為生成訂單，包括商戶號、訂單號、金額、等支付要素，并提交付款請求。用戶支付成功，財付通將后臺調用方式將支付結果實時返回商戶系統(tǒng)。商戶接收到支付成功請求后，輸出反應信息給財付通，并完成相關業(yè)務邏輯。財付通接收到商戶返回的成功信息，再將用戶引導回商戶網站show_url。 接口通知流程返回結果在此通知接口模式中，商戶需要確保return_url穩(wěn)定可靠。該return_url完成接收財付通

3、發(fā)送的支付結果信息，交易結果信息將以GET方式傳遞至商戶。財付通只將支付成功的訂單進行返回。在傳送給商戶的參數中，包含使用財付通私鑰(非對稱加密中的述語)對交易結果數據的數字簽名。商戶應該先用財付通的公鑰文件驗證該數字簽名，確認該通知信息的合法性。然后完成相關業(yè)務邏輯。輸出反應財付通要求商戶系統(tǒng)return_url輸出以下代碼：-window.location.href= :/show_url; -財付通不允許在return_url中發(fā)生任何跳轉，并要求商戶系統(tǒng)第一時間輸出此為財付通系統(tǒng)判斷是否成功返回支付結果的唯一憑證。用戶返回財付通接收到以上反應信息后，將引導用戶返回show_url進行瀏

4、覽 平安控制財付通采用加密和數字簽名認證體系通訊使用SSL協議128位，對數據進行加密商戶和財付通間數據交互都使用加密，并使用數字簽名進行數據驗證，確保數據的完整性和不可抵賴性 系統(tǒng)原理 支付流程支付功能面對用戶，為商家和客戶提供資金流動的效勞。此處對其中步驟進行詳細描述，請仔細閱讀。用戶在商戶系統(tǒng)挑選所需商品。商戶系統(tǒng)按照財付通 HYPERLINK l _ 支付請求接口協議 支付請求格式生成訂單確認頁面展示給用戶。用戶確認訂單信息，選擇支付方式，并確認提交給財付通。財付通驗證交易單信息，生成支付引導頁面展示給用戶。用戶填寫付款帳戶信息，并確認提交給財付通或者銀行。財付通執(zhí)行或者接收扣款結果信

5、息，如果失敗那么展示支付失敗信息給用戶如圖6.1，如果成功那么繼續(xù)如圖6財付通后臺按照 HYPERLINK l _ 支付通知接口協議 支付通知格式通知商戶系統(tǒng)支付成功結果給return_urla) return_url指定支付成功之后，接收財付通支付結果通知的商戶系統(tǒng)URL財付通接收商戶系統(tǒng) HYPERLINK l _ 支付通知接口協議 反應信息，分析報文格式，如果正確那么認為同步成功，取商戶反應的result_url,并展示給用戶如圖9；否那么前臺輸出錯誤信息提示同步失敗如圖9.1支付成功結束，展示給用戶成功信息。用戶端 HYPERLINK l _ 支付通知接口協議 支付通知前臺調用，分析錯

6、誤信息。商戶系統(tǒng)反應的結果信息給用戶。 查詢流程查詢功能是財付通提供的輔助功能，用來協助商戶系統(tǒng)處理網絡異常引發(fā)的各類掉單問題，商戶系統(tǒng)可以根據自己的需求來開發(fā)自己的訂單查詢功能。商戶可以在用戶查看自己購置的物品時觸發(fā)查詢，流程如下：用戶查看自己已經付款的商品列表商戶系統(tǒng)對未確定的交易單發(fā)起訂單查詢，按照 HYPERLINK l _ 查詢接口請求協議 查詢請求組織請求報文財付通將查詢到的交易信息，返照 HYPERLINK l _ 查詢接口通知協議 查詢通知格式組織回應報文，通知商戶系統(tǒng)商戶系統(tǒng)驗證訂單信息，并更新訂單狀態(tài)商戶系統(tǒng)檢索已經支付的物品清單，展現給用戶 結算流程財付通將按照商談確定的

7、結算規(guī)那么，將交易款項存放到商家設定的帳號中。此處從略，假設有疑問可以聯系財付通業(yè)務支持人員。 支付請求接口協議 接入URL :/service.tenpay /cgi-bin/v3.0/payservice.cgi 接入方式POST/GET方式 協議參數字段名填寫類型說明cmdno必填業(yè)務代碼, 財付通支付支付接口填 1 date必填商戶日期：如20051212bank_type必填銀行類型:財付通支付填0desc必填交易的商品名稱,32個字符16漢字內,不包含特殊符號purchaser_id必填用戶(買方)的財付通帳戶(QQ或EMAIL),如無法獲取，填空值bargainor_id必填商家

8、的商戶號,有騰訊公司唯一分配transaction_id必填交易號(訂單號)，由商戶網站產生(建議順序累加)，一對請求和應答的交易號必須相同。transaction_id 為28位長的數值，其中前10位為商戶網站編號(SPID)，由財付通統(tǒng)一分配；之后8位為訂單產生的日期，如20050415；最后10位商戶需要保證一天內不同的事務用戶訂購一次商品或購置一次效勞，其ID不相同。此財付通訂單號必須保持唯一，不能重復,財付通根據此定單號通知商戶發(fā)貨和數據更新等。sp_billno必填商戶系統(tǒng)內部的定單號，此參數僅在對賬時提供,28個字符內。 total_fee必填總金額，以分為單位,不允許包含任何字

9、符fee_type必填現金支付幣種，目前只支持人民幣，碼編請參見附件中的return_url必填接收財付通返回結果的URL(推薦使用ip)attach必填商家數據包，原樣返回spbill_create_ip必填用戶IP非商戶效勞器IP，為了防止欺詐，支付時財付通會校驗此IPsign必填MD5簽名結果cs選填字符編碼標準，gbk或者utf-8 簽名規(guī)那么sign=md5(cmdno=1&date=20051219&bargainor_id=1000000301&transaction_id=1000000301200512190000012138&sp_billno=1111&total_fee

10、=1300&fee_type=1&return_url= :/ xxx /tenpay1.aspx&attach=1&spbill_create_ip=219.133.62.73&key=1000000301)對所有請求字段，其值為空的不參加MD5驗證，以上拼湊值不要有空格！使用標準MD5算法對該字符串進行加密，即為我們所需的訂單MD5 校驗碼，將其寫入sign字段即可。 支付通知接口協議 通知url用戶提供的return_url 通知方式Get 方式 協議參數MD5支付通知目的URL$ return_url 商戶支付請求中填寫的return_url字段名填寫類型說明cmdno必填任務代碼 1

11、pay_result必填支付結果，詳見“返回值編碼定義, 0成功pay_info可選支付結果信息，支付成功時為空date必填商戶日期bargainor_id必填賣方賬號商戶spidtransaction_id必填財付通交易號(訂單號) sp_billno必填商戶系統(tǒng)內部的定單號，此參數僅在對賬時提供。 total_fee必填訂單總金額，以分為單位fee_type必填現金支付幣種attach必填商家數據包，原樣返回sign必填MD5簽名結果 簽名規(guī)那么sign=md5(cmdno=1&pay_result=0&date=20051220&transaction_id=10000003012005

12、12200000000004& sp_billno=k0000000001&total_fee=100& fee_type=1&attach=test_attach&key=1000000301)對所有請求字段，其值為空的不參加MD5驗證，以上拼湊值不要有空格！使用標準MD5算法對該字符串進行加密，即為我們所需的訂單MD5 校驗碼，將其寫入sign字段即可。 查詢接口請求協議 接入url :/mch.tenpay /cgi-bin/cfbi_query_order_v3.cgi 接入方式該接口接入方式為post 協議參數字段名填寫類型說明cmdno必填業(yè)務代碼, 財付通支付查詢接口填 2 da

13、te必填商戶訂單日期：如20051212bargainor_id必填商家的商戶號,由騰訊公司唯一分配transaction_id必填財付通交易單號(訂單號)。sp_billno必填商戶系統(tǒng)內部的定單號，此參數僅在對賬時提供。 attach必填商家數據包，原樣返回output_xml必填固定為1charset必填字符集，GB2312或UTF-8sign必填MD5簽名結果 請求簽名規(guī)那么參數以字母順序排序key除外，key放在最后。輸入例如：sign=md5(attach=1&bargainor_id=1000000301&charset=GB2312&cmdno=2&date=20211201&

14、output_xml=1& sp_billno=1111&transaction_id=1000000301200512190000012138&key=1000000301)對所有請求字段，其值為空的不參加MD5驗證，以上拼湊值不要有空格！使用標準MD5算法對該字符串進行加密，即為我們所需的訂單MD5 校驗碼，將其寫入sign字段即可。 查詢接口通知協議 返回方式數據將以xml形式在同一會話中同步返回例如： a 1900000108 GB2312 2 20210315 1 1 未付款 2006 00 交易成功 :/192.168.1.129/bank/cft_return.aspx 0CC2

15、80C5219302E95C1A3D01CB442124 56212087 3000 1900000108202103150056212087 返回參數MD5查詢通知字段名填寫類型說明cmdno必填任務代碼 2pay_result必填支付結果，詳見“返回值編碼定義, 0成功pay_info可選支付結果信息，支付成功時為空date必填商戶日期bargainor_id必填賣方賬號商戶spidtransaction_id必填財付通交易號(訂單號) sp_billno必填商戶系統(tǒng)內部的定單號，此參數僅在對賬時提供。 total_fee必填訂單總金額，以分為單位fee_type必填現金支付幣種attac

16、h必填商家數據包，原樣返回sign必填MD5簽名結果 返回簽名規(guī)那么參數以字母順序排序key除外，key放在最后。sign=md5(attach=1&bargainor_id=1000000301&cmdno=2&date=20211201&fee_type=1&pay_info=OK&pay_result=0&sp_billno=7654321&total_fee=3000&transaction_id=1000000301200512190000012138&key=1000000301)對所有請求字段，其值為空的不參加MD5驗證，以上拼湊值不要有空格！使用標準MD5算法對該字符串進行加密

17、，即為我們所需的訂單MD5 校驗碼，將其寫入sign字段即可。 網銀直聯實現方法 定義財付通網銀直聯是財付通為商戶提供的免費增值效勞。財付通網銀直聯是指用戶可以在商戶網站選擇銀行，進行支付，直接進入銀行支付頁面，不再轉入財付通支付頁面。財付通網銀直聯可以有效提升支付成功率，優(yōu)化用戶支付體驗，降低用戶支付心理門檻。 效果重要提示：開通直聯銀行后，在財付通支付界面效果上請與以下列圖示保持一致。如果在不經財付通同意的情況下修改直聯銀行展現樣式，財付通將保存收回此功能的權利。 實現方法財付通網銀直聯對所有用戶默認開通，不需要另行申請，所使用的商戶號和密鑰，也不需要另行申請。在財付通支付接口中，有指定支

18、付銀行的參數bank_type，將用戶選擇的銀行，按照財付通銀行編碼表賦值給bank_type，在提交到財付通時，就自動跳轉到用戶所選擇的網上銀行。財付通銀行編碼表見 HYPERLINK l _銀行代碼 第九章第一節(jié)?銀行代碼?，銀行LOGO圖片在demo開發(fā)包的images文件夾中商戶可根據需要自行取用。例如：bank_type=1038將會直聯招商銀行。 幫助中心如果您在財付通的申請，使用過程出現相關的問題可登陸 HYPERLINK :/help.tenpay /mch/ 財付通企業(yè)幫助中心查看相關的常見問題及其解答如果您在財付通的集成開發(fā)過程中遇到相關的問題，可登陸 HYPERLINK :/support.qq /discuss/565_1.shtml 騰訊財付通產品交流查看相關的問題及其解答，里