企业内部开发 服务端API 企业支付 对外收款 收款商户号管理
收款商户号管理

目录

  • 新增商户号
  • 查询商户号详情
  • 删除商户号
  • 设置商户号使用范围
  • 第三方应用暂不支持商户号管理

    新增商户号

    使用该接口时需要开通对外收款能力并绑定第一个商户号。(说明:第一个商户号的绑定需要由企业管理员手动绑定,绑定入口在:手机端工作台-对外收款,或管理后台-应用管理-对外收款-启用)
    通过该接口可以导入其他商户号,同一个企业最多绑定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对返回码的文本描述内容
    上一篇
    概述
    下一篇
    获取对外收款记录