查询申请单状态API
普通服务商(银行、支付机构、电商平台不可用）可通过业务申请编号或申请单号查询商家入驻申请单的状态。
注意
商户上送敏感信息时使用微信支付平台公钥加密, 证书序列号包含在请求 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） | 是 | 业务申请编号 path1、只能由数字、字母或下划线组成, 建议前缀为服务商商户号。 2、服务商自定义的唯一编号。 3、每个编号对应一个申请单, 每个申请单审核通过后生成一个微信支付商户号。 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、APPLYMENT_STATE_EDITTING(编辑中）: 提交申请发生错误导致, 请尝试重新提交。 2、APPLYMENT_STATE_AUDITING(审核中）: 申请单正在审核中, 超级管理员用微信打开“签约链接”, 完成绑定微信号后, 申请单进度将通过微信公众号通知超级管理员, 引导完成后续步骤。 3、APPLYMENT_STATE_REJECTED(已驳回）: 请按照驳回原因修改申请资料, 超级管理员用微信打开“签约链接”, 完成绑定微信号, 后续申请单进度将通过微信公众号通知超级管理员。 4、APPLYMENT_STATE_TO_BE_CONFIRMED(待账户验证）: 请超级管理员使用微信打开返回的“签约链接”, 根据页面指引完成账户验证。 5、APPLYMENT_STATE_TO_BE_SIGNED(待签约）: 请超级管理员使用微信打开返回的“签约链接”, 根据页面指引完成签约。 6、APPLYMENT_STATE_SIGNING(开通权限中）: 系统开通相关权限中, 请耐心等待。 7、APPLYMENT_STATE_FINISHED(已完成）: 商户入驻申请已完成。 8、APPLYMENT_STATE_CANCELED(已作废）: 申请单已被撤销。 |
| APPLYMENT_STATE_FINISHED | |||
| applyment_state_msg | string | 否 | 申请状态描述 申请状态描述 |
| 审核中 | |||
| audit_detail | array | 否 | +驳回原因详情 各项资料的审核情况, 当申请状态为 APPLYMENT_STATE_REJECTED 时才返回。 |
返回示例
正常示例
{
"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": "身份证背面识别失败, 请上传更清晰的身份证图片。"
}
]
}
错误码公共错误码
| 错误码 | 描述 | 解决方案 |
|---|---|---|
| SYSTEMERROR | 系统错误 | 系统异常, 请使用相同参数稍后重新调用 |
| PARAM_ERROR | 参数错误 | 请使用正确的参数重新调用 |
| PROCESSING | 存在流程进行中的申请单, 请检查是否重入 | 可通过查询申请单状态查看此申请单的申请状态, 或更换 out_request_no 提交新的申请单 |
| NO_AUTH | 商户权限异常 | 请确认是否已经开通相关权限 |
| RATE_LIMITED | 频率限制 | 请降低调用频率 |
| APPLYMENT_NOTEXIST | 申请单不存在 | 确认入参, 传入正确的申请单编号 |
Feedback
Was this page helpful?
很高兴听到！ 请告诉我们，我们如何才能改善.
很遗憾听到这个消息。 请告诉我们，我们如何才能改善.
最后修改 April 12, 2020: 整理文档 (f36b91e)