查询商户资料

更新时间:2025.11.20

查询最新商户资料
接口限频:单商户号10次/分钟

接口说明

支持商户:【普通商户】

请求方式:【GET】/v3/aggracct-bc/wb-channel/account/mch_archives

请求域名:【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

     【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点 ,指引点击查看

请求参数

Header  HTTP头参数

 Authorization  必填 string

请参考签名认证生成认证信息


 Accept  必填 string

请设置为application/json


 Wechatpay-Serial  必填 string

【微信支付公钥ID】或【微信支付平台证书序列号】  请求参数中的敏感字段,需要使用微信支付公钥加密(推荐),请参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引;也可以使用微信支付平台证书公钥加密,参考获取平台证书序列号平台证书加密敏感信息指引


query  查询参数

 mchid  必填   string(32)

【微信支付商户号】 微信支付商户号


 bal_account_no  必填   string(1024)

【额度台账号】 【加密】额度台账号

请求示例

curl
Java
Go

GET

1curl -X GET \
2  https://api.mch.weixin.qq.com/v3/aggracct-bc/wb-channel/account/mch_archives?mchid=1900016681&bal_account_no=8609cb22e1774a50a930e414cc71eca06121bcd266335cda230d24a7886a8d9f \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Wechatpay-Serial: 5157F09EFDC096DE15EBE81A47057A7232F1B8E1"  
6

应答参数

200 OK

 mchid  必填   string

【微信支付商户号】 微信支付商户号


 bal_account_no  必填   string

【额度台账号】 【加密】额度台账号


 merchant_type  必填   string

【主体类型】 主体类型

  • 1-个体工商户

  • 2-企业


 merchant_id_type  必填   string

【主体证件类型】 主体证件类型

  • 12-营业执照


 merchant_name  必填   string

【主体证件登记名称】 【加密】主体证件登记名称


 merchant_id_no  必填   string

【主体证件号码】 【加密】主体证件号码


 effective_date  必填   string

【主体证件有效期起始日】 主体证件有效期起始日
日期格式:yyyy-MM-dd


 expire_date  必填   string

【主体证件有效期结束日】 主体证件有效期结束日
日期格式:yyyy-MM-dd 或 长期(9999-12-31


 merchant_img_front_id  必填   string

【主体证件正面影像ID】 主体证件正面影像ID(微众影像文件上传接口返回)


 register_address  必填   string

【主体注册地址】 主体注册地址


 business_scope  必填   string

【主体经营范围】 主体经营范围


 legal_representative  必填   object

【法定代表人信息】 法定代表人信息

属性

 beneficial_owner  必填   array[object]

【受益所有人信息列表】 受益所有人信息组(1-4组)

属性

应答示例

200 OK

1{
2  "mchid" : "1900016681",
3  "bal_account_no" : "8609cb22e1774a50a930e414cc71eca06121bcd266335cda230d24a7886a8d9f",
4  "merchant_type" : "2",
5  "merchant_id_type" : "12",
6  "merchant_name" : "江西米高文化传媒有限测试公司",
7  "merchant_id_no" : "91360735MA35RDY220",
8  "effective_date" : "2025-10-01",
9  "expire_date" : "9999-12-31",
10  "merchant_img_front_id" : "25102811A94212141615335094943740",
11  "register_address" : "江西省赣州市石城县琴江镇东南路山河馨城7-401室",
12  "business_scope" : "食品销售(仅销售预包装食品);保健食品(预包装)销售",
13  "legal_representative" : {
14    "legal_representative_id_type" : "01",
15    "legal_representative_name" : "张三",
16    "legal_representative_id_no" : "362137196601100023",
17    "legal_representative_effective_date" : "2000-10-01",
18    "legal_representative_expire_date" : "9999-12-31",
19    "legal_representative_img_front_id" : "25102811A94212141615335094943741",
20    "legal_representative_img_back_id" : "25102811A94212141615335094943742",
21    "legal_representative_address" : "江西省赣州市石城县琴江镇东南路山河馨城7-401室"
22  },
23  "beneficial_owner" : [
24    {
25      "beneficial_owner_no" : "1",
26      "beneficial_owner_id_type" : "01",
27      "beneficial_owner_name" : "李四",
28      "beneficial_owner_id_no" : "362137196601100023",
29      "beneficial_owner_effective_date" : "2000-01-01",
30      "beneficial_owner_expire_date" : "9999-12-31",
31      "beneficial_owner_img_front_id" : "25102811A94212141615335094943741",
32      "beneficial_owner_img_back_id" : "25102811A94212141615335094943741",
33      "beneficial_owner_address" : "江西省赣州市石城县琴江镇东南路山河馨城7-401室"
34    }
35  ]
36}
37

 

错误码

以下是本接口返回的错误码列表。详细错误码规则,请参考微信支付接口规则-错误码和错误提示

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

请根据错误提示正确传入参数

400

INVALID_REQUEST

HTTP 请求不符合微信支付 APIv3 接口规则

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

403

NO_AUTH

权限异常

请检查 a. 发起商户是否微众技术号商户;b. 参数mchid是否微众渠道聚合商户;c. 台账是否已注销;d. 参数mchid和bal_account_no是否匹配

429

FREQUENCY_LIMITED

频率超限

请降低请求接口频率

 

元宝AI
反馈
目录
置顶