H5接入操作
1、發(fā)券方式
用戶在商戶H5頁面觸發(fā)領(lǐng)券操作后，通過Url跳轉(zhuǎn)，由商戶H5重定向至指定微信支付H5頁面(https://action.weixin.qq.com/busifavor/getcouponinfo)并添加指定參數(shù)，用戶在微信支付H5頁面中點擊領(lǐng)券后，將自動給用戶發(fā)券。
注：每一個H5領(lǐng)券域名后，都需添加#wechat_redirect，否則會報錯，返回268435461錯誤碼
https://action.weixin.qq.com/busifavor/getcouponinfo?stock_id=1234567890000000&out_request_no=201911280000&sign=D0D028212D200DC9DASDFSDFFD3676BEAD03046DC3A2E82A64C784EFFAF&send_coupon_merchant=123456789&open_id=oiSFDIOoijdsf#wechat_redirect
2、URL中參數(shù)
商戶需在Url中攜帶用戶信息及批次信息方可正常發(fā)券，具體參數(shù)如下：
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 批次號 | stock_id | string[1,20] | 是 | 微信支付商家券批次號 |
| 發(fā)券憑證 | out_request_no | string[1,128] | 是 | 發(fā)券憑證（示例格式：商戶 id+日期+流水號），可包含英文字母、數(shù)字，不允許出現(xiàn)其他不合法符號，商戶側(cè)需保證發(fā)放憑據(jù)號唯一性 |
| 簽名 | sign | string | 是 | 簽名計算值。 簽名方式：HMAC-SHA256。 簽名規(guī)則：詳見《V2 簽名規(guī)則》 參與簽名字段說明 注意：為了安全，簽名必須在后臺服務(wù)器計算，禁止在H5中計算，簽名 key 為微信支付 apiv2 的 signkey 示例值：9A0A8659F005D6984697E2CA0A9CF3B79A0A8659F005D6984697E2CA0A9CF3B7 |
| 發(fā)券商戶號 | send_coupon_merchant | string[1,15] | 是 | 調(diào)用發(fā)券接口的商戶號 |
| 用戶openid | open_id | string[1,128] | 是 | 目標(biāo)發(fā)券的用戶openid |
返回處理
由于H5發(fā)券采用的是Url重定向的形式，故無法直接將發(fā)券結(jié)果返回給商戶。
建議商戶調(diào)用【根據(jù)過濾條件查詢用戶券】接口及【查詢用戶單張券詳情】接口，查詢發(fā)券接口。
舉例：用戶領(lǐng)券完成并返回商家H5后，商家可自行觸發(fā)刷新事件，使用【根據(jù)過濾條件查詢用戶券】接口，通過創(chuàng)建商戶號、批次號、openid，查詢用戶是否已成功領(lǐng)取指定批次券，以及領(lǐng)取券的具體code。
錯誤碼
如果發(fā)券失敗，錯誤碼將在發(fā)券結(jié)果頁面展示給用戶及開發(fā)者，開發(fā)者可根據(jù)該頁面展示的錯誤碼查詢失敗原因。
為保證用戶體驗，部分易懂的錯誤原因?qū)⒅苯诱故窘o用戶。
發(fā)券結(jié)果（send_coupon_result）中的錯誤碼
| 錯誤碼 | 描述 | 解決方案 |
|---|---|---|
| 268455936 | 發(fā)券參數(shù)錯誤，請檢查發(fā)券參數(shù) | 請檢查發(fā)券參數(shù) |
| 272758302，272756756 | 批次已過期 | 請檢查批次時間 |
| 272758303，272756737，272757763 | 批次預(yù)算不足 | 請檢查批次預(yù)算 |
| 272756738 | 該批次已達(dá)到單天發(fā)放上限 | 請檢查批次單天發(fā)放上限 |
| 272756740 | 用戶領(lǐng)取券張數(shù)已達(dá)上限 | 請檢查用戶領(lǐng)取情況 |
| 272756753 | 用戶已領(lǐng)取過這張券 | 請檢查用戶領(lǐng)取情況 |
| 272756739 | 自然人限領(lǐng)攔截 | 請停止發(fā)放給該用戶 |
| 272756743 | 批次狀態(tài)不合法，檢查該批次是否處于運營中 | 請檢查批次狀態(tài) |
| 272756762? | 指定Code發(fā)券模式下， 當(dāng)前發(fā)券Code已被使用 | 請更換Code后重試 |
| 272755722 | 批次不存在 | 請檢查批次號是否正確 |
| 272755713 | 用戶安全防刷攔截（潛在羊毛黨、黑產(chǎn)用戶） | 請停止發(fā)放給該用戶 |
| 272758292 | 未獲取到用戶信息，需重試 | 請檢查用戶信息是否正確 |
| 272758286 | openid不正確 | 請檢查openid是否正確 |
| 272758293 | 簽名錯誤 | 請檢查簽名是否正確 |
| 272758295，272758304 | 系統(tǒng)超時，請重試 | 請稍后重試 |
| 272756755 | 發(fā)券商戶號必須為制券商戶號或券歸屬商戶號 | 請檢查發(fā)券商戶號是否為制券商戶號或券歸屬商戶號 |
| 272756757 | 用戶openid對應(yīng)的appid必須與發(fā)券商戶號有綁定關(guān)系 | 請檢查用戶openid對應(yīng)的appid與發(fā)券商戶號是否有綁定關(guān)系 |
| 268435461 | H5領(lǐng)券域名參數(shù)錯誤 | 每一個H5領(lǐng)券域名后，都需添加#wechat_redirect，請檢查是否添加 |
| 272756767 | 指定Code發(fā)券模式下， 沒有填寫指定Code信息 | 請檢查發(fā)券參數(shù)，檢查是否有填寫Coupon_code |
| 272757252 | 無權(quán)限操作 | 請檢查調(diào)用發(fā)券接口的發(fā)券商戶號與批次號之間的關(guān)系，是否未批次的創(chuàng)建方或歸屬方或有合作授權(quán)關(guān)系 |