商户进件
特约商户进件
基础支付
JSAPI支付
APP支付
H5支付
Native支付
小程序支付
合单支付
付款码支付
经营能力
支付即服务
点金计划
行业方案
平台收付通(商户进件)
平台收付通(普通支付)
平台收付通(合单支付)
平台收付通(分账)
平台收付通(补差)
平台收付通(退款)
平台收付通(余额查询)
平台收付通(商户提现)
平台收付通(注销申请)
平台收付通(注销后提现)
平台收付通(跨境付款)
平台收付通(下载账单)
智慧商圈
微信支付分停车服务
电子发票
营销工具
代金券
商家券
委托营销
支付有礼
小程序发券插件
H5发券
图片上传(营销专用)
现金红包
资金应用
分账
连锁品牌分账
风险合规
商户开户意愿确认
消费者投诉2.0
商户违规通知回调
其他能力
图片上传
视频上传
微信支付平台证书

查询申请状态API

最新更新时间:2022.04.08 版本说明

电商平台通过查询申请状态API查询二级商户入驻申请结果。该查询服务提供两种查询方式(两种查询方式返回结果一致):
      方式1:业务申请编号查询申请状态;
      方式2:申请单号查询申请状态。


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

接口说明

适用对象:电商平台

请求URL:https://api.mch.weixin.qq.com/v3/ecommerce/applyments/{applyment_id}

请求方式:GET


path指该参数为路径参数

query指该参数需在请求URL传参

body指该参数需在请求JSON传参

请求参数

参数名 变量 类型[长度限制] 必填 描述
微信支付申请单号 applyment_id uint64 path申请单的主键,唯一定义此资源的标识。
示例值:2000002124775691

请求示例


https://api.mch.weixin.qq.com/v3/ecommerce/applyments/2000002124775691
    
{
JAVA示例代码
}
    

2、通过业务申请编号查询申请状态

接口说明

适用对象:电商平台

请求URL:https://api.mch.weixin.qq.com/v3/ecommerce/applyments/out-request-no/{out_request_no}

请求方式:GET


path指该参数为路径参数

query指该参数需在请求URL传参

body指该参数需在请求JSON传参

请求参数

参数名 变量 类型[长度限制] 必填 描述
业务申请编号 out_request_no string[1,124] path1、服务商自定义的商户唯一编号。
2、每个编号对应一个申请单,每个申请单审核通过后会生成一个微信支付商户号。
示例值:APPLYMENT_00000000001

请求示例


https://api.mch.weixin.qq.com/v3/ecommerce/applyments/out-request-no/APPLYMENT_00000000001
    
{
JAVA示例代码
}
    

返回参数

参数名 变量 类型[长度限制] 必填 描述
申请状态 applyment_state string[1,32] 枚举值:
CHECKING:资料校验中
ACCOUNT_NEED_VERIFY:待账户验证
AUDITING:审核中
REJECTED:已驳回
NEED_SIGN:待签约
FINISH:完成
FROZEN:已冻结
CANCELED:已作废
示例值:FINISH
申请状态描述 applyment_state_desc string[1,1024] 申请状态描述
示例值:“完成”
签约状态 sign_state string[1,16] 1、UNSIGNED:未签约。该状态下,电商平台可查询获取签约链接,引导二级商户的超级管理员完成签约;
2、SIGNED :已签约。指二级商户的超级管理员已完成签约。注意:若申请单被驳回,商户修改了商户主体名称、法人名称、超级管理员信息、主体类型等信息,则需重新签约。
3、NOT_SIGNABLE:不可签约。该状态下,暂不支持超级管理员签约。一般为申请单处于已驳回、已冻结、机器校验中状态,无法签约。
示例值:SIGNED
签约链接 sign_url string[1,256] 1、当申请状态为NEED_SIGN 或 签约状态为UNSIGNED时返回,该链接为永久有效;
2、申请单中的超级管理者,需用已实名认证的微信扫码打开,完成签约。
示例值:https://pay.weixin.qq.com/public/apply4ec_sign/s?applymentId=2000002126198476&sign=b207b673049a32c858f3aabd7d27c7ec
电商平台二级商户号 sub_mchid string[1,32] 当申请状态为NEED_SIGN或FINISH时才返回。
示例值:1542488631
+汇款账户验证信息 account_validation object 当申请状态为ACCOUNT_NEED_VERIFY 时有返回,可根据指引汇款,完成账户验证。
参数名 变量 类型[长度限制] 必填 描述
付款户名 account_name string[1,128] 需商户使用该户名的账户进行汇款。
该字段需进行解密处理,解密方法详见敏感信息加解密说明
示例值: rDdICA3ZYXshYqeOSslSjSMf+MhhC4oaujiISFzq3AE+as7mAEDJly+DgRuVs74msmKUH8pl+3oA==
付款卡号 account_no string[1,128] 结算账户为对私时会返回,商户需使用该付款卡号进行汇款。
该字段需进行解密处理,解密方法详见敏感信息加解密说明
示例值:9nZYDEvBT4rDdICA3ZYXshYqeOSslSjSauAE+as7mAEDJly+DgRuVs74msmKUH8pl+3oA==
汇款金额 pay_amount int 需要汇款的金额(单位:分)。
示例值:124
收款卡号 destination_account_number string[1,128] 收款账户的卡号
示例值:7222223333322332
收款户名 destination_account_name string[1,128] 收款账户名
示例值:财付通支付科技有限公司
开户银行 destination_account_bank string[1,128] 收款账户的开户银行名称。
示例值:招商银行股份有限公司深圳汉京中心支行
省市信息 city string[1,128] 收款账户的省市。
示例值:深圳
备注信息 remark string[1,128] 商户汇款时,需要填写的备注信息。
示例值:入驻账户验证
汇款截止时间 deadline string[1,20] 请在此时间前完成汇款。
示例值:2018-12-10 17:09:01
+驳回原因详情 audit_detail array 各项资料的审核情况。当申请状态为REJECTED或 FROZEN时才返回。
参数名 变量 类型[长度限制] 必填 描述
参数名称 param_name string[1,32] 提交申请单的资料项名称。
示例值:id_card_copy
驳回原因 reject_reason string[1,32] 提交资料项被驳回原因。
示例值:身份证背面识别失败,请上传更清晰的身份证图片
法人验证链接 legal_validation_url string[1,256] 1、当申请状态为
ACCOUNT_NEED_VERIFY,且通过系统校验的申请单,将返回链接。
2、建议将链接转为二维码展示,让商户法人用微信扫码打开,完成账户验证。
注:商户申请单进入审核状态后,微信侧会校验法人证件号码是否跟营业执照匹配,若匹配,返回该字段 ; 若不匹配,不支持法人扫码验证,不返回该字段。
示例值: http://pay.weixin.qq.com/public/apply4ec_sign/s?applymentId=2000002126198476&sign=b207b673049a32c858f3aabd7d27c7ec
业务申请编号 out_request_no string[1,124] 提交接口填写的业务申请编号。
示例值:APPLYMENT_00000000001
微信支付申请单号 applyment_id uint64 微信支付分配的申请单号。
示例值:2000002124775691

返回示例


{
  "applyment_state": "FINISH",
  "applyment_state_desc": "完成",
  "sign_url": "http://pay.weixin.qq.com/public/apply4ec_sign/s?applymentId=
 2000002126198476&sign=b207b673049a32c858f3aabd7d27c7ec",
  "sub_mchid": "1542488631",
  "account_validation": {
    "account_name": "aOf7Gk2qT26kakkuTZpbFAn7Mb7xcar0LlQaYoi3+LnnWwgAsfaUUTg9+GmYJq6YCz+RiluWHeHFq1lt8n3eIkF0la
VvqmAU80xIWGZgWJnRmnRuZxsg0HJZfnUac2JfqyuL8OoyM2YSuYDqdsyvcOlgUQgq8MPCR6pmvhBCmIeJvnVSm8J+L+yx912i
 tUmTDxhdBlu1CFBIUefME9nYB70vCVTNAVXgURkf65mjHMBiE9Y+wrPZVmTIIz3C3PtPVMZYDEv
 BT4rDdICA3ZYXshYqeOSslSjSMf+MhhC4oaujiISFzq3AE+as7mAEDJly+DgRuVs74msmKUH8pl+3oA==",
    "account_no": "aOf7Gk2qT26kakkuTZpbFAn7Mb7xcar0LlQaYoi3+LnnWwgAsfaUUTg9+GmYJq6YCz+RiluWHeHFq1lt8n3eIkF0laV
vqmAU80xIWGZgWJnRmnRuZxsg0HJZfnUac2JfqyuL8OoyM2YSuYDqdsyvcOlgUQgq8MPCR6pmvhBCmIeJvnVSm8J
 +L+yx912itUmTDxhdBlu1CFBIUefME9nYB70vCVTNAVXgURkf65mjHMBiE9Y+wrPZVmTIIz3C3PtPVMZYDEvBT
 4rDdICA3ZYXshYqeOSslSjSMf+MhhC4oaujiISFzq3AE+as7mAEDJly+DgRuVs74msmKUH8pl+3oA==",
    "pay_amount": 124,
    "destination_account_number": "7222223333322332",
    "destination_account_name": "财付通支付科技有限公司",
    "destination_account_bank": "招商银行股份有限公司深圳汉京中心支行",
    "city": "深圳",
    "remark": "入驻账户验证",
    "deadline": "2018-12-10 17:09:01"
  },
  "audit_detail": [
    {
      "param_name": "id_card_copy",
      "reject_reason": "身份证背面识别失败,请上传更清晰的身份证图片。"
    }
  ],
  "legal_validation_url": "http://pay.weixin.qq.com/public/apply4ec_sign/s?appl
 ymentId=2000002126198476&sign=b207b673049a32c858f3aabd7d27c7ec",
  "out_request_no": "APPLYMENT_00000000001",
  "applyment_id": 2000002124775691
}
                                

    http://2323weixin.qq.com
                                

错误码公共错误码

状态码 错误码 描述 解决方案
500 RATELIMIT_EXCEEDED

系统错误

系统异常,请使用相同参数稍后重新调用
400 PARAM_ERROR

参数错误

请使用正确的参数重新调用
400 RESOURCE_ALREADY_EXISTS

存在流程进行中的申请单,请检查是否重入

可通过查询申请状态查看此申请单的申请状态,或更换out_request_no提交新的申请单
403 NO_AUTH

商户权限异常

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

申请单不存在

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


技术咨询

文档反馈