查询申请状态API

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

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


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

接口说明

适用对象:电商平台

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

请求方式:GET

接口规则:https://wechatpay-api.gitbook.io/wechatpay-api-v3


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

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

接口规则:https://wechatpay-api.gitbook.io/wechatpay-api-v3


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

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:已冻结
示例值:FINISH
申请状态描述 applyment_state_desc string[1,32] 申请状态描述
示例值:“审核中”
签约链接 sign_url string[1,256] 1、当申请状态为NEED_SIGN时才返回。
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 uint64 需商户使用该户名的账户进行汇款。
该字段需进行解密处理,解密方法详见敏感信息加解密说明
示例值: rDdICA3ZYXshYqeOSslSjSMf+MhhC4oaujiISFzq3AE+as7mAEDJly+DgRuVs74msmKUH8pl+3oA==
付款卡号 account_no string[1,128] 结算账户为对私时会返回,商户需使用该付款卡号进行汇款。
该字段需进行解密处理,解密方法详见敏感信息加解密说明
示例值:9nZYDEvBT4rDdICA3ZYXshYqeOSslSjSauAE+as7mAEDJly+DgRuVs74msmKUH8pl+3oA==
汇款金额 pay_amount string[1,32] 需要汇款的金额(单位:分)。
示例值: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、建议将链接转为二维码展示,让商户法人用微信扫码打开,完成账户验证。
示例值: https://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": "https://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": "https://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 SYSTEMERROR

系统错误

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

参数错误

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

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

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

商户权限异常

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

申请单不存在

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

版本说明

关闭
V1.0
2019.09.09
1. 查询进件申请状态接口上线

技术咨询

反馈有奖