通过申请单ID查询申请状态

更新时间：2024.11.28

接口适用场景：电商平台通过查询申请状态API查询二级商户入驻申请结果。

接口说明

支持商户：【平台商户】

请求方式：【GET】/v3/ecommerce/applyments/{applyment_id}

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

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

请求参数

Header HTTP头参数

Authorization 　必填　string

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

Accept 　必填　string

请设置为application/json

path 路径参数

applyment_id 　必填 integer

【微信支付申请单号】申请单的主键，唯一定义此资源的标识。

请求示例

GET

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

应答参数

200 OK

applyment_state 　必填 string(32)

【申请状态】枚举值：
CHECKING：资料校验中
ACCOUNT_NEED_VERIFY：待账户验证
AUDITING：审核中
REJECTED：已驳回
NEED_SIGN：待签约
FINISH：完成
FROZEN：已冻结
CANCELED：已作废

applyment_state_desc 　必填 string(1024)

【申请状态描述】申请状态描述, 示例："审核中"

sign_url 　选填 string(256)

【签约链接】1、当申请状态为NEED_SIGN或签约状态为UNSIGNED时返回，该链接为永久有效；
2、申请单中的超级管理者，需用已实名认证的微信扫码打开，完成签约。

sub_mchid 　选填 string(32)

【电商平台二级商户号】当申请状态为NEED_SIGN或FINISH时才返回。

account_validation 　选填 object

【汇款账户验证信息】当申请状态为ACCOUNT_NEED_VERIFY 时有返回，可根据指引汇款，完成账户验证

属性

audit_detail 　选填 array[object]

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

属性

legal_validation_url 　选填 string(256)

【法人验证链接】1、当申请状态为
ACCOUNT_NEED_VERIFY，且通过系统校验的申请单，将返回链接。
2、建议将链接转为二维码展示，让商户法人用微信扫码打开，完成账户验证。

out_request_no 　必填 string(128)

【业务申请编号】提交接口填写的业务申请编号

applyment_id 　必填 integer

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

sign_state 　选填 string(32)

【签约状态】1、未签约-UNSIGNED：该状态下，电商平台可查询获取签约链接，引导二级商户的超级管理员完成签约；
2、已签约-SIGNED ：指二级商户的超级管理员已完成签约。注意：若申请单被驳回，商户修改了商户主体名称、法人名称、超级管理员信息、主体类型等信息，则需重新签约。
3、不可签约-NOT_SIGNABLE：该状态下，暂不支持超级管理员签约。一般为申请单处于已驳回、已冻结、机器校验中状态，无法签约。

应答示例

200 OK

1{
2  "applyment_state" : "FINISH",
3  "applyment_state_desc" : "审核中",
4  "sign_url" : "https://pay.weixin.qq.com/public/apply4ec_sign/s?applymentId=2000002126198476&sign=b207b673049a32c858f3aabd7d27c7ec",
5  "sub_mchid" : "1542488631",
6  "account_validation" : {
7    "account_name" : "aOf7Gk2qT26kakkuTZpbFAn7Mb7xcar0LlQaYoi3+LnnWwgAsfaUUTg9+GmYJq6YCz+RiluWHeHFq1lt8n3eIkF0laVvqmAU80xIWGZgWJnRmnRuZxsg0HJZfnUac2JfqyuL8OoyM2YSuYDqdsyvcOlgUQgq8MPCR6pmvhBCmIeJvnVSm8J+L+yx912itUmTDxhdBlu1CFBIUefME9nYB70vCVTNAVXgURkf65mjHMBiE9Y+wrPZVmTIIz3C3PtPVMZYDEvBT4rDdICA3ZYXshYqeOSslSjSMf+MhhC4oaujiISFzq3AE+as7mAEDJly+DgRuVs74msmKUH8pl+3oA==",
8    "account_no" : "aOf7Gk2qT26kakkuTZpbFAn7Mb7xcar0LlQaYoi3+LnnWwgAsfaUUTg9+GmYJq6YCz+RiluWHeHFq1lt8n3eIkF0laVvqmAU80xIWGZgWJnRmnRuZxsg0HJZfnUac2JfqyuL8OoyM2YSuYDqdsyvcOlgUQgq8MPCR6pmvhBCmIeJvnVSm8J+L+yx912itUmTDxhdBlu1CFBIUefME9nYB70vCVTNAVXgURkf65mjHMBiE9Y+wrPZVmTIIz3C3PtPVMZYDEvBT4rDdICA3ZYXshYqeOSslSjSMf+MhhC4oaujiISFzq3AE+as7mAEDJly+DgRuVs74msmKUH8pl+3oA==",
9    "pay_amount" : 124,
10    "destination_account_number" : "7222223333322332",
11    "destination_account_name" : "财付通支付科技有限公司",
12    "destination_account_bank" : "招商银行威盛大厦支行",
13    "city" : "深圳",
14    "remark" : "入驻账户验证",
15    "deadline" : "2018-12-10 17:09:01"
16  },
17  "audit_detail" : [
18    {
19      "param_name" : "id_card_copy",
20      "reject_reason" : "身份证背面识别失败，请上传更清晰的身份证图片。"
21    }
22  ],
23  "legal_validation_url" : "https://pay.weixin.qq.com/public/apply4ec_sign/s?applymentId=2000002126198476&sign=b207b673049a32c858f3aabd7d27c7ec",
24  "out_request_no" : "APPLYMENT_00000000001",
25  "applyment_id" : 2000002124775691,
26  "sign_state" : "SIGNED"
27}
28

错误码

公共错误码

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

业务错误码

状态码	错误码	描述	解决方案
400	RESOURCE_ALREADY_EXISTS	存在流程进行中的申请单，请检查是否重入	可通过查询申请状态查看此申请单的申请状态，或更换out_request_no提交新的申请单
403	NO_AUTH	商户权限异常	请确认是否已经开通相关权限
404	RESOURCE_NOT_EXISTS	申请单不存在	确认入参，传入正确的申请单编号
500	RATELIMIT_EXCEEDED	系统错误	系统异常，请使用相同参数稍后重新调用

文档是否有帮助

更多支持

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