# 1. 接口規(guī)則
為了在保證支付安全的前提下，帶給商戶簡單、一致且易用的開發(fā)體驗，我們推出了全新的微信支付APIv3接口。該版本API的具體規(guī)則請參考APIv3接口規(guī)則。
# 2. 開發(fā)準備
# 2.1. 搭建和配置開發(fā)環(huán)境
為了幫助開發(fā)者調用開放接口，我們提供了JAVA、PHP、GO三種語言版本的開發(fā)庫，封裝了簽名生成、簽名驗證、敏感信息加/解密、媒體文件上傳 等基礎功能（更多語言版本的開發(fā)庫將在近期陸續(xù)提供）。
測試步驟：
1、根據(jù)自身開發(fā)語言，選擇對應的開發(fā)庫并構建項目，具體配置請參考下面鏈接的詳細說明：
- wechatpay-java (opens new window)（推薦）、wechatpay-apache-httpclient (opens new window)，適用于Java開發(fā)者。
- 注：當前開發(fā)指引接口JAVA示例代碼采用wechatpay-apache-httpclient版本。
- wechatpay-php (opens new window)（推薦）、wechatpay-guzzle-middleware (opens new window)，適用于PHP開發(fā)者。
- 注：當前開發(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ù)下面每個接口的示例代碼替換相關參數(shù)后進行快速測試。
- 開發(fā)者如果想詳細了解簽名生成、簽名驗證、敏感信息加/解密、媒體文件上傳等常用方法的具體代碼實現(xiàn)，可閱讀下面的詳細說明：
- 如想更詳細的了解我們的接口規(guī)則，可查看我們的接口規(guī)則指引文檔。
# 3. 快速接入
# 3.1. 業(yè)務流程圖
重點步驟說明：
步驟4 商戶調用《建立合作關系》接口，將指定優(yōu)惠券批次（支付券或商家券）授權給指定AppID。
步驟7 用戶在商家小程序直播間，可領取對應優(yōu)惠券；（優(yōu)惠券領取后，自動插入用戶微信卡包）。
# 3.2. API接入（含示例代碼）
文檔展示了如何使用微信支付服務端 SDK 快速接入商家券產(chǎn)品，完成與微信支付對接的部分。
注意
- 文檔中的代碼示例是用來闡述 API 基本使用方法，代碼中的示例參數(shù)需替換成商戶自己賬號及請求參數(shù)才能跑通。
- 以下接入步驟僅提供參考，請商戶結合自身業(yè)務需求進行評估、修改。
# 3.2.1. 【服務端】建立合作關系
步驟說明： 該接口主要為商戶提供營銷資源的授權能力，可授權給其他商戶或小程序，方便商戶間的互利合作。
重要入?yún)⒄f明：
- type： 合作方類別，枚舉值：
- AppID：合作方為AppID
- MERCHANT：合作方為商戶
- business_type： 授權業(yè)務類別，枚舉值：
- FAVOR_STOCK：代金券批次
- BUSIFAVOR_STOCK：商家券批次
更多參數(shù)、響應詳情及錯誤碼請參見建立合作關系接口文檔。
# 3.2.2. 【服務端】查詢合作關系列表
步驟說明： 該接口主要為商戶提供合作關系列表的查詢能力。
重要入?yún)⒄f明：
- business_type： 授權業(yè)務類別，枚舉值：
- FAVOR_STOCK：代金券批次
- BUSIFAVOR_STOCK：商家券批次
更多參數(shù)、響應詳情及錯誤碼請參見查詢合作關系列表接口文檔。
# 4. 常見問題
# Q：調用建立合作關系接口返回“AppID與mchid不匹配”
A：請按照以下幾點檢查：
- AppID或mch_id填寫錯誤，請確認AppID和mch_id是否正確。
- AppID與mch_id未綁定，請綁定后再調用接口，綁定步驟請參考《綁定指引 (opens new window)》文檔。
# Q：調用建立合作關系接口返回“商戶號不存在”
A：商戶號不存在，請確認請求頭中的商戶號是否正確或者是否有空格。
# Q：查詢合作關系列表API返回“簽名錯誤或簽名信息不完整”
A：請按照以下幾點檢查：
- 簽名與生成Authorization用的同一個時間戳跟隨機串。
- 構造簽名串時，里面的URL不需要ToLowCase()，不用UrlEncode()，商戶請求的URL后綴是什么，簽名用的URL后綴就是什么。
- 查詢訂單使用的是GET，構建簽名串時，里面的請求報文為空且需要換行符。
- 檢查證書和商戶號是否正確，如為服務商模式，則需使用服務商的相關證書。簽名相關問題請參考《接口規(guī)則》文檔。
# Q：調用建立合作關系接口返回“商戶證書序列號有誤。請使用簽名私鑰匹配的證書序列號”
A：請求頭中的API證書序列號錯誤，請排查確認。證書序列號查看路徑：【服務商平臺 (opens new window)->API安全->API證書->查看證書】。
# Q：調用建立合作關系接口返回“HTTP頭缺少Accept或User-Agent”
A：HTTP頭缺少Accept或User-Agent，請根據(jù)V3接口規(guī)則內容進行排查。
