收款商户号管理查询商户号详情

POST

/cgi-bin/externalpay/getmerchant

通过该接口可以查询已绑定商户号信息以及商户号使用范围

权限说明：只允许对外收款应用的接口凭证调用该接口

文档ID: 24953
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/93666

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'https://qyapi.weixin.qq.com/cgi-bin/externalpay/getmerchant?access_token=' \
--header 'Content-Type: application/json' \
--data-raw '{"mch_id":"12334"}'

响应示例

{
    "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
        ]
    }
}

请求参数

Query 参数

access_token

调用接口凭证

必需

示例值:

Body 参数application/json

mch_id

string

必需

微信支付商户号,不超过32字节

示例

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

返回码

可选

bind_status

integer <int32>

可选

商户号绑定状态。 1:申请中 2:已绑定 3:已撤销

allow_use_scope

object

可选

该商户号使用范围，仅当商户号已绑定时才返回

tagid

array[integer <int32>]

可选

使用范围内的标签id列表

partyid

array[integer <int32>]

可选

使用范围内的部门id列表

user

array[string]

可选

使用范围内的企业用户id列表

errmsg

string

可选

对返回码的文本描述内容

merchant_name

string

可选

微信支付商户号全称，不超过50字节

mch_id

string

可选

微信支付商户号,不超过32字节

修改于 2022-01-14 04:25:44

收款商户号管理新增商户号

收款商户号管理删除商户号

收款商户号管理 查询商户号详情

请求参数

返回响应

收款商户号管理查询商户号详情