# 1. 接口規(guī)則

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

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

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

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

測試步驟：

1、根據(jù)自身開發(fā)語言，選擇對應(yīng)的開發(fā)庫并構(gòu)建項(xià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)建加載商戶私鑰、加載平臺證書、初始化httpClient的通用方法。

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

說明：

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

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

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

# 2.2. 業(yè)務(wù)開發(fā)配置

1. 登錄【微信支付服務(wù)商平臺 (opens new window)】后，通過路徑【產(chǎn)品中心—>我的產(chǎn)品—>支付即服務(wù)—>產(chǎn)品設(shè)置】，即可開通支付即服務(wù)，開通后完成產(chǎn)品設(shè)置。

   

2. 【產(chǎn)品設(shè)置】頁面如下圖所示，具體內(nèi)容包括上傳商家logo、選擇服務(wù)人員名稱及選擇名片功能模塊。

   

# 3. 快速接入

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

重點(diǎn)步驟說明：

步驟6 使用企業(yè)微信的商戶，通過《服務(wù)人員注冊API》接口傳入服務(wù)人員信息進(jìn)行注冊，微信支付返回服務(wù)人員ID給到商戶，商戶需將服務(wù)人員注冊信息和對應(yīng)的服務(wù)人員ID進(jìn)行妥善保存。

步驟11 商戶在下單時(shí)生成商戶訂單號，接著調(diào)用《服務(wù)人員分配API》傳入“商戶訂單號+服務(wù)人員ID”，隨后按照原有流程和支付接口完成支付即可。

# 3.2. API接入（含示例代碼）

文檔展示了如何使用微信支付服務(wù)端 SDK 快速接入商家券產(chǎn)品，完成與微信支付對接的部分。

# 3.2.1. 【服務(wù)端】服務(wù)人員注冊

步驟說明： 商戶開發(fā)者使用「服務(wù)人員注冊接口」為商戶注冊服務(wù)人員。

重要入?yún)⒄f明：

• store_id： 門店在微信支付商戶平臺的唯一標(biāo)識（查找路徑：登錄商戶平臺—>營銷中心—>門店管理，若無門店則需先創(chuàng)建門店）。
• name： 員工在商戶企業(yè)微信通訊錄上的姓名,需使用微信支付平臺公鑰加密該字段需進(jìn)行加密處理，加密方法詳見敏感信息加密說明。特殊規(guī)則：加密前字段長度限制為64個(gè)字節(jié)。

更多參數(shù)、響應(yīng)詳情及錯(cuò)誤碼請參見服務(wù)人員注冊API接口文檔。

# 3.2.2. 【服務(wù)端】服務(wù)人員分配

步驟說明： 服務(wù)人員分配接口用于商戶開發(fā)者在顧客下單后為顧客分配服務(wù)人員使用。

重要入?yún)⒄f明：

• out_trade_no： 商戶系統(tǒng)內(nèi)部訂單號，要求32個(gè)字符內(nèi)，僅支持使用字母、數(shù)字、中劃線-、下劃線_、豎線|、星號*這些英文半角字符的組合，請勿使用漢字或全角等特殊字符，且在同一個(gè)商戶號下唯一。

更多參數(shù)、響應(yīng)詳情及錯(cuò)誤碼請參見服務(wù)人員分配API接口文檔。

# 3.2.3. 【服務(wù)端】服務(wù)人員查詢

步驟說明： 服務(wù)人員查詢接口用于商戶開發(fā)者查詢已注冊的服務(wù)人員ID等信息。

重要入?yún)⒄f明：

• userid： 員工在商戶企業(yè)微信通訊錄使用的唯一標(biāo)識，企業(yè)微信商家可傳入該字段查詢單個(gè)服務(wù)人員信息；不傳則查詢整個(gè)門店下的服務(wù)人員信息。

更多參數(shù)、響應(yīng)詳情及錯(cuò)誤碼請參見服務(wù)人員查詢API接口文檔。

# 3.2.4. 【服務(wù)端】服務(wù)人員信息更新

步驟說明： 服務(wù)人員信息更新接口用于商戶開發(fā)者為商戶更新門店服務(wù)人員的姓名、頭像等信息。

重要入?yún)⒄f明：

• guide_id： 務(wù)人員在支付即服務(wù)系統(tǒng)中的唯一標(biāo)識。

更多參數(shù)、響應(yīng)詳情及錯(cuò)誤碼請參見服務(wù)人員信息更新API接口文檔

# 4. 常見問題

# Q：使用服務(wù)人員注冊API進(jìn)行注冊時(shí)，sub_mchid（子商戶ID）應(yīng)該傳什么？

A：如果是普通特約商戶自己調(diào)接口，不傳即可；如果是普通服務(wù)商幫特約商戶調(diào)接口，傳特約商戶的商戶號。

# Q：企業(yè)微信的corpid如何獲取？

A：獲取corpid可進(jìn)入企業(yè)微信的管理后臺，查找路徑：【我的企業(yè)->企業(yè)信息→查看“企業(yè)ID”】（需要有管理員權(quán)限）。

# Q：注冊服務(wù)人員時(shí)必須傳入門店ID嗎？在哪里找這個(gè)門店ID？

A：是的，注冊時(shí)必須傳入門店ID。該門店ID是微信支付門店系統(tǒng)的編碼，查找路徑：【登錄商戶平臺->營銷中心→門店管理】，門店管理頁面下的門店編號即為需要填寫的門店ID（該門店信息與企業(yè)微信的門店系統(tǒng)無關(guān)）。

若未創(chuàng)建門店，則需創(chuàng)建門店并通過騰訊地圖審核后，方可使用門店ID進(jìn)行注冊。

# Q：調(diào)用服務(wù)人員分配接口是在支付前還是支付后？

A：支付前。建議當(dāng)商家生成當(dāng)前交易的“商戶訂單號”時(shí)，通過“服務(wù)人員分配API”將“服務(wù)人員ID+商戶訂單號”傳給微信支付，并按照原有流程引導(dǎo)用戶完成支付即可。若分配服務(wù)人員晚于支付完成，則將無法在支付憑證上出現(xiàn)服務(wù)人員名片入口。

# Q：服務(wù)人員分配應(yīng)該采取什么樣的分配機(jī)制？

A：使用服務(wù)人員分配API進(jìn)行分配時(shí)，服務(wù)人員的分配機(jī)制由商家內(nèi)部閉環(huán)，可以靈活掌控。在支付前調(diào)用分配接口時(shí)，商家可自行決定分配哪名服務(wù)人員，商家可選擇隨機(jī)分配、按時(shí)間段分配，或?yàn)槟彻P訂單指定特定服務(wù)人員的分配方式（例如在線下門店支付時(shí)，可分配當(dāng)前為該顧客提供服務(wù)的服務(wù)人員）。使用免開發(fā)版本時(shí)，商戶號下的所有訂單將隨機(jī)分配給不同服務(wù)人員，商家可通過小程序調(diào)整服務(wù)人員分配的時(shí)間段，但是不能針對不同訂單分配特定的服務(wù)人員