微信卡券開發(fā)者錯誤排查手冊V2.0

1、微信卡券開發(fā)者錯誤排查文檔微信開放平臺應(yīng)用產(chǎn)品中心2015 年 7 月 20 日目錄微信卡券開發(fā)者錯誤排查文檔 1.Part.1 常見錯誤 3.1.1 接入指引 3.1.2 卡券創(chuàng)建 4.1.3 卡券投放 5.1.4 卡券核銷 8.Part.2 常見疑問 9.Part.3錯誤返回碼釋義 11Part .1接入問題1.1接入指引Q1 :為什么公眾號之前有申請自定義SN號權(quán)限入口，現(xiàn)在沒有了？A:現(xiàn)在開通卡券權(quán)限默認為開通SN權(quán)限，所以現(xiàn)在已經(jīng)無需申請了。Q2 :如何開通儲值卡權(quán)限？A：儲值卡（如有儲值功能的會員卡），需提交預付卡備案，待審核通過后，獲得儲值權(quán)限， 具體說明詳見：https:/mp

2、.weix in bin/frame?t=cardticket/apply prepaid frame&lang=zh CN&token=1596050821Q3 :配置JS API域名（不審核，配置即生效）的規(guī)則是什么？由于部分商戶測試環(huán)境不能使用正式域名，因此，給予商戶修改一次域名的機會。請確定域名后再進行線上配置。配置前請仔細閱讀卡券接口文檔（添加到卡包JSAPI接口）的相關(guān)說明，確保申請格式（ip地址無效）無誤，且在調(diào)用該域名下的 url時，需添 力口參數(shù) wechat_card_js=1 。若聯(lián)調(diào)中有問題，請先參考后面的調(diào)試案例，一般存在的問題為：字段拼寫錯誤、簽 名

3、錯誤、未加指定參數(shù)等。Q4 :微信卡券的使用流程是什么呢?1.2卡券創(chuàng)建48001,api unauthorziedAPI無權(quán)限： 未申請開通卡券功能權(quán)限確認使創(chuàng)建卡券返回提示未授權(quán)用的APPID是否開通卡券權(quán)限，另外仔細查看是不是用錯了 appid查看生成的access_token 是否為開通卡券權(quán)限的appid生成的創(chuàng)建卡券可以直接粘貼Wiki上的示例47001,data format error時間類型字段填寫錯誤：type 1或2僅支持填寫代碼請求一創(chuàng)建卡券返回提示格式錯誤相應(yīng)專屬字段，詳情見文檔更新后的時間類型為DATE TYPE FIX TIME RANGE 和DATE_TYPE_

4、FIX_TERM，分別對應(yīng) type1 和type2，為字符串類型次，如果成功則以一比對排miss ing required fields!please check docume ntand request json!創(chuàng)建時提示字段缺失"errcode": 47001,缺失或者錯誤填寫了必填參數(shù)，hint后面為缺少字段，請對照文檔必填字段要求進行排查POST數(shù)據(jù)格式錯誤，出錯點在error before 之前,"errmsg": "data format error hin ts: Error before請對照文檔排查1.3卡券投放創(chuàng)建卡券二

5、維碼提示成功，但錯將生成帶參數(shù)二維碼鏈接當成生成是掃描二維碼之后卻是公眾號二維碼卡券二維碼鏈接使用1. i-bin/qrcode/create?access_token=TOKEN帶參數(shù)二維碼生成鏈接2. card /qrcode/create?access token=TOKEN卡券二維碼生成鏈接可以直接粘貼Wiki上的示例代碼和請求鏈接，如果成功則以一比對排錯創(chuàng)建二維碼In valid action n ame錯將 action name "QR_CARD "寫成“ QRCODE”in valid actio n info1.該cardd創(chuàng)建時的屬性和生成二維 碼時填寫

6、的不匹配，例如創(chuàng)建時為非自 定義code，生成二維碼時填寫了自定 義code ;創(chuàng)建沒有 bind_openid生成時傳入 ope nid2.創(chuàng)建卡券時某些字段填寫錯誤，常見為can share不是 字符串，不要加“”。調(diào)用查詢卡券詳情接口對比創(chuàng)建二維碼字段和創(chuàng)建卡券字段是否對齊bu為了提高用戶成功領(lǐng)取卡券幾率，建議原來用batchaddcard方法投放卡券的開發(fā)者改為采用wx.addcard 的方法在H5頁面拉起卡券，該方法拉起成功率更咼更加穩(wěn)疋n valid url doma in當前頁面域名未與 JS安全域名做綁定JSSDK投放in valid sig nature1. 確認簽名算法正確

7、，可用 bug/cgi-bin/sandbox?t=jsapisian 頁面工 具進行校驗。2. 確認 config 中 nonceStr (js 中駝峰標準大與 S) , timestamp 與用以簽名中的對應(yīng)non cestr,timestamp 一致。3. 確認url是頁面完整的url(請 在當前頁面alert(locatio n.href.split('#')O) 確認)，包括'http(s):/'部分， 以及'？后面的GET參數(shù)部分， 但不包括#hash后面的部 分。4. 確認 config中的appid與用 來獲取 jsapi_ticket

8、的 appid 一致。詳情查閱.WIKI JSSDK部分附錄5并開啟debug模式j(luò)ssdK投放5. 務(wù)必確認當前獲取的ticket是jsapi_ticket而不是卡券ticket，二者區(qū)別請見FAQ部分6. 確保一疋緩存access_token和 jsapi_ticket。7. 確保你獲取用來簽名的url是動態(tài)獲取的，動態(tài)頁面可參見 實例代碼中php的實現(xiàn)方式。 如果是html的靜態(tài)頁面在前 端通過ajax將url傳到后臺簽 名，前端需要用js獲取當前 頁面除去'#'hash部分的鏈接(可用 location.href.split('#')O 獲取，而且需要e

9、ncodeURIComponent),因為 頁面一旦分享，微信客戶端會 在你的鏈接末尾加入其它參 數(shù)，如果不是動態(tài)獲取當前鏈 接，將導致分享后的頁面簽名 失敗。頁面提示 the permission valueconfig沒有正確執(zhí)行，或者是調(diào)用的is offli ne verify ingJSAPI 沒有傳入 config 的 jsApiList 參數(shù)中。建議按如下順序檢查：1. 確認config正確通過。2. 如果是在頁面加載好時就調(diào)用 了 JSAPI，則必須寫在 wx.ready 的回調(diào)中。3. 確認 config 的 jsApiList 參 數(shù)包含了這個JSAPI。領(lǐng)取頁面提示 per

10、mission該公眾號沒有權(quán)限使用這個JSAPJ或denied者是調(diào)用的JSAPI沒有傳入config的jsApiList參數(shù)中(部分接口需要認證 之后才能使用)領(lǐng)取頁面提示未生效未設(shè)置領(lǐng)取用戶白名單通過白名單接口設(shè)置白名單領(lǐng)取頁面提示該卡券未經(jīng)制方 授權(quán)，不可領(lǐng)取 A商家的卡券違規(guī)在B商家公眾號 內(nèi)投放請按照規(guī)則投放，目前微信限 制在公眾號環(huán)境下只允許在制 券方公眾號內(nèi)投放該卡券（參 與卡券互通項目的除外）領(lǐng)取頁面提示參數(shù)錯誤 未設(shè)置用戶白名單自定義code超過20符 cardext中參數(shù)格式錯誤 導入code的卡券未填寫 get_custom_code_mode 字段領(lǐng)取頁面提示已領(lǐng)完（未

11、被領(lǐng) 取的卡券）sku設(shè)置數(shù)量過少指定openid 的卡券被非指定用戶領(lǐng)在不同 的卡券請求中生成了相同的nonce或者時間戳強烈建議仔細查看card_ext參 數(shù)說明并注意參數(shù)類型 按照要求進行傳遞參數(shù)（比如自定義code或者設(shè)定了 bind openid的開發(fā)者必須在 card_ext內(nèi)傳入相應(yīng)參數(shù)） 強烈建議開發(fā)者保證每一次添 力口的nonce禾口 timestamp不要重 復領(lǐng)取頁面提示簽名錯誤領(lǐng)取頁面提示簽名錯誤1.錯誤將card_ext（字符串）寫成object類 型（導致安卓可以領(lǐng)取，IOS簽名錯誤）2時間戳錯誤，比如用了多年后的時 間3.簽名內(nèi)參與的字段與 card_ext相應(yīng)字

12、 段未對齊，比如timestamp的值是否一 致，簽名中寫入 nonce_str 而card_ext 沒有強烈建議仔細查看card_ext參 數(shù)說明按照要求進行傳遞參數(shù)（比如自定義code或者設(shè)定了 bind_openid的開發(fā)者必須在 card ext內(nèi)傳入相應(yīng)參數(shù)）1.4卡券核銷In valid code核銷卡券無效codecode被用戶刪除code被轉(zhuǎn)贈后失效調(diào)用查詢code接口查看code是否為無效code，更換code后重試并確認code分配機制是否有缺陷JSAPI簽名錯誤，無法拉起卡當config未通過時，可以開啟 debug模式并參可以用JSAPI簽名券列表工具排錯考卡券投放中簽

13、名錯誤的萬式排查拉取適用門店列表卡券拉起的卡券列表為空卡券簽名錯誤：可以用卡券簽名debug工具可以用卡券簽名排除這種錯誤debug工具進行排篩選條件錯誤：請確認用戶卡包內(nèi)的卡券類型錯，另外需要特別和門店與篩選條件中的card_type 和shopid 一注意的是在簽名致，比如用戶只有團購券但是篩選條件card_type 沒有填入 groupon 則就無法拉到用戶的卡券Part2常見疑問Q1 :要投放一種“ 50元XX團購券”是否需要調(diào)用創(chuàng)建卡券接口生成很多card_id供用戶領(lǐng)取？A1 : cardd對應(yīng)了一類卡券，即“ 50元XX團購券”只用創(chuàng)建一個 cardd，在創(chuàng)建時需 要設(shè)置可被領(lǐng)取

14、的庫存，每位用戶領(lǐng)取到的是該card_id下的一個code。Q2 :調(diào)用刪除接口刪除某張card_id后調(diào)用查詢卡券接口仍能查到？A2 :刪除卡券后用戶無法再領(lǐng)取該ID的卡券，但已發(fā)被領(lǐng)取的卡券依舊有效，所以通過查詢接口仍可查詢到被刪的卡券。Q3 ： 創(chuàng)建卡券中 canshare 和 givebyfriend 字段的區(qū)別？A3 ：canshare 字段控制是否可以分享原生領(lǐng)取頁面， givebyfriend 控制是否能夠轉(zhuǎn)贈已領(lǐng) 取的卡券。Q4 ： 關(guān)于創(chuàng)建卡券接口 Color 字段：顏色值有哪些，是否可以不調(diào)接口，直接指定（金色 和銀色）？A4 ： 目前支持十種色值，可調(diào)用 1.4 獲取顏色

15、列表，后續(xù)會將顏色列表展示在 MP 平臺。Q5 ： custom_url: 商戶自定義 url 地址（非必填） ,如何定義，在這個接口定義這個參數(shù) 用途是什么？A5 ： url_name_type 、 custom_url 是組合使用的字段，用于支持商家功能的擴展，可在卡 券頁面內(nèi)設(shè)置自定義 cell ， url_name_type 定義名稱類型， custom_url 定義點擊后跳轉(zhuǎn)的 url 。Q6 ：關(guān)于推送卡券包信息通知接口，創(chuàng)建卡券審核通過后，是否微信自動發(fā)送？A6 ：審核通過后會有事件推送，再由商戶選擇投放方式，見 4.5.1 審核通過事件推送。Q7 ：領(lǐng)取卡券事件推送，是否只有當

16、用戶領(lǐng)取卡券才會推送，轉(zhuǎn)贈等其他操作是否推送。A7 ：轉(zhuǎn)贈被領(lǐng)取后，會推送領(lǐng)取人和贈送的 openid 以及該卡券的 code ，詳情見 4.5.2 領(lǐng) 取卡券事件推送。Q8 ：自定義 code 的長度限制和規(guī)則？A8 ：自定義 code 長度限制為 20 個字符以內(nèi)，為字符串格式。Q9 ：JSSDK 的簽名和卡券簽名有什么不同？在使用 JSSDK 拉起卡券列表、添加卡券或者打開卡券時，都會涉及兩個簽名的概念，一個是 JSSDK 的簽名 signature ，另一個是卡券的簽名 cardsign 。 Signature 的由 jsapi_ticket和相應(yīng)參數(shù)組成，而卡券 cardsign 則

17、由 api_ticket 和對應(yīng)參數(shù)組成。Jsapi_ticket 獲取地址： token=ACCESS TOKEN&type=jsapi簽名測試工具：http:/mp.weix in.q in/san dbox?t=jsapisig nApi_ticket獲取地址：https:/api.weix in bin/ticket/getticket?access_token=ACCESS_TOKEN& type=wx_card簽名測試工具： n/san dbox?t=cardsig nPart.3錯誤返回碼釋義返回碼說明常見錯誤-1系統(tǒng)繁忙，此時請開發(fā)者稍候再試。無權(quán)限或者頻繁調(diào)用

18、超過調(diào)用次數(shù)0請求成功OK40009圖片文件超長。40013不合法的Appid，請開發(fā)者檢查AppID的正確性，避免異常子符，注意大小與。40053不合法的actioninfo，請開發(fā)者確認參數(shù)正確。1. 確認請求鏈接是否正確2. 確認 action name 是否正確40071不合法的卡券類型。1. 卡券類型與結(jié)構(gòu)體名不一致2. 卡券類型與特有字段不對應(yīng)40072不合法的編碼方式。40078不合法的卡券狀態(tài)。卡券處于轉(zhuǎn)贈刪除或者失效狀態(tài)40079不合法的時間?？ㄈ吹接行?40080不合法的CardExt。1. card_ext缺乏關(guān)鍵必填參數(shù)2. card ext格式錯誤40099卡券已被核銷。4