# 1. 接口規(guī)則
商家轉(zhuǎn)賬到零錢(qián)，使用了全新的微信支付 APIv3接口規(guī)則 。
# 2. 開(kāi)發(fā)環(huán)境搭建
開(kāi)發(fā)前需要正確配置 私鑰和證書(shū) 、APIv3密鑰 。
# 2.1. 集成SDK
為了幫助開(kāi)發(fā)者更好的調(diào)用接口，我們提供 微信支付APIv3官方SDK ，請(qǐng)根據(jù)自身開(kāi)發(fā)語(yǔ)言，選擇對(duì)應(yīng)的SDK庫(kù)集成到項(xiàng)目，并在商戶平臺(tái)配置平臺(tái)證書(shū)
目前微信支付提供JAVA、PHP、GO三種語(yǔ)言版本的SDK，封裝了簽名生成、簽名驗(yàn)證、敏感信息加/解密、媒體文件上傳等基礎(chǔ)接口功能。
各編程語(yǔ)言的SDK對(duì)“商家轉(zhuǎn)賬到零錢(qián)”的業(yè)務(wù)接口支持不一樣，如若未支持相關(guān)業(yè)務(wù)接口，你可以使用SDK中的HTTP類實(shí)現(xiàn)發(fā)送HTTP請(qǐng)求，它會(huì)自動(dòng)生成簽名和驗(yàn)證簽名。
| SDK | 說(shuō)明 |
|---|---|
| wechatpay-java (opens new window) | Java 服務(wù)端 SDK |
| wechatpay-php (opens new window) | PHP 服務(wù)端 SDK |
| wechatpay-go (opens new window) | GO 服務(wù)端 SDK |
如下通用基礎(chǔ)功能接口，已經(jīng)在SDK中完成封裝，可替換相關(guān)參數(shù)后快速測(cè)試。
- 簽名生成
- 簽名驗(yàn)證
- 敏感信息加解密
- merchantPrivateKey（私鑰）
- wechatpayCertificates（平臺(tái)證書(shū)）
- APIV3Key（V3 key）
若使用的編程語(yǔ)言無(wú)對(duì)應(yīng)的SDK，則需要按照接口規(guī)則與接口詳細(xì)信息自行開(kāi)發(fā)。
# 2.2. 接口體驗(yàn)
如果開(kāi)發(fā)者使用過(guò)PostmanAPI的調(diào)試，建議在正式開(kāi)發(fā)之前，使用 Postman簽名腳本 (opens new window) 進(jìn)行接口體驗(yàn)。
# 3. 商家轉(zhuǎn)賬業(yè)務(wù)接入說(shuō)明
# 3.1. 業(yè)務(wù)流程圖
# 3.2. 關(guān)鍵步驟說(shuō)明
# 第一步：發(fā)起商家轉(zhuǎn)賬到零錢(qián)
1、調(diào)用接口前，開(kāi)發(fā)者需要參考 接入前準(zhǔn)備 確認(rèn)已完成權(quán)限開(kāi)通和產(chǎn)品配置，特別是關(guān)于API發(fā)起轉(zhuǎn)賬的相關(guān)配置一定要正確。
2、商戶發(fā)起商家轉(zhuǎn)賬到零錢(qián)，先調(diào)用《發(fā)起批量轉(zhuǎn)賬》接口發(fā)起批次轉(zhuǎn)賬請(qǐng)求，受理成功將返回批次單號(hào)，此時(shí)并不代表轉(zhuǎn)賬成功。
3、當(dāng)返回錯(cuò)誤碼為“SYSTEM_ERROR”時(shí)，請(qǐng)不要更換商家批次單號(hào)，一定要使用原商家批次單號(hào)及原參數(shù)重試，否則可能造成重復(fù)轉(zhuǎn)賬等資金風(fēng)險(xiǎn)。
4、受理成功后，在單據(jù)創(chuàng)建時(shí)間的3個(gè)自然日內(nèi)使用同樣批次單信息請(qǐng)求該接口，均返回應(yīng)答碼“200 OK”及對(duì)應(yīng)的應(yīng)答參數(shù)。
# 第二步：查詢轉(zhuǎn)賬批次狀態(tài)
1、使用API接口只支持查詢最近30天內(nèi)的轉(zhuǎn)賬批次單狀態(tài)，30天之前的轉(zhuǎn)賬批次單請(qǐng)登錄商戶平臺(tái)查詢。
2、當(dāng)發(fā)起商家轉(zhuǎn)賬到零錢(qián)請(qǐng)求受理成功之后，需等待10s-15min左右（批次內(nèi)筆數(shù)越多所需等待時(shí)間越長(zhǎng)）才可調(diào)用《通過(guò)微信批次單號(hào)查詢批次單》、《通過(guò)商家批次單號(hào)查詢批次單》接口來(lái)查詢批次轉(zhuǎn)賬狀態(tài)，若發(fā)起轉(zhuǎn)賬請(qǐng)求后立即查詢，有可能查詢到“轉(zhuǎn)賬批次單不存在”，請(qǐng)間隔幾分鐘再次嘗試查詢。
3、當(dāng)查詢到的批次單狀態(tài)為：WAIT_PAY 時(shí)， 表示「付款驗(yàn)密人」需要到「微信支付商戶助手」輸入安全密碼驗(yàn)證，24小時(shí)內(nèi)未完成驗(yàn)證，自動(dòng)關(guān)閉批次單。
4、當(dāng)查詢到批次單狀態(tài)為FINISHED(已完成),才可進(jìn)行下一步，查詢轉(zhuǎn)賬明細(xì)狀態(tài)。
# 第三步：查詢轉(zhuǎn)賬明細(xì)狀態(tài)
當(dāng)查詢到批次單狀態(tài)為FINISHED(已完成)，才可調(diào)用《通過(guò)微信明細(xì)單號(hào)查詢明細(xì)單》、《通過(guò)商家明細(xì)單號(hào)查詢明細(xì)單》接口進(jìn)行轉(zhuǎn)賬明細(xì)查詢。
# 第四步：申請(qǐng)下載電子回單(按需使用)
1、發(fā)起轉(zhuǎn)賬時(shí)傳入了收款用戶姓名，才支持申請(qǐng)電子回單。
2、支持受理2年內(nèi)的轉(zhuǎn)賬批次電子回單和轉(zhuǎn)賬明細(xì)電子回單。
3、僅支持已完成狀態(tài)且至少有一筆成功記錄的批次獲取轉(zhuǎn)賬批次電子回單(不滿足條件返回 400 INVALID_REQUEST)；
4、僅支持轉(zhuǎn)賬已完成的明細(xì)單申請(qǐng)電子回單（不滿足條件返回 400 PARAM_ERROR）；
5、詳情參考 申請(qǐng)轉(zhuǎn)賬賬單電子回單接口、查詢轉(zhuǎn)賬賬單電子回單接口、申請(qǐng)轉(zhuǎn)賬明細(xì)賬單電子回單、查詢轉(zhuǎn)賬明細(xì)賬單電子回單、下載電子回單。
