# 1. 接口規(guī)則

為了在保證支付安全的前提下，帶給商戶簡單、一致且易用的開發(fā)體驗，我們推出了全新的微信支付APIv3接口。該版本API的具體規(guī)則請參考APIv3接口規(guī)則。

# 2. 開發(fā)準(zhǔn)備

# 2.1. 搭建和配置開發(fā)環(huán)境

為了幫助開發(fā)者調(diào)用開放接口，我們提供了JAVA、PHP、GO三種語言版本的開發(fā)庫，封裝了簽名生成、簽名驗證、敏感信息加/解密、媒體文件上傳 等基礎(chǔ)功能（更多語言版本的開發(fā)庫將在近期陸續(xù)提供）。

測試步驟：

1、根據(jù)自身開發(fā)語言，選擇對應(yīng)的開發(fā)庫并構(gòu)建項目，具體配置請參考下面鏈接的詳細(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)建加載商戶私鑰、加載平臺證書、初始化httpClient的通用方法。

3、基于接口的示例代碼，替換請求參數(shù)后可發(fā)起測試。

說明：

• 上面的開發(fā)庫為微信支付官方開發(fā)庫，其它沒有審核或者控制下的第三方工具和庫，微信支付不保證它們的安全性和可靠性。通過包管理工具引入SDK后，可根據(jù)下面每個接口的示例代碼替換相關(guān)參數(shù)后進(jìn)行快速測試。
• 開發(fā)者如果想詳細(xì)了解簽名生成、簽名驗證、敏感信息加/解密、媒體文件上傳等常用方法的具體代碼實現(xiàn)，可閱讀下面的詳細(xì)說明：

1. 簽名生成
2. 簽名驗證
3. 敏感信息加解密
4. merchantPrivateKey（私鑰）
5. wechatpayCertificates（平臺證書）
6. APIV3Key（V3 key）

• 如想更詳細(xì)的了解我們的接口規(guī)則，可查看我們的接口規(guī)則指引文檔。

# 3. 快速接入

# 3.1. 業(yè)務(wù)流程圖

重點步驟說明：

步驟3 用戶入場時，調(diào)用創(chuàng)建停車入場接口創(chuàng)建停車入場信息。商戶根據(jù)返回的車牌狀態(tài)判斷用戶是否開通支付分停車服務(wù)。

步驟7.2 如果用戶未開通支付分服務(wù)，可調(diào)用調(diào)起微信支付分停車服務(wù)開通頁接口為微信支付分開通小程序，引導(dǎo)用戶進(jìn)行服務(wù)開通。

步驟10 場內(nèi)車牌發(fā)送變化后，微信支付通過停車入場狀態(tài)變更通知接口將車主狀態(tài)變化通知給商戶。

步驟13 用戶離場時，需調(diào)用扣費受理接口完成訂單受理，微信支付進(jìn)行異步扣款，支付完成后，會將訂單支付結(jié)果發(fā)送給商戶。

# 4. 開發(fā)注意事項

# 4.1. 扣費受理API注意事項

必須確認(rèn)扣費受理接口的交易狀態(tài)返回“ACCEPTED”才能放行車輛，若未接收到該狀態(tài)而放行車輛離場，造成的資金損失由商戶側(cè)自行承擔(dān)。

# 4.2. 停車入場狀態(tài)變更通知API注意事項

• 同樣的通知可能會多次發(fā)送給商戶系統(tǒng)。商戶系統(tǒng)必須能夠正確處理重復(fù)的通知。 推薦的做法是，當(dāng)商戶系統(tǒng)收到通知進(jìn)行處理時，先檢查對應(yīng)業(yè)務(wù)數(shù)據(jù)的狀態(tài)，并判斷該通知是否已經(jīng)處理。如果未處理，則再進(jìn)行處理；如果已處理，則直接返回結(jié)果成功。在對業(yè)務(wù)數(shù)據(jù)進(jìn)行狀態(tài)檢查和處理之前，要采用數(shù)據(jù)鎖進(jìn)行并發(fā)控制，以避免函數(shù)重入造成的數(shù)據(jù)混亂。
• 如果在所有通知頻率后沒有收到微信側(cè)回調(diào),商戶應(yīng)調(diào)用查詢車牌服務(wù)開通信息確認(rèn)車牌服務(wù)開通狀態(tài)。

特別提醒： 商戶系統(tǒng)對于支付成功通知的內(nèi)容一定要做簽名驗證，并校驗通知的信息是否與商戶側(cè)的信息一致，防止數(shù)據(jù)泄露導(dǎo)致出現(xiàn)“假通知”，造成資金損失。

# 4.3. 訂單支付結(jié)果通知API注意事項

• 同樣的通知可能會多次發(fā)送給商戶系統(tǒng)。商戶系統(tǒng)必須能夠正確處理重復(fù)的通知。 推薦的做法是，當(dāng)商戶系統(tǒng)收到通知進(jìn)行處理時，先檢查對應(yīng)業(yè)務(wù)數(shù)據(jù)的狀態(tài)，并判斷該通知是否已經(jīng)處理。如果未處理，則再進(jìn)行處理；如果已處理，則直接返回結(jié)果成功。在對業(yè)務(wù)數(shù)據(jù)進(jìn)行狀態(tài)檢查和處理之前，要采用數(shù)據(jù)鎖進(jìn)行并發(fā)控制，以避免函數(shù)重入造成的數(shù)據(jù)混亂。
• 如果在所有通知頻率后沒有收到微信側(cè)回調(diào),商戶應(yīng)調(diào)用查詢訂單接口確認(rèn)訂單狀態(tài)。

特別提醒： 商戶系統(tǒng)對于支付成功通知的內(nèi)容一定要做簽名驗證，并校驗通知的信息是否與商戶側(cè)的信息一致，防止數(shù)據(jù)泄露導(dǎo)致出現(xiàn)“假通知”，造成資金損失。

# 4.4. 申請退款A(yù)PI

• 交易時間超過一年的訂單無法提交退款
• 微信支付退款支持單筆交易分多次退款（不超50次），多次退款需要提交原支付訂單的商戶訂單號和設(shè)置不同的退款單號。申請退款總金額不能超過訂單金額。 一筆退款失敗后重新提交，請不要更換退款單號，請使用原商戶退款單號
• 錯誤或無效請求頻率限制：6qps，即每秒鐘異常或錯誤的退款申請請求不超過6次
• 每個支付訂單的部分退款次數(shù)不能超過50次
• 如果同一個用戶有多筆退款，建議分不同批次進(jìn)行退款，避免并發(fā)退款導(dǎo)致退款失敗
• 申請退款接口的返回僅代表業(yè)務(wù)的受理情況，具體退款是否成功，需要通過退款查詢接口獲取結(jié)果
• 一個月之前的訂單申請退款頻率限制為：5000/min
• 同一筆訂單多次退款的請求需相隔1分鐘

# 4.5. 退款結(jié)果通知API

對后臺通知交互時，如果微信收到應(yīng)答不是成功或超時，微信認(rèn)為通知失敗，微信會通過一定的策略定期重新發(fā)起通知，盡可能提高通知的成功率，但微信不保證通知最終能成功

• 同樣的通知可能會多次發(fā)送給商戶系統(tǒng)。商戶系統(tǒng)必須能夠正確處理重復(fù)的通知。 推薦的做法是，當(dāng)商戶系統(tǒng)收到通知進(jìn)行處理時，先檢查對應(yīng)業(yè)務(wù)數(shù)據(jù)的狀態(tài)，并判斷該通知是否已經(jīng)處理。如果未處理，則再進(jìn)行處理；如果已處理，則直接返回結(jié)果成功。在對業(yè)務(wù)數(shù)據(jù)進(jìn)行狀態(tài)檢查和處理之前，要采用數(shù)據(jù)鎖進(jìn)行并發(fā)控制，以避免函數(shù)重入造成的數(shù)據(jù)混亂。
• 如果在所有通知頻率后沒有收到微信側(cè)回調(diào)。商戶應(yīng)調(diào)用查詢訂單接口確認(rèn)訂單狀態(tài)。

特別提醒: 商戶系統(tǒng)對于開啟結(jié)果通知的內(nèi)容一定要做簽名驗證，并校驗通知的信息是否與商戶側(cè)的信息一致，防止數(shù)據(jù)泄露導(dǎo)致出現(xiàn)“假通知”，造成資金損失。