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

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

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

3、錯(cuò)誤、未加指定參數(shù)等。Q4 :微信卡券的使用流程是什么呢?1.2卡券創(chuàng)建48001,api unauthorziedAPI無權(quán)限： 未申請開通卡券功能權(quán)限確認(rèn)使創(chuàng)建卡券返回提示未授權(quán)用的APPID是否開通卡券權(quán)限，另外仔細(xì)查看是不是用錯(cuò)了 appid查看生成的access_token 是否為開通卡券權(quán)限的appid生成的創(chuàng)建卡券可以直接粘貼Wiki上的示例47001,data format error時(shí)間類型字段填寫錯(cuò)誤：type 1或2僅支持填寫代碼請求一創(chuàng)建卡券返回提示格式錯(cuò)誤相應(yīng)專屬字段，詳情見文檔更新后的時(shí)間類型為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)建時(shí)提示字段缺失"errcode": 47001,缺失或者錯(cuò)誤填寫了必填參數(shù)，hint后面為缺少字段，請對照文檔必填字段要求進(jìn)行排查POST數(shù)據(jù)格式錯(cuò)誤，出錯(cuò)點(diǎn)在error before 之前,"errmsg": "data format error hin ts: Error before請對照文檔排查1.3卡券投放創(chuàng)建卡券二

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

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

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

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

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

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

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

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

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

14、的庫存，每位用戶領(lǐng)取到的是該card_id下的一個(gè)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)贈(zèng)已領(lǐng) 取的卡券。Q4 ： 關(guān)于創(chuàng)建卡券接口 Color 字段：顏色值有哪些，是否可以不調(diào)接口，直接指定（金色 和銀色）？A4 ： 目前支持十種色值，可調(diào)用 1.4 獲取顏色

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

16、用戶領(lǐng)取卡券才會(huì)推送，轉(zhuǎn)贈(zèng)等其他操作是否推送。A7 ：轉(zhuǎn)贈(zèng)被領(lǐng)取后，會(huì)推送領(lǐng)取人和贈(zèng)送的 openid 以及該卡券的 code ，詳情見 4.5.2 領(lǐng) 取卡券事件推送。Q8 ：自定義 code 的長度限制和規(guī)則？A8 ：自定義 code 長度限制為 20 個(gè)字符以內(nèi)，為字符串格式。Q9 ：JSSDK 的簽名和卡券簽名有什么不同？在使用 JSSDK 拉起卡券列表、添加卡券或者打開卡券時(shí)，都會(huì)涉及兩個(gè)簽名的概念，一個(gè)是 JSSDK 的簽名 signature ，另一個(gè)是卡券的簽名 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錯(cuò)誤返回碼釋義返回碼說明常見錯(cuò)誤-1系統(tǒng)繁忙，此時(shí)請開發(fā)者稍候再試。無權(quán)限或者頻繁調(diào)用

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