用于為商戶注冊服務(wù)人員使用。
注意：
- 調(diào)用接口前商家需完成支付即服務(wù)產(chǎn)品的開通和設(shè)置 (opens new window)。若服務(wù)商為特約商戶調(diào)用接口，需在特約商戶開通并完成產(chǎn)品設(shè)置后，與特約商戶建立產(chǎn)品授權(quán)關(guān)系。
# 接口說明
支持商戶：
【普通商戶】
請求方式：
【POST】/v3/smartguide/guides
請求域名：
【主域名】
https://api.mch.weixin.qq.com
使用該域名將訪問就近的接入點【備域名】
https://api2.mch.weixin.qq.com
使用該域名將訪問異地的接入點 ，指引點擊查看
# 請求參數(shù)
Header HTTP頭參數(shù)
- corpid 必填 string【企業(yè)ID】 商戶的企業(yè)微信唯一標識
- store_id 必填 integer【門店ID】 門店在微信支付商戶平臺的唯一標識
- userid 必填 string(64)【企業(yè)微信的員工ID】 員工在商戶企業(yè)微信通訊錄使用的唯一標識
- name 必填 string【企業(yè)微信的員工姓名】 員工在商戶企業(yè)微信通訊錄上的姓名,需使用微信支付平臺公鑰加密
- mobile 必填 string【手機號碼】 員工在商戶企業(yè)微信通訊錄上設(shè)置的手機號碼，使用微信支付平臺公鑰加密
- qr_code 必填 string(1024)【員工個人二維碼URL】 員工在商戶企業(yè)微信通訊錄上的二維碼串
- avatar 必填 string(1024)【頭像URL】 員工在商戶企業(yè)微信通訊錄上頭像的URL
- group_qrcode 選填 string(1024)【群二維碼URL】 員工所在的企業(yè)微信群的“群活碼”二維碼
Body 包體參數(shù)
請求示例
POST
# 應(yīng)答參數(shù)
- guide_id 必填 string(64)【服務(wù)人員ID】 導購在導購系統(tǒng)中的唯一標識
200OK
應(yīng)答示例
200 OK
# 錯誤碼
# 公共錯誤碼
| 狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 400 | PARAM_ERROR | 參數(shù)錯誤 | 請根據(jù)錯誤提示正確傳入?yún)?shù) |
| 400 | INVALID_REQUEST | HTTP 請求不符合微信支付 APIv3 接口規(guī)則 | 請參閱 接口規(guī)則 |
| 401 | SIGN_ERROR | 驗證不通過 | 請參閱 簽名常見問題 |
| 500 | SYSTEM_ERROR | 系統(tǒng)異常，請稍后重試 | 請稍后重試 |
# 業(yè)務(wù)錯誤碼
| 狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 400 | MCH_NOT_EXISTS | 商戶號格式錯誤 | 請確認商戶號是否有誤 |
| 400 | PARAM_ERROR | 必填參數(shù)為空 | 根據(jù)錯誤提示，傳入正確參數(shù) |
| 400 | PARAM_ERROR | corpid格式錯誤 | 根據(jù)錯誤提示，傳入正確參數(shù) |
| 400 | PARAM_ERROR | 門店ID格式錯誤 | 根據(jù)錯誤提示，傳入正確參數(shù) |
| 400 | PARAM_ERROR | userid格式錯誤 | 根據(jù)錯誤提示，傳入正確參數(shù) |
| 400 | PARAM_ERROR | 服務(wù)人員姓名格式錯誤 | 根據(jù)錯誤提示，傳入正確參數(shù) |
| 400 | PARAM_ERROR | 服務(wù)人員姓名過長 | 根據(jù)錯誤提示，傳入正確參數(shù) |
| 400 | PARAM_ERROR | 手機號碼格式錯誤 | 根據(jù)錯誤提示，傳入正確參數(shù) |
| 400 | PARAM_ERROR | 二維碼鏈接格式錯誤 | 根據(jù)錯誤提示，傳入正確參數(shù) |
| 400 | PARAM_ERROR | 頭像URL不是合法鏈接 | 根據(jù)錯誤提示，傳入正確參數(shù) |
| 400 | PARAM_ERROR | 非企業(yè)微信提供的頭像URL | 根據(jù)錯誤提示，傳入正確參數(shù) |
| 400 | PARAM_ERROR | corpid為空 | 請?zhí)顚慶orpid |
| 400 | PARAM_ERROR | 門店ID為空 | 請?zhí)顚戦T店ID |
| 400 | PARAM_ERROR | userid為空 | 請?zhí)顚憉serid |
| 400 | PARAM_ERROR | 服務(wù)人員姓名為空 | 請?zhí)顚懛?wù)人員姓名 |
| 400 | PARAM_ERROR | 手機號碼為空 | 請?zhí)顚懛?wù)人員手機號 |
| 400 | PARAM_ERROR | 二維碼鏈接為空 | 請?zhí)顚懛?wù)人員二維碼鏈接 |
| 400 | PARAM_ERROR | 頭像URL為空 | 請?zhí)顚戭^像URL |
| 400 | PARAM_ERROR | 服務(wù)人員已注冊 | 請檢查該服務(wù)人員是否之前有注冊過 |
| 400 | PARAM_ERROR | 群二維碼URL格式錯誤 | 根據(jù)錯誤提示，傳入正確參數(shù) |
| 500 | SYSTEM_ERROR | 系統(tǒng)錯誤 | 請使用相同參數(shù)稍后重新調(diào)用 |
| 500 | SYSTEM_ERROR | 系統(tǒng)添加GUIDE失敗 | 請使用相同參數(shù)稍后重新調(diào)用 |
| 500 | SYSTEM_ERROR | 擴展父子商戶票據(jù)錯誤 | 請使用相同參數(shù)稍后重新調(diào)用 |
| 500 | SYSTEM_ERROR | 調(diào)用云函數(shù)錯誤 | 請使用相同參數(shù)稍后重新調(diào)用 |
