最新更新時間:2020.04.28 版本說明
用于服務(wù)商/商戶開發(fā)者在顧客下單后為顧客分配服務(wù)人員使用。
? 調(diào)用服務(wù)人員分配接口需在完成支付之前,若分配服務(wù)人員晚于支付完成,則將無法在支付憑證上出現(xiàn)服務(wù)人員名片入口。
適用對象:服務(wù)商 直連商戶
請求URL:https://api.mch.weixin.qq.com/v3/smartguide/guides/{guide_id}/assign
請求方式:POST
接口規(guī)則:http://www.tg885.com/wiki/doc/apiv3/wechatpay/wechatpay-1.shtml
path 指該參數(shù)路徑參數(shù)
query 指該參數(shù)需在請求URL傳參
body 指該參數(shù)需在請求JSON傳參
參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
---|---|---|---|---|
服務(wù)人員ID | guide_id | string[1,32] | 是 | path 服務(wù)人員在服務(wù)人員系統(tǒng)中的唯一標(biāo)識 示例值:LLA3WJ6DSZUfiaZDS79FH5Wm5m4X69TBic |
子商戶ID | sub_mchid | string[1,32] | 否 | body 服務(wù)人員所屬商戶的商戶ID (如果是直連商戶/普通特約商戶自己調(diào)用接口,不傳即可;如果是服務(wù)商幫普通特約商戶調(diào)用接口,傳普通特約商戶的商戶號) 示例值:1234567890 |
商戶訂單號 | out_trade_no | string[1,32] | 是 | body 商戶系統(tǒng)內(nèi)部訂單號,要求32個字符內(nèi),僅支持使用字母、數(shù)字、中劃線-、下劃線_、豎線|、星號*這些英文半角字符的組合,請勿使用漢字或全角等特殊字符,且在同一個商戶號下唯一。 示例值:20150806125346 |
{
"out_trade_no" : "20150806125346",
"sub_mchid" : "1234567890"
}
狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
---|---|---|---|
400 | PARAM_ERROR | 必填參數(shù)為空 | 根據(jù)錯誤提示,傳入正確參數(shù) |
服務(wù)人員ID格式錯誤 | 根據(jù)錯誤提示,傳入正確參數(shù) | ||
商戶訂單號格式錯誤 | 根據(jù)錯誤提示,傳入正確參數(shù) | ||
商戶訂單號過長 | 根據(jù)錯誤提示,傳入正確參數(shù) | ||
服務(wù)人員ID為空 | 根據(jù)錯誤提示,傳入正確參數(shù) | ||
商戶訂單號為空 | 根據(jù)錯誤提示,傳入正確參數(shù) | ||
400 | MCH_NOT_EXISTS | 商戶號格式錯誤 | 請確認商戶號是否有誤 |
子商戶號格式錯誤 | 請確認商戶號是否有誤 | ||
子商戶號為空 | 請?zhí)顚懽由虘籼? | ||
400 | INVALID_REQUEST | 子商戶未授權(quán) | 子商戶未授權(quán),請聯(lián)系子商戶授權(quán) |
子商戶產(chǎn)品權(quán)限未開通 | 子商戶產(chǎn)品權(quán)限未開通,請聯(lián)系子商戶開通 | ||
500 | SYSTEM_ERROR | 系統(tǒng)錯誤 | 請使用相同參數(shù)稍后重新調(diào)用 |
擴展父子商戶票據(jù)錯誤 | 請使用相同參數(shù)稍后重新調(diào)用 | ||
調(diào)用云函數(shù)錯誤 | 請使用相同參數(shù)稍后重新調(diào)用 |