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