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

更新时间：2024.11.18

服务商（银行、支付机构、电商平台不可用）查询商家入驻申请单的状态

接口说明

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

请求方式：【GET】/v3/applyment4sub/applyment/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

【业务申请编号】1、只能由数字、字母或下划线组成，建议前缀为服务商商户号。
2、服务商自定义的唯一编号。
3、每个编号对应一个申请单，每个申请单审核通过后生成一个微信支付商户号。
4、若申请单被驳回，可填写相同的“业务申请编号”，即可覆盖修改原申请单信息。

请求示例

GET

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

应答参数

200 OK

business_code 　选填 string

applyment_id 　选填 integer

【微信支付申请单号】微信支付分配的申请单号

sub_mchid 　选填 string

【特约商户号】当申请单状态为APPLYMENT_STATE_FINISHED或APPLYMENT_STATE_TO_BE_SIGNED时才返回。

sign_url 　选填 string

【超级管理员签约链接】1、超级管理员用微信扫码，关注“微信支付商家助手”公众号后，公众号将自动发送签约消息；超管需点击消息，根据指引完成核对联系信息、账户验证、签约等操作。
2、超管完成核对联系信息，后续申请单进度可通过公众号自动通知超级管理员。

applyment_state 　必填 string

【申请单状态】

可选取值：：

APPLYMENT_STATE_EDITTING（编辑中）: 提交申请发生错误导致，请尝试重新提交。
APPLYMENT_STATE_AUDITING（审核中）: 申请单正在审核中，超级管理员用微信打开“签约链接”，完成绑定微信号后，申请单进度将通过微信公众号通知超级管理员，引导完成后续步骤。
APPLYMENT_STATE_REJECTED（已驳回）: 请按照驳回原因修改申请资料，超级管理员用微信打开“签约链接”，完成绑定微信号，后续申请单进度将通过微信公众号通知超级管理员。
APPLYMENT_STATE_TO_BE_CONFIRMED（待账户验证）: 请超级管理员使用微信打开返回的“签约链接”，根据页面指引完成账户验证。
APPLYMENT_STATE_TO_BE_SIGNED（待签约）: 请超级管理员使用微信打开返回的“签约链接”，根据页面指引完成签约。
APPLYMENT_STATE_SIGNING（开通权限中）: 系统开通相关权限中，请耐心等待。
APPLYMENT_STATE_FINISHED（已完成）: 商户入驻申请已完成。
APPLYMENT_STATE_CANCELED（已作废）: 申请单已被撤销。

applyment_state_msg 　选填 string

【申请状态描述】申请状态描述

audit_detail 　选填 array[object]

【驳回原因详情】各项资料的审核情况。当申请状态为APPLYMENT_STATE_REJECTED时才返回。

属性

应答示例

200 OK

1{
2  "business_code" : "1900013511_10000",
3  "applyment_id" : 2000002124775691,
4  "sub_mchid" : "1234567890",
5  "sign_url" : "https://pay.weixin.qq.com/public/apply4ec_sign/s?applymentId=2000002126198476&sign=b207b673049a32c858f3aabd7d27c7ec",
6  "applyment_state" : "APPLYMENT_STATE_EDITTING",
7  "applyment_state_msg" : "审核中",
8  "audit_detail" : [
9    {
10      "field" : "id_card_copy",
11      "field_name" : "身份证复印件",
12      "reject_reason" : "身份证背面识别失败，请上传更清晰的身份证图片。"
13    }
14  ]
15}
16

错误码

公共错误码

状态码	错误码	描述	解决方案
400	PARAM_ERROR	参数错误	请根据错误提示正确传入参数
400	INVALID_REQUEST	HTTP 请求不符合微信支付 APIv3 接口规则	请参阅接口规则
401	SIGN_ERROR	验证不通过	请参阅签名常见问题
500	SYSTEM_ERROR	系统异常，请稍后重试	请稍后重试

业务错误码

状态码	错误码	描述	解决方案
400	APPLYMENT_NOT_EXIST	申请单不存在	确认入参，传入正确的申请单编号
403	NO_AUTH	商户权限异常	请确认是否已经开通相关权限
400	PROCESSING	存在流程进行中的申请单，请检查是否重入	可通过查询申请单状态查看此申请单的申请状态，或更换out_request_no提交新的申请单
403	RATE_LIMITED	频率限制	请降低调用频率

文档是否有帮助

更多支持

开发文档(商户)开发文档(V2版)开发者社区微信开放平台微信公众平台腾讯客服