查询申请单状态API

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


普通服务商(银行、支付机构、电商平台不可用)可通过业务申请编号或申请单号查询商家入驻申请单的状态。

注意:

• 商户上送敏感信息时使用微信支付平台公钥加密,证书序列号包含在请求HTTP头部的Wechatpay-Serial,详见接口规则




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

接口说明

适用对象:普通服务商

请求URL:https://api.mch.weixin.qq.com/v3/applyment4sub/applyment/business_code/{business_code}

请求方式:GET

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


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

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


请求参数

参数名 变量 类型 必填 描述
业务申请编号 business_code string(124) path
  1. 1、只能由数字、字母或下划线组成,建议前缀为服务商商户号。
  2. 2、服务商自定义的唯一编号。
  3. 3、每个编号对应一个申请单,每个申请单审核通过后生成一个微信支付商户号。
  4. 4、若申请单被驳回,可填写相同的“业务申请编号”,即可覆盖修改原申请单信息。
示例值:1900013511_10000



2、通过申请单号查询申请状态

接口说明

适用对象:普通服务商

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

请求方式:GET

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


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

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


请求参数

参数名 变量 类型 必填 描述
申请单号 applyment_id uint64 path 微信支付分的申请单号。
示例值:2000001234567890

返回参数

参数名 变量 类型 必填 描述
业务申请编号 business_code string 1、只能由数字、字母或下划线组成,建议前缀为服务商商户号。
2、服务商自定义的唯一编号。
3、每个编号对应一个申请单,每个申请单审核通过后生成一个微信支付商户号。
4、若申请单被驳回,可填写相同的“业务申请编号”,即可覆盖修改原申请单信息。
示例值:1900013511_10000
微信支付申请单号 applyment_id uint64 微信支付分配的申请单号。
示例值:2000002124775691
特约商户号 sub_mchid string 特约商户号,当申请单状态为APPLYMENT_STATE_FINISHED时才返回。
示例值:1234567890
超级管理员签约链接 sign_url string 1、超级管理员用微信扫码打开签约链接,根据页面指引完成绑定微信号、账户验证、签约等操作。
2、绑定微信号后,后续申请单进度可通过公众号自动通知超级管理员。
示例值:https://pay.weixin.qq.com/public/apply4ec_sign/s?applymentId=2000002126198476&sign=b207b673049a32c858f3aabd7d27c7ec
申请单状态 applyment_state enum
  1. 1、APPLYMENT_STATE_EDITTING(编辑中):提交申请发生错误导致,请尝试重新提交。
  2. 2、APPLYMENT_STATE_AUDITING(审核中):申请单正在审核中,超级管理员用微信打开“签约链接”,完成绑定微信号后,申请单进度将通过微信公众号通知超级管理员,引导完成后续步骤。
  3. 3、APPLYMENT_STATE_REJECTED(已驳回):请按照驳回原因修改申请资料,超级管理员用微信打开“签约链接”,完成绑定微信号,后续申请单进度将通过微信公众号通知超级管理员。
  4. 4、APPLYMENT_STATE_TO_BE_CONFIRMED(待账户验证):请超级管理员使用微信打开返回的“签约链接”,根据页面指引完成账户验证。
  5. 5、APPLYMENT_STATE_TO_BE_SIGNED(待签约):请超级管理员使用微信打开返回的“签约链接”,根据页面指引完成签约。
  6. 6、APPLYMENT_STATE_SIGNING(开通权限中):系统开通相关权限中,请耐心等待。
  7. 7、APPLYMENT_STATE_FINISHED(已完成):商户入驻申请已完成。
  8. 8、APPLYMENT_STATE_CANCELED(已作废):申请单已被撤销。
示例值:APPLYMENT_STATE_FINISHED
申请状态描述 applyment_state_msg string 申请状态描述
示例值:审核中
+驳回原因详情 audit_detail array 各项资料的审核情况,当申请状态为APPLYMENT_STATE_REJECTED时才返回。
参数名 变量 类型 必填 描述
字段名 field string 提交申请单的资料项字段名。
示例值:id_card_copy
字段名称 field_name string 提交申请单的资料项字段名称。
示例值:身份证复印件
驳回原因 reject_reason string 提交资料项被驳回的原因。
示例值:身份证背面识别失败,请上传更清晰的身份证图片。

返回示例


{
  "business_code": "1900013511_10000",
  "applyment_id": 2000002124775691,
  "sub_mchid": "1234567890",
  "sign_url": "https://pay.weixin.qq.com/public/apply4ec_sign/s?applymentId=2000002126198476&sign=b207b673049a32c858f3aabd7d27c7ec",
  "applyment_state": "APPLYMENT_STATE_FINISHED",
  "applyment_state_msg": "审核中",
  "audit_detail": [
    {
      "field": "id_card_copy",
      "field_name": "身份证复印件",
      "reject_reason": "身份证背面识别失败,请上传更清晰的身份证图片。"
    }
  ]
}
                                

    http://2323weixin.qq.com
                                

错误码公共错误码

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

版本说明

关闭
V1.1
2020年2月11日
1. 修改特约商户号返回条件
V1.0
2019年10月08日
1. 查询申请单状态接口上线