# 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ā)配置

# 2.2.1. 服務(wù)商開通點(diǎn)金計(jì)劃

操作路徑：【登錄微信服務(wù)商平臺 (opens new window) → 服務(wù)商功能 → 點(diǎn)金計(jì)劃】，點(diǎn)擊申請開通即可。

# 2.2.2. 開通官方小票配置

若僅為特約商戶開通點(diǎn)金計(jì)劃，未開通商家小票功能，該商戶JSAPI支付后會展示官方小票樣式。

操作路徑：【登錄微信服務(wù)商平臺 (opens new window) → 服務(wù)商功能 → 點(diǎn)金計(jì)劃】，在“特約商戶管理” 模塊中，打開“點(diǎn)金計(jì)劃”開關(guān)。

開通官方小票后的頁面展示如下圖：

點(diǎn)擊申請開通后進(jìn)入開通流程，根據(jù)指引簽署承諾函并填寫業(yè)務(wù)聯(lián)絡(luò)人，即可提交申請并開通。

# 2.2.3. 開通商家小票配置

若為特約商戶開通點(diǎn)金計(jì)劃時(shí)，已開通了商家小票功能且已按開發(fā)文檔完成接入，該商戶JSAPI支付后會展示商家小票樣式。

# 服務(wù)商維度配置商家小票鏈接

配置路徑：【登錄微信支付服務(wù)商平臺 (opens new window) → 服務(wù)商功能 → 點(diǎn)金計(jì)劃】。在“商家小票鏈接配置” 模塊中，點(diǎn)擊“添加商家小票鏈接”：

# 特約商戶維度配置獨(dú)立商家小票鏈接

配置路徑：【登錄微信支付服務(wù)商平臺 (opens new window) → 服務(wù)商功能 → 點(diǎn)金計(jì)劃】。在“特約商戶管理” 模塊中，點(diǎn)擊“更多”添加“配置特約商戶商家小票鏈接”：

# 2.2.4. 使用“商家小票調(diào)試工具”進(jìn)行調(diào)試

說明： 為了保證商家小票在點(diǎn)金計(jì)劃頁面展示的兼容性、完整性，平臺還提供了便捷的商家小票調(diào)試工具供服務(wù)商進(jìn)行調(diào)試。服務(wù)商可通過商家小票調(diào)試工具，使用所選鏈接和真實(shí)訂單號對點(diǎn)金計(jì)劃頁面的數(shù)據(jù)交互流程、前端JSAPI 的使用進(jìn)行調(diào)試。

商家小票調(diào)試工具路徑： 【登錄微信支付服務(wù)商平臺 (opens new window) → 服務(wù)商功能 → 點(diǎn)金計(jì)劃】在“商家小票鏈接配置” 模塊右邊，點(diǎn)擊“商家小票調(diào)試工具”

# 3. 快速接入

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

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

步驟5 已打開特約商戶的商家小票及點(diǎn)金計(jì)劃開關(guān)

步驟11 商家小票頁面需調(diào)用父頁面“onIframeReady”事件的jsapi，請查看商家小票開發(fā)指引 (opens new window)。
在商家小票頁面渲染完成后，調(diào)用父頁面的“onIframeReady”事件的JSAPI，并且從加載商家小票頁面開始到調(diào)用“onIframeReady”事件的JSAPI之間的用時(shí)不可超過3s，否則會提示無法獲取訂單信息。

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

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

# 3.2.1. 【服務(wù)端】點(diǎn)金計(jì)劃管理

步驟說明： 服務(wù)商使用此接口為特約商戶開通或關(guān)閉點(diǎn)金計(jì)劃。

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

• sub_mchid：特約商戶號，開通或關(guān)閉點(diǎn)金計(jì)劃的特約商戶商戶號，由微信支付生成并下發(fā)。
• operation_type：操作類型， 開通或關(guān)閉點(diǎn)金計(jì)劃的動作，枚舉值：
  • OPEN：表示開通點(diǎn)金計(jì)劃。
  • CLOSE：表示關(guān)閉點(diǎn)金計(jì)劃。

更多參數(shù)、響應(yīng)詳情及錯(cuò)誤碼請參見點(diǎn)金計(jì)劃管理接口文檔。

# 3.2.2. 【服務(wù)端】商家小票管理

步驟說明： 服務(wù)商使用此接口為特約商戶開通或關(guān)閉商家小票功能。

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

• sub_mchid：特約商戶號，開通或關(guān)閉點(diǎn)金計(jì)劃的特約商戶商戶號，由微信支付生成并下發(fā)。
• operation_type：開通或關(guān)閉“商家自定義小票”的動作，枚舉值：
  • OPEN：表示開通點(diǎn)金計(jì)劃
  • CLOSE：表示關(guān)閉點(diǎn)金計(jì)劃

更多參數(shù)、響應(yīng)詳情及錯(cuò)誤碼請參見商家小票管理接口文檔。

# 3.2.3. 【服務(wù)端】同業(yè)過濾標(biāo)簽管理

步驟說明： 服務(wù)商使用此接口為特約商戶配置同業(yè)過濾標(biāo)簽，防止特約商戶支付后出現(xiàn)同行業(yè)的廣告內(nèi)容。

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

• sub_mchid：特約商戶號，開通或關(guān)閉點(diǎn)金計(jì)劃的特約商戶商戶號，由微信支付生成并下發(fā)。
• advertising_industry_filters：同業(yè)過濾標(biāo)簽值，特約商戶同業(yè)過濾的同業(yè)過濾標(biāo)簽值，同業(yè)過濾標(biāo)簽最少傳一個(gè)，最多三個(gè)。如已設(shè)置同業(yè)過濾標(biāo)簽，再次請求傳入，視為新增，將覆蓋原有同業(yè)標(biāo)簽配置。枚舉值：
  • E_COMMERCE：綜合電商平臺
  • LOVE_MARRIAGE：婚戀
  • POTOGRAPHY：攝影攝像機(jī)構(gòu)及服務(wù)
  • EDUCATION：教育
  • FINANCE：金融
  • TOURISM：旅游
  • SKINCARE：護(hù)膚彩妝

更多參數(shù)、響應(yīng)詳情及錯(cuò)誤碼請參見同業(yè)過濾標(biāo)簽管理接口文檔。

# 3.2.4. 【服務(wù)端】開通廣告展示

步驟說明： 服務(wù)商使用此接口為特約商戶開通或關(guān)閉點(diǎn)金計(jì)劃。

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

• sub_mchid：特約商戶號，開通或關(guān)閉點(diǎn)金計(jì)劃的特約商戶商戶號，由微信支付生成并下發(fā)。
• advertising_industry_filters：同業(yè)過濾標(biāo)簽值，特約商戶同業(yè)過濾的同業(yè)過濾標(biāo)簽值，同業(yè)過濾標(biāo)簽最少傳一個(gè)，最多三個(gè)。 如已設(shè)置同業(yè)過濾標(biāo)簽，再次請求傳入，視為新增，將覆蓋原有同業(yè)標(biāo)簽配置。枚舉值：
  • E_COMMERCE：綜合電商平臺
  • LOVE_MARRIAGE：婚戀
  • POTOGRAPHY：攝影攝像機(jī)構(gòu)及服務(wù)
  • EDUCATION：教育
  • FINANCE：金融
  • TOURISM：旅游
  • SKINCARE：護(hù)膚彩妝
  • FOOD：食品
  • SPORT：運(yùn)動戶外
  • JEWELRY_WATCH：珠寶鐘表

更多參數(shù)、響應(yīng)詳情及錯(cuò)誤碼請參見開通廣告展示接口文檔。

# 3.2.5. 【服務(wù)端】關(guān)閉廣告展示

步驟說明： 使用此接口為特約商戶的點(diǎn)金計(jì)劃頁面關(guān)閉廣告展示功能。

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

• sub_mchid：特約商戶號，開通或關(guān)閉點(diǎn)金計(jì)劃的特約商戶商戶號，由微信支付生成并下發(fā)。

更多參數(shù)、響應(yīng)詳情及錯(cuò)誤碼請參見關(guān)閉廣告展示接口文檔。

# 4. 常見問題

# Q：為特約商戶開通/關(guān)閉點(diǎn)金計(jì)劃后，多久后會生效？

A：為特約商戶開通后，5分鐘內(nèi)其支付回調(diào)頁會替換為點(diǎn)金計(jì)劃頁面。

# Q：為什么看不到“商家小票”開關(guān)？

A：需要在商家小票鏈接配置模塊，添加商家小票鏈接，才會在特約商戶管理模塊出現(xiàn)“商家小票”開關(guān)。

# Q：調(diào)試商家小票時(shí)出現(xiàn)“無法獲取訂單信息”頁面，是什么原因?qū)е碌模?/h3>

A：調(diào)試時(shí)需確認(rèn)以下事項(xiàng)：

• 已打開特約商戶的商家小票及點(diǎn)金計(jì)劃開關(guān)；
• 商家小票頁面需調(diào)用父頁面“onIframeReady事件”的jsapi，具體請查看商家小票開發(fā)指引；
• 從加載商家小票到調(diào)用JSAPI之間的用時(shí)不可超過3s；
• 調(diào)試時(shí)，掃描二維碼的微信號和支付該筆測試訂單的微信號需為同一個(gè)；
• 商家小票頁面可正常訪問。

# Q：服務(wù)商返傭具體怎么計(jì)算？10003”

A：返傭獎(jiǎng)勵(lì)（元）=eCPM（元）/1000 *支付后廣告曝光量 。其中：

• eCPM是廣告每千次曝光的收益金額。
• 用戶支付后快速離開頁面或弱網(wǎng)等情況會導(dǎo)致部分訂單無法曝光廣告。

# Q：特約商戶開通了點(diǎn)金計(jì)劃后，支付后頁面的展示形式？

A：開通點(diǎn)金計(jì)劃之后，用戶在支付完成頁點(diǎn)擊“完成”后，只會展示點(diǎn)金計(jì)劃頁面，不會再展示服務(wù)商的支付回調(diào)頁。無須擔(dān)心業(yè)務(wù)內(nèi)容被阻斷，可通過點(diǎn)金計(jì)劃頁面的“商家小票”功能嵌入商家的服務(wù)性內(nèi)容（例如取餐碼、停車剩余時(shí)長等）。