第三方支付統一接入方案

方案背景及目的

目前大部分商戶平臺均已接入微信，支付寶等第三放支付平臺作為支付渠道，每個商戶平臺開發者都需要自己去接入支付API或SDK，本方案旨在提供一種相對統一的方式，為各商戶平臺接入支付渠道，減少部分重複接入勞動

支付渠道

微信，支付寶，浦發銀行

支付方式

H5頁面支付

方案描述

圖例說明:

支付配置：商戶平臺在統一支付平臺申請配置各自的唯一標識(payid)，預設頁面回跳地址，預設通知地址

客戶：指購買商品，發起交易的使用者，這裡限定使用工具為瀏覽器

商戶：商品提供方；需要接入統一支付的平臺，負責處理支付前及支付後的業務邏輯

統一接入:對微信，支付寶，浦發銀行等支付渠道的呼叫封裝，即本次開發任務

第三方支付：微信，支付寶，浦發銀行等

步驟說明：

1.使用者在商戶平臺發起商品購買

2.商戶預生成訂單資訊，將配置的h5payid,訂單資訊提交至統一接入平臺，如果不使用預設的回跳和通知地址，則在引數中指定，同時可在引數中指定是否只支援某種支付方式

3.統一接入平臺根據輸入的payid，訂單等引數資訊，持久化至資料庫，並構建支付頁面地址返回給商戶

4.商戶將使用者瀏覽器重定向到上述步驟的支付頁面地址

5.客戶在支付頁面上選擇需要的支付方式，發起支付申請

6.呼叫第三方支付

7 微信：需要安裝微信客戶端，微信jsapi呼叫客戶端支付

  支付寶：統一支付向支付寶發起支付申請，支付寶返回token，統一平臺構建授權URL，重定向至使用者瀏覽器（第8步）

  浦發銀行：使用者在支付頁面上選擇浦發支付，直接跳轉至浦發支付頁面

9 使用者輸入賬號授權支付

10 支付完成後，微信，支付寶跳轉至指定的商戶頁面（未指定，則使用預設配置）

11.商戶系統處理回撥頁面對應的業務邏輯

12.商戶系統接受支付渠道的非同步通知做相應處理

需要商戶系統做的事情：

1.申請支付渠道相關賬號，證書等檔案

2.在統一支付平臺申請配置h5payid,配置預設回跳頁面(return_url),及預設通知地址

3.編寫回跳及通知處理邏輯，並提供介面，介面需要實現冪等，同時建議在介面入口處記錄通知日誌，便於問題回溯定位,建議商戶通知處理系統為保持穩定可單獨部署或雙機配置

4.建議實現補償定時程式或其他策略，呼叫統一接入平臺提供的單筆業務查詢介面，用於訂單補償

需要第三方接入做的事情:

1.實現商戶系統接入管理，即管理接入的商戶的後h5payid,預設回跳，通知地址等

2.提供商戶訂單提交介面，用於商戶提交訂單等資訊

3.接入支付渠道

4.提供各支付渠道的單筆業務查詢介面

統一接入平臺相關資料庫及介面設計：

資料庫:

商戶表(一個商戶可申請多個h5payid,但需要由商戶系統作業務區分)

注：商戶系統的銀行相關配置可以配置在屬性檔案中

統一訂單表(該訂單表不承擔為商戶系統長期保留訂單職責，可以定期清理已結束訂單)

統一接入平臺介面：

介面通訊方式可自定義

1.訂單提交介面：

引數:h5payid,h5paysecret,price(價格),goodname(商品名稱),return_url(非必填),notify_url（非必填）,ip(訂單ip),show_url(商品展示頁面地址)

邏輯：儲存至資料庫

返回:支付頁面地址，如http://ip:port/unifiedpay/serialno,商戶系統重定向到該地址

2.支付頁面介面

引數：serialno

邏輯:根據serialno對應的訂單資訊，及相應的支付規則，構造支付頁面返回給瀏覽器

返回：瀏覽器頁面或微信客戶端

3.單筆查詢介面

引數：商戶系統訂單號，支付渠道(wx/alipay/bank,引數可自定義)

邏輯：根據訂單號及支付渠道，以及相應的支付賬號呼叫第三方支付的業務查詢介面，並判斷成功或是失敗

返回：成功則返回成功程式碼，否則返回失敗程式碼及失敗原型 程式碼自定義

可行性待確認：

支付渠道對支付來源頁面可能會進行校驗，需要確認微信，支付寶的支付授權校驗規則

ps:可能需要在微信等支付平臺配置授權域名或目錄為統一支付平臺的地址