最新更新時(shí)間:2020.09.15 版本說明
用于商戶開發(fā)者為商戶注冊(cè)服務(wù)人員使用。
? 調(diào)用接口前商家需完成支付即服務(wù)產(chǎn)品的開通和設(shè)置。若服務(wù)商為特約商戶調(diào)用接口,需在特約商戶開通并完成產(chǎn)品設(shè)置后,與特約商戶建立產(chǎn)品授權(quán)關(guān)系。
適用對(duì)象: 直連商戶
請(qǐng)求URL:https://api.mch.weixin.qq.com/v3/smartguide/guides
請(qǐng)求方式:POST
path 指該參數(shù)路徑參數(shù)
query 指該參數(shù)需在請(qǐng)求URL傳參
body 指該參數(shù)需在請(qǐng)求JSON傳參
參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
---|---|---|---|---|
企業(yè)ID | corpid | string[1,32] | 是 | body 商戶的企業(yè)微信唯一標(biāo)識(shí) 示例值:1234567890 |
門店ID | store_id | int | 是 | body 門店在微信支付商戶平臺(tái)的唯一標(biāo)識(shí) (查找路徑:登錄商戶平臺(tái)—>營銷中心—>門店管理,若無門店則需先創(chuàng)建門店) 示例值:12345678 |
企業(yè)微信的員工ID | userid | string[1,64] | 是 | body 員工在商戶企業(yè)微信通訊錄使用的唯一標(biāo)識(shí) (企業(yè)微信的員工信息可通過接口從企業(yè)微信通訊錄獲取,具體請(qǐng)參考企業(yè)微信的API文檔 ) 示例值:robert |
企業(yè)微信的員工姓名 | name | string[1,512] | 是 | body 員工在商戶企業(yè)微信通訊錄上的姓名,需使用微信支付平臺(tái)公鑰加密 該字段需進(jìn)行加密處理,加密方法詳見敏感信息加密說明。 特殊規(guī)則:加密前字段長度限制為64個(gè)字節(jié) 示例值:pVd1HJ6v/69bDnuC4EL5Kz4jBHLiCa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg== |
手機(jī)號(hào)碼 | mobile | string[5,512] | 是 | 員工在商戶企業(yè)微信通訊錄上設(shè)置的手機(jī)號(hào)碼,使用微信支付平臺(tái)公鑰加密 該字段需進(jìn)行加密處理,加密方法詳見敏感信息加密說明。 特殊規(guī)則:加密前字段長度限制為32個(gè)字節(jié) 示例值:pVd1HJ6v/69bDnuC4EL5Kz4jBHLiCa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg== |
員工個(gè)人二維碼 | qr_code | string[1,256] | 是 | body 員工在商戶企業(yè)微信通訊錄上的二維碼串 示例值:https://open.work.weixin.qq.com/wwopen/userQRCode?vcode=xxx |
頭像URL | avatar | string[1,256] | 是 | body 員工在商戶企業(yè)微信通訊錄上頭像的URL 示例值:http://wx.qlogo.cn/mmopen/ajNVdqHZLLA3WJ6DSZUfiakYe37PKnQhBIeOQBO4czqrnZDS79FH5Wm5m4X69TBicnHFlhiafvDwklOpZeXYQQ2icg/0 |
群二維碼URL | group_qrcode | string[1,256] | 否 | body 員工所在門店在企業(yè)微信配置的群活碼的URL(可通過企業(yè)微信“獲取客戶群進(jìn)群方式API”獲取,請(qǐng)登錄企業(yè)微信后查看API文檔,若無查看權(quán)限可通過問卷提交需求 ) 示例值:http://p.qpic.cn/wwhead/nMl9ssowtibVGyrmvBiaibzDtp/0 |
{
"store_id" : 1234,
"corpid" : "1234567890",
"name" : "pVd1HJ6v/69bDnuC4EL5Kz4jBHLiCa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
"mobile" : "pVd1HJ6v/69bDnuC4EL5Kz4jBHLiCa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
"qr_code" : "https://open.work.weixin.qq.com/wwopen/userQRCode?vcode=xxx",
"avatar" : "http://wx.qlogo.cn/mmopen/ajNVdqHZLLA3WJ6DSZUfiakYe37PKnQhBIeOQBO4czqrnZDS79FH5Wm5m4X69TBicnHFlhiafvDwklOpZeXYQQ2icg/0",
"group_qrcode" : "http://p.qpic.cn/wwhead/nMl9ssowtibVGyrmvBiaibzDtp/0",
"userid" : "robert"
}
參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
---|---|---|---|---|
服務(wù)人員ID | guide_id | string[1,32] | 是 | 服務(wù)人員在服務(wù)人員系統(tǒng)中的唯一標(biāo)識(shí) 示例值:LLA3WJ6DSZUfiaZDS79FH5Wm5m4X69TBic |
{
"guide_id" : "LLA3WJ6DSZUfiaZDS79FH5Wm5m4X69TBic"
}
狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
---|---|---|---|
400 | PARAM_ERROR | 必填參數(shù)為空 | 根據(jù)錯(cuò)誤提示,傳入正確參數(shù) |
corpid格式錯(cuò)誤 | 根據(jù)錯(cuò)誤提示,傳入正確參數(shù) | ||
門店ID格式錯(cuò)誤 | 根據(jù)錯(cuò)誤提示,傳入正確參數(shù) | ||
userid格式錯(cuò)誤 | 根據(jù)錯(cuò)誤提示,傳入正確參數(shù) | ||
服務(wù)人員姓名格式錯(cuò)誤 | 根據(jù)錯(cuò)誤提示,傳入正確參數(shù) | ||
服務(wù)人員姓名過長 | 根據(jù)錯(cuò)誤提示,傳入正確參數(shù) | ||
手機(jī)號(hào)碼格式錯(cuò)誤 | 根據(jù)錯(cuò)誤提示,傳入正確參數(shù) | ||
二維碼鏈接格式錯(cuò)誤 | 根據(jù)錯(cuò)誤提示,傳入正確參數(shù) | ||
頭像URL不是合法鏈接 | 根據(jù)錯(cuò)誤提示,傳入正確參數(shù) | ||
非企業(yè)微信提供的頭像URL | 根據(jù)錯(cuò)誤提示,傳入正確參數(shù) | ||
corpid為空 | 請(qǐng)?zhí)顚慶orpid | ||
門店ID為空 | 請(qǐng)?zhí)顚戦T店id | ||
userid為空 | 請(qǐng)?zhí)顚憉serid | ||
服務(wù)人員姓名為空 | 請(qǐng)?zhí)顚懛?wù)人員姓名 | ||
手機(jī)號(hào)碼為空 | 請(qǐng)?zhí)顚懛?wù)人員手機(jī)號(hào) | ||
二維碼鏈接為空 | 請(qǐng)?zhí)顚懛?wù)人員二維碼鏈接 | ||
頭像URL為空 | 請(qǐng)?zhí)顚戭^像url | ||
服務(wù)人員已注冊(cè) | 請(qǐng)檢查該服務(wù)人員是否之前有注冊(cè)過 | ||
群二維碼URL格式錯(cuò)誤 | 根據(jù)錯(cuò)誤提示,傳入正確參數(shù) | ||
400 | MCH_NOT_EXISTS | 商戶號(hào)格式錯(cuò)誤 | 請(qǐng)確認(rèn)商戶號(hào)是否有誤 |
500 | SYSTEM_ERROR | 系統(tǒng)錯(cuò)誤 | 請(qǐng)使用相同參數(shù)稍后重新調(diào)用 |
系統(tǒng)添加GUIDE失敗 | 請(qǐng)使用相同參數(shù)稍后重新調(diào)用 | ||
擴(kuò)展父子商戶票據(jù)錯(cuò)誤 | 請(qǐng)使用相同參數(shù)稍后重新調(diào)用 | ||
調(diào)用云函數(shù)錯(cuò)誤 | 請(qǐng)使用相同參數(shù)稍后重新調(diào)用 |