通过业务申请编号查询申请状态
更新时间:2023.06.27接口适用场景:当服务商提交申请单后,需要定期调用此接口查询申请单的审核状态。
# 接口说明
支持商户:
【平台商户】
请求方式:
【GET】/v3/ecommerce/applyments/out-request-no/{out_request_no}
请求域名:
【主域名】
https://api.mch.weixin.qq.com
使用该域名将访问就近的接入点【备域名】
https://api2.mch.weixin.qq.com
使用该域名将访问异地的接入点 ,指引点击查看
# 请求参数
- Authorization 必填请参考 签名认证 生成认证信息
- Accept 必填请设置为
application/json
Header HTTP头参数
- out_request_no 必填【业务申请编号】 1、服务商自定义的商户唯一编号。
2、每个编号对应一个申请单,每个申请单审核通过后会生成一个微信支付商户号。
Path 路径参数
请求示例
GET
# 应答参数
- applyment_state 必填【申请状态】 枚举值:
CHECKING:资料校验中
ACCOUNT_NEED_VERIFY:待账户验证
AUDITING:审核中
REJECTED:已驳回
NEED_SIGN:待签约
FINISH:完成
FROZEN:已冻结
CANCELED:已作废 - applyment_state_desc 必填【申请状态描述】 申请状态描述, 示例:"审核中"
- sign_url 选填【签约链接】 1、当申请状态为NEED_SIGN时才返回。
2、建议将链接转为二维码展示,需让申请单-管理者用微信扫码打开,完成签约。 - sub_mchid 选填【电商平台二级商户号】 当申请状态为NEED_SIGN或FINISH时才返回。
- account_validation 选填【汇款账户验证信息】 当申请状态为ACCOUNT_NEED_VERIFY 时有返回,可根据指引汇款,完成账户验证
- 属性
- audit_detail 选填【驳回原因详情】 各项资料的审核情况。当申请状态为REJECTED或 FROZEN时才返回。
- 属性
- legal_validation_url 选填【法人验证链接】 1、当申请状态为
ACCOUNT_NEED_VERIFY,且通过系统校验的申请单,将返回链接。
2、建议将链接转为二维码展示,让商户法人用微信扫码打开,完成账户验证。 - out_request_no 必填【业务申请编号】 提交接口填写的业务申请编号
- applyment_id 必填【微信支付申请单号】 微信支付分配的申请单号
- sign_state 选填【签约状态】 1、未签约-UNSIGNED:该状态下,电商平台可查询获取签约链接,引导二级商户的超级管理员完成签约;
2、已签约-SIGNED :指二级商户的超级管理员已完成签约。注意:若申请单被驳回,商户修改了商户主体名称、法人名称、超级管理员信息、主体类型等信息,则需重新签约。
3、不可签约-NOT_SIGNABLE:该状态下,暂不支持超级管理员签约。一般为申请单处于已驳回、已冻结、机器校验中状态,无法签约。
200OK
应答示例
200 OK
# 错误码
# 公共错误码
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
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 | 系统错误 | 系统异常,请使用相同参数稍后重新调用 |
文档是否有帮助