# 1. 接口規(guī)則
為了在保證支付安全的前提下,帶給商戶簡(jiǎn)單、一致且易用的開發(fā)體驗(yàn),我們推出了全新的微信支付APIv3接口。該版本API的具體規(guī)則請(qǐng)參考APIv3接口規(guī)則。
# 2. 開發(fā)準(zhǔn)備
# 2.1. 搭建和配置開發(fā)環(huán)境
為了幫助開發(fā)者調(diào)用開放接口,我們提供了JAVA、PHP、GO三種語(yǔ)言版本的開發(fā)庫(kù),封裝了簽名生成、簽名驗(yàn)證、敏感信息加/解密、媒體文件上傳 等基礎(chǔ)功能(更多語(yǔ)言版本的開發(fā)庫(kù)將在近期陸續(xù)提供)。
測(cè)試步驟:
1、根據(jù)自身開發(fā)語(yǔ)言,選擇對(duì)應(yīng)的開發(fā)庫(kù)并構(gòu)建項(xiàng)目,具體配置請(qǐng)參考下面鏈接的詳細(xì)說明:
- wechatpay-java (opens new window)(推薦)、wechatpay-apache-httpclient (opens new window),適用于Java開發(fā)者。
- 注:當(dāng)前開發(fā)指引接口JAVA示例代碼采用wechatpay-apache-httpclient版本。
- wechatpay-php (opens new window)(推薦)、wechatpay-guzzle-middleware (opens new window),適用于PHP開發(fā)者。
- 注:當(dāng)前開發(fā)指引接口PHP示例代碼采用wechatpay-guzzle-middleware版本。
- wechatpay-go (opens new window),適用于Go開發(fā)者。
更多資源可前往微信支付開發(fā)者社區(qū) (opens new window)搜索查看。
2、創(chuàng)建加載商戶私鑰、加載平臺(tái)證書、初始化httpClient的通用方法。
3、基于接口的示例代碼,替換請(qǐng)求參數(shù)后可發(fā)起測(cè)試。
說明:
- 上面的開發(fā)庫(kù)為微信支付官方開發(fā)庫(kù),其它沒有審核或者控制下的第三方工具和庫(kù),微信支付不保證它們的安全性和可靠性。通過包管理工具引入SDK后,可根據(jù)下面每個(gè)接口的示例代碼替換相關(guān)參數(shù)后進(jìn)行快速測(cè)試。
- 開發(fā)者如果想詳細(xì)了解簽名生成、簽名驗(yàn)證、敏感信息加/解密、媒體文件上傳等常用方法的具體代碼實(shí)現(xiàn),可閱讀下面的詳細(xì)說明:
- 如想更詳細(xì)的了解我們的接口規(guī)則,可查看我們的接口規(guī)則指引文檔。
# 2.2. 業(yè)務(wù)開發(fā)配置-二級(jí)商戶進(jìn)件
- 平臺(tái)需確認(rèn)是否已開通平臺(tái)工具箱,詳細(xì)可前往平臺(tái)收付通介紹 (opens new window)查看。
- 待進(jìn)件的二級(jí)商戶是否符合進(jìn)件要求,相關(guān)要求可以前往二級(jí)商戶入駐介紹查看。
# 3. 快速接入
# 3.1. 業(yè)務(wù)流程圖-二級(jí)商戶進(jìn)件
重要步驟說明:
步驟1 平臺(tái)通過請(qǐng)求二級(jí)商戶進(jìn)件接口幫助二級(jí)商戶提交商戶進(jìn)件資料。進(jìn)件參數(shù)中包含了敏感信息參數(shù),此類參數(shù)要求進(jìn)行加密,詳見 接口規(guī)則。
步驟2 提交進(jìn)件資料后,平臺(tái)需通過微信支付返回的微信支付申請(qǐng)單號(hào)和業(yè)務(wù)申請(qǐng)編號(hào)來請(qǐng)求查詢申請(qǐng)狀態(tài)API接口查詢二級(jí)商戶進(jìn)件狀態(tài)。
步驟3 進(jìn)件成功后,若二級(jí)商戶需修改結(jié)算賬號(hào)時(shí),平臺(tái)可通過請(qǐng)求修改商戶結(jié)算賬號(hào)API接口來幫助二級(jí)商戶修改賬號(hào)信息。
步驟4 平臺(tái)通過請(qǐng)求查詢商戶結(jié)算賬號(hào)API接口來查詢修改情況。
# 3.2. API接入-二級(jí)商戶進(jìn)件
本文檔展示了如何使用微信支付服務(wù)端 SDK 快速接入平臺(tái)收付通產(chǎn)品,完成與微信支付對(duì)接的部分。
注意
- 文檔中的代碼示例是用來闡述 API 基本使用方法,代碼中的示例參數(shù)需替換成商戶自己賬號(hào)及請(qǐng)求參數(shù)才能跑通。
- 以下接入步驟僅提供參考,請(qǐng)商戶結(jié)合自身業(yè)務(wù)需求進(jìn)行評(píng)估、修改。
# 3.2.1.【服務(wù)端】二級(jí)商戶進(jìn)件申請(qǐng)
步驟說明: 平臺(tái),可使用該接口,幫助其二級(jí)商戶進(jìn)件成為微信支付商戶。
更多參數(shù)、響應(yīng)詳情及錯(cuò)誤碼請(qǐng)參見二級(jí)商戶進(jìn)件申請(qǐng)API接口文檔。
# 3.2.2.【服務(wù)端】查詢進(jìn)件申請(qǐng)狀態(tài)
步驟說明: 平臺(tái),可使用該接口,幫助其二級(jí)商戶查詢進(jìn)件狀態(tài)。
更多參數(shù)、響應(yīng)詳情及錯(cuò)誤碼請(qǐng)參見查詢進(jìn)件申請(qǐng)狀態(tài)API接口文檔。
# 3.2.3.【服務(wù)端】修改結(jié)算賬號(hào)
步驟說明: 二級(jí)商戶結(jié)算賬號(hào)錯(cuò)誤或者變更,平臺(tái)可通過該接口進(jìn)行修改。
更多參數(shù)、響應(yīng)詳情及錯(cuò)誤碼請(qǐng)參見修改結(jié)算賬號(hào)API接口文檔。
# 3.2.4.【服務(wù)端】查詢結(jié)算賬號(hào)
步驟說明: 平臺(tái)可使用該接口,幫助其二級(jí)商戶查詢結(jié)算賬號(hào)。
更多參數(shù)、響應(yīng)詳情及錯(cuò)誤碼請(qǐng)參見查詢結(jié)算賬號(hào)API接口文檔。