目录
第三方应用暂不支持商户号管理
使用该接口时需要开通对外收款能力并绑定第一个商户号。(说明:第一个商户号的绑定需要由企业管理员手动绑定,绑定入口在:手机端工作台-对外收款,或管理后台-应用管理-对外收款-启用)
通过该接口可以导入其他商户号,同一个企业最多绑定5000个商户号。
请求方式:POST(HTTPS)
请求地址:https://qyapi.weixin.qq.com/cgi-bin/externalpay/addmerchant?access_token=ACCESS_TOKEN
请求示例:
{
"mch_id":"12334",
"merchant_name":"xxx"
}
参数说明:
参数 | 必须 | 说明 |
---|---|---|
mch_id | 是 | 微信支付商户号,不超过32字节 |
merchant_name | 是 | 微信支付商户号全称,不超过50字节 |
权限说明:
只允许对外收款应用的接口凭证调用该接口
返回结果:
{
"errcode":0,
"errmsg":"ok"
}
参数说明:
参数 | 说明 |
---|---|
errcode | 返回码 |
errmsg | 对返回码的文本描述内容 |
通过该接口可以查询已绑定商户号信息以及商户号使用范围
请求方式:POST(HTTPS)
请求地址:https://qyapi.weixin.qq.com/cgi-bin/externalpay/getmerchant?access_token=ACCESS_TOKEN
请求示例:
{
"mch_id":"12334",
}
参数说明:
参数 | 必须 | 说明 |
---|---|---|
mch_id | 是 | 微信支付商户号,不超过32字节 |
权限说明:
只允许对外收款应用的接口凭证调用该接口
返回结果:
{
"errcode":0,
"errmsg":"ok",
"bind_status"0,
"mch_id":"12334",
"merchant_name":"test",
"allow_use_scope": {
"user": ["zhangsan","lisi"],
"partyid": [1],
"tagid": [1,2,3]
}
}
参数说明:
参数 | 说明 |
---|---|
errcode | 返回码 |
errmsg | 对返回码的文本描述内容 |
mch_id | 微信支付商户号,不超过32字节 |
merchant_name | 微信支付商户号全称,不超过50字节 |
bind_status | 商户号绑定状态。 1:申请中 2:已绑定 3:已撤销 |
allow_use_scope | 该商户号使用范围,仅当商户号已绑定时才返回 |
allow_use_scope.user | 使用范围内的企业用户id列表 |
allow_use_scope.partyid | 使用范围内的部门id列表 |
allow_use_scope.tagid | 使用范围内的标签id列表 |
通过该接口可以删除未绑定的商户号
请求方式:POST(HTTPS)
请求地址:https://qyapi.weixin.qq.com/cgi-bin/externalpay/delmerchant?access_token=ACCESS_TOKEN
请求示例:
{
"mch_id":"12334",
}
参数说明:
参数 | 必须 | 说明 |
---|---|---|
mch_id | 是 | 微信支付商户号,不超过32字节 |
权限说明:
只允许对外收款应用的接口凭证调用该接口
返回结果:
{
"errcode":0,
"errmsg":"ok"
}
参数说明:
参数 | 说明 |
---|---|
errcode | 返回码 |
errmsg | 对返回码的文本描述内容 |
通过该接口可以设置已绑定商户号的使用范围
请求方式:POST(HTTPS)
请求地址:https://qyapi.weixin.qq.com/cgi-bin/externalpay/set_mch_use_scope?access_token=ACCESS_TOKEN
请求示例:
{
"mch_id":"12334",
"allow_use_scope": {
"user": ["zhangsan","lisi"],
"partyid": [1],
"tagid": [1,2,3]
}
}
参数说明:
参数 | 必须 | 说明 |
---|---|---|
mch_id | 是 | 微信支付商户号,不超过32字节 |
allow_use_scope | 是 | 该商户号使用范围,支持按成员、部门或标签设置。 |
allow_use_scope.user | 否 | 使用范围内的企业用户id列表 |
allow_use_scope.partyid | 否 | 使用范围内的部门id列表 |
allow_use_scope.tagid | 否 | 使用范围内的标签id列表 |
权限说明:
只允许对外收款应用的接口凭证调用该接口
返回结果:
{
"errcode":0,
"errmsg":"ok"
}
参数说明:
参数 | 说明 |
---|---|
errcode | 返回码 |
errmsg | 对返回码的文本描述内容 |