根据业务申请编号查询申请状态

更新时间:2025.10.17

接口适用场景:当服务商提交申请单后,需要定期调用此接口查询申请单的审核状态。

接口说明

支持商户:【普通服务商】

请求方式:【GET】/v3/brand/applyments/business-code/{business_code}

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

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

请求参数

Header  HTTP头参数

 Authorization  必填 string

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


 Accept  必填 string

请设置为application/json


path  路径参数

 business_code  必填   string(128)

【业务申请编号】 1、只能由数字、字母或下划线组成;
2、服务商自定义的商户唯一编号;
3、每个编号对应一个申请单;
4、填写调用提交入驻申请时传递的业务申请编号。

请求示例

curl
Java
Go

GET

1curl -X GET \
2  https://api.mch.weixin.qq.com/v3/brand/applyments/business-code/1900013511_10000 \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" 
5

应答参数

200 OK

 applyment_id  必填   string(20)

【微信支付申请单号】 1、申请单的唯一标识,由微信支付生成;
2、数字,不超过 20 个字符。


 business_code  必填   string(128)

【业务申请编号】 1、只能由数字、字母或下划线组成;
2、服务商自定义的商户唯一编号;
3、每个编号对应一个申请单。


 applyment_state  必填   string

【申请状态】 申请当前所处的审核或处理状态,如审核中、审核通过、已驳回等

可选取值

  • APPLYMENT_STATE_UNKNOWN:  「未知状态,非终态」提交申请发生错误导致,请尝试使用相同的业务申请编号重新提交

  • APPLYMENT_STATE_UNSUBMITTED:  「申请未提交,非终态」提交资料需修改,请修改后尝试使用相同的业务申请编号重新提交

  • APPLYMENT_STATE_WAITING_VALIDATE:  「待主体意愿确认,非终态」申请提交后主体意愿确认中

  • APPLYMENT_STATE_WAITING_AUDIT:  「资料审核中,非终态」主体意愿确认完成,资料审核中

  • APPLYMENT_STATE_WAITING_AUTH:  「待授权确认,非终态」请经营管理员使用微信打开返回的“授权链接”,根据页面指引完成授权确认

  • APPLYMENT_STATE_OPEN_ACCOUNT:  「开号中,非终态」系统开通相关权限中,请耐心等待

  • APPLYMENT_STATE_FINISH:  「入驻完成,终态」所有入驻流程均已完成,包括品牌开号、服务商授权等步骤

  • APPLYMENT_STATE_AUDIT_REJECTED:  「审核驳回,非终态」申请单已被驳回,请按照驳回原因修改申请资料,使用相同的业务申请编号重新提交

  • APPLYMENT_STATE_CANCELED:  「申请撤销,终态」入驻申请已被撤销


 applyment_state_desc  必填   string(20)

【申请状态说明】 1、对申请状态的进一步说明;
2、长度不超过20个字符。


 authorization_confirmation_qr_code  选填   string(256)

【授权确认二维码链接】 注册品牌需管理员扫码检查申请信息,并授权确认。
1、当申请状态为 待主体意愿确认、资料审核中、待授权确认 时才返回;
2、建议将链接转为二维码展示,使用申请单填写的管理员微信进行扫码;
3、确认流程包含检查品牌注册信息、协议签署、服务商授权等,若管理员不是企业法人则需进行主体意愿确认。


 reject_reason  选填   string(256)

【驳回原因】 1、当申请状态是「审核驳回」时返回,此处展示具体的驳回原因,便于申请人修改后重新提交;
2、长度不超过50个字符。


 brand_id  选填   string(20)

【品牌ID】 1、当申请状态是「入驻完成」时返回,作为品牌唯一标识符,用于后续查询或管理品牌信息;
2、数字,长度不超过 20 个字符。

应答示例

200 OK

1{
2  "applyment_id" : "111111111",
3  "business_code" : "1900013511_10000",
4  "applyment_state" : "APPLYMENT_STATE_WAITING_AUTH",
5  "applyment_state_desc" : "待授权确认",
6  "authorization_confirmation_qr_code" : "https://pay.weixin.qq.com/xdc/partnerapply4brandweb/get-auth-code?applyId=200000212476&sign=b207b673049a32c858f3aabd7d27c7ec",
7  "reject_reason" : "具体驳回原因xxx",
8  "brand_id" : "123455667"
9}
10

 

错误码

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

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

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

400

INVALID_REQUEST

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

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

403

NO_AUTH

商户权限异常

请确认是否已经开通相关权限

404

RESOURCE_NOT_EXISTS

申请单不存在

确认入参,传入正确的申请单编号

429

RATELIMIT_EXCEEDED

频率限制

请降低调用频率

 

元宝AI
反馈
目录
置顶