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

更新时间: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
使用该域名将访问异地的接入点 ,指引点击查看

# 请求参数

    Header HTTP头参数
  • Authorization 必填 string
    请参考 签名认证 生成认证信息
  • Accept 必填 string
    请设置为 application/json
    Path 路径参数
  • out_request_no 必填 string(124)
    【业务申请编号】 1、服务商自定义的商户唯一编号。
    2、每个编号对应一个申请单,每个申请单审核通过后会生成一个微信支付商户号。

请求示例

GET

# 应答参数

    200OK
  • applyment_state 必填 string(32)
    【申请状态】 枚举值:
    CHECKING:资料校验中
    ACCOUNT_NEED_VERIFY:待账户验证
    AUDITING:审核中
    REJECTED:已驳回
    NEED_SIGN:待签约
    FINISH:完成
    FROZEN:已冻结
    CANCELED:已作废
  • applyment_state_desc 必填 string(1024)
    【申请状态描述】 申请状态描述, 示例:"审核中"
  • sign_url 选填 string(256)
    【签约链接】 1、当申请状态为NEED_SIGN时才返回。
    2、建议将链接转为二维码展示,需让申请单-管理者用微信扫码打开,完成签约。
  • sub_mchid 选填 string(32)
    【电商平台二级商户号】 当申请状态为NEED_SIGN或FINISH时才返回。
  • account_validation 选填 UpwardBankValidate
    【汇款账户验证信息】 当申请状态为ACCOUNT_NEED_VERIFY 时有返回,可根据指引汇款,完成账户验证
    • 属性
  • audit_detail 选填 array[AuditDetail]
    【驳回原因详情】 各项资料的审核情况。当申请状态为REJECTED或 FROZEN时才返回。
    • 属性
  • legal_validation_url 选填 string(256)
    【法人验证链接】 1、当申请状态为
    ACCOUNT_NEED_VERIFY,且通过系统校验的申请单,将返回链接。
    2、建议将链接转为二维码展示,让商户法人用微信扫码打开,完成账户验证。
  • out_request_no 必填 string(128)
    【业务申请编号】 提交接口填写的业务申请编号
  • applyment_id 必填 integer
    【微信支付申请单号】 微信支付分配的申请单号
  • sign_state 选填 string(32)
    【签约状态】 1、未签约-UNSIGNED:该状态下,电商平台可查询获取签约链接,引导二级商户的超级管理员完成签约;
    2、已签约-SIGNED :指二级商户的超级管理员已完成签约。注意:若申请单被驳回,商户修改了商户主体名称、法人名称、超级管理员信息、主体类型等信息,则需重新签约。
    3、不可签约-NOT_SIGNABLE:该状态下,暂不支持超级管理员签约。一般为申请单处于已驳回、已冻结、机器校验中状态,无法签约。

应答示例

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 系统错误 系统异常,请使用相同参数稍后重新调用
反馈
咨询
目录