# 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)建加載商戶私鑰、加載平臺(tái)證書、初始化httpClient的通用方法。
3、基于接口的示例代碼，替換請求參數(shù)后可發(fā)起測試。
說明：
- 上面的開發(fā)庫為微信支付官方開發(fā)庫，其它沒有審核或者控制下的第三方工具和庫，微信支付不保證它們的安全性和可靠性。通過包管理工具引入SDK后，可根據(jù)下面每個(gè)接口的示例代碼替換相關(guān)參數(shù)后進(jìn)行快速測試。
- 開發(fā)者如果想詳細(xì)了解簽名生成、簽名驗(yàn)證、敏感信息加/解密、媒體文件上傳等常用方法的具體代碼實(shí)現(xiàn)，可閱讀下面的詳細(xì)說明：
- 如想更詳細(xì)的了解我們的接口規(guī)則，可查看我們的接口規(guī)則指引文檔。
# 3. 快速接入
# 3.1. 業(yè)務(wù)流程圖
重點(diǎn)步驟說明：
步驟4 商戶調(diào)用建立合作關(guān)系接口，將指定優(yōu)惠券批次（支付券或商家券）授權(quán)給指定AppID。
步驟7 用戶在商家小程序直播間，可領(lǐng)取對應(yīng)優(yōu)惠券；（優(yōu)惠券領(lǐng)取后，自動(dòng)插入用戶微信卡包）。
# 3.2. API接入（含示例代碼）
文檔展示了如何使用微信支付服務(wù)端 SDK 快速接入商家券產(chǎn)品，完成與微信支付對接的部分。
注意
- 文檔中的代碼示例是用來闡述 API 基本使用方法，代碼中的示例參數(shù)需替換成商戶自己賬號(hào)及請求參數(shù)才能跑通。
- 以下接入步驟僅提供參考，請商戶結(jié)合自身業(yè)務(wù)需求進(jìn)行評估、修改。
# 3.2.1. 【服務(wù)端】建立合作關(guān)系
步驟說明： 該接口主要為商戶提供營銷資源的授權(quán)能力，可授權(quán)給其他商戶或小程序，方便商戶間的互利合作。
重要入?yún)⒄f明：
- type： 合作方類別，枚舉值：
- AppID：合作方為AppID
- MERCHANT：合作方為商戶
- business_type： 授權(quán)業(yè)務(wù)類別，枚舉值：
- FAVOR_STOCK：代金券批次
- BUSIFAVOR_STOCK：商家券批次
更多參數(shù)、響應(yīng)詳情及錯(cuò)誤碼請參見建立合作關(guān)系接口文檔。
# 3.2.2. 【服務(wù)端】查詢合作關(guān)系列表
步驟說明： 該接口主要為商戶提供合作關(guān)系列表的查詢能力。
重要入?yún)⒄f明：
- business_type： 授權(quán)業(yè)務(wù)類別，枚舉值：
- FAVOR_STOCK：代金券批次
- BUSIFAVOR_STOCK：商家券批次
更多參數(shù)、響應(yīng)詳情及錯(cuò)誤碼請參見查詢合作關(guān)系列表接口文檔。
# 4. 常見問題
# Q：調(diào)用建立合作關(guān)系接口返回“AppID與mchid不匹配”
A：請按照以下幾點(diǎn)檢查：
- AppID或mch_id填寫錯(cuò)誤，請確認(rèn)AppID和mch_id是否正確。
- AppID與mch_id未綁定，請綁定后再調(diào)用接口，綁定步驟請參考《綁定指引 (opens new window)》文檔。
# Q：調(diào)用建立合作關(guān)系接口返回“商戶號(hào)不存在”
A：商戶號(hào)不存在，請確認(rèn)請求頭中的商戶號(hào)是否正確或者是否有空格。
# Q：查詢合作關(guān)系列表API返回“簽名錯(cuò)誤或簽名信息不完整”
A：請按照以下幾點(diǎn)檢查：
- 簽名與生成Authorization用的同一個(gè)時(shí)間戳跟隨機(jī)串。
- 構(gòu)造簽名串時(shí)，里面的URL不需要ToLowCase()，不用UrlEncode()，商戶請求的URL后綴是什么，簽名用的URL后綴就是什么。
- 查詢訂單使用的是GET，構(gòu)建簽名串時(shí)，里面的請求報(bào)文為空且需要換行符。
- 檢查證書和商戶號(hào)是否正確，如為服務(wù)商模式，則需使用服務(wù)商的相關(guān)證書。簽名相關(guān)問題請參考《接口規(guī)則》文檔。
# Q：調(diào)用建立合作關(guān)系接口返回“商戶證書序列號(hào)有誤。請使用簽名私鑰匹配的證書序列號(hào)”
A：請求頭中的API證書序列號(hào)錯(cuò)誤，請排查確認(rèn)。證書序列號(hào)查看路徑：【商戶平臺(tái) (opens new window)->API安全->API證書->查看證書】。
# Q：調(diào)用建立合作關(guān)系接口返回“HTTP頭缺少Accept或User-Agent”
A：HTTP頭缺少Accept或User-Agent，請根據(jù)V3接口規(guī)則內(nèi)容進(jìn)行排查。
