服务人员分配API

最新更新时间:2020.04.28 版本说明


用于服务商/商户开发者在顾客下单后为顾客分配服务人员使用。

注意:

• 调用服务人员分配接口需在完成支付之前,若分配服务人员晚于支付完成,则将无法在支付凭证上出现服务人员名片入口。

接口说明

适用对象:服务商 直连商户

请求URL:https://api.mch.weixin.qq.com/v3/smartguide/guides/{guide_id}/assign

请求方式:POST

接口规则:https://wechatpay-api.gitbook.io/wechatpay-api-v3


path 指该参数路径参数

query 指该参数需在请求URL传参

body 指该参数需在请求JSON传参


请求参数

参数名 变量 类型[长度限制] 必填 描述
服务人员ID guide_id string[1,32] path 服务人员在服务人员系统中的唯一标识
示例值:LLA3WJ6DSZUfiaZDS79FH5Wm5m4X69TBic
子商户ID sub_mchid string[1,32] body 服务人员所属商户的商户ID
(如果是直连商户/普通特约商户自己调用接口,不传即可;如果是服务商帮普通特约商户调用接口,传普通特约商户的商户号)
示例值:1234567890
商户订单号 out_trade_no string[1,32] body 商户系统内部订单号,要求32个字符内,仅支持使用字母、数字、中划线-、下划线_、竖线|、星号*这些英文半角字符的组合,请勿使用汉字或全角等特殊字符,且在同一个商户号下唯一。
示例值:20150806125346

请求示例


{
  "out_trade_no" : "20150806125346",
  "sub_mchid" : "1234567890"
}
    
{
JAVA示例代码
}
    

返回参数


处理成功,应答无内容

返回示例


204
处理成功,应答无内容
                                

{
"return_code": "INVALID_REQUEST",
"return_msg": "mch punished",
}
                                

错误码公共错误码

状态码 错误码 描述 解决方案
400 PARAM_ERROR 必填参数为空 根据错误提示,传入正确参数
服务人员ID格式错误 根据错误提示,传入正确参数
商户订单号格式错误 根据错误提示,传入正确参数
商户订单号过长 根据错误提示,传入正确参数
服务人员ID为空 根据错误提示,传入正确参数
商户订单号为空 根据错误提示,传入正确参数
400 MCH_NOT_EXISTS 商户号格式错误 请确认商户号是否有误
子商户号格式错误 请确认商户号是否有误
子商户号为空 请填写子商户号
400 INVALID_REQUEST 子商户未授权 子商户未授权,请联系子商户授权
子商户产品权限未开通 子商户产品权限未开通,请联系子商户开通
500 SYSTEM_ERROR 系统错误 请使用相同参数稍后重新调用
扩展父子商户票据错误 请使用相同参数稍后重新调用
调用云函数错误 请使用相同参数稍后重新调用

版本说明

关闭
V1.0
2020年04月28日
1. 服务人员分配接口上线

技术咨询

反馈有奖