商户认证状态查询

接口说明

查询商户认证申请的状态，支持微信支付和支付宝双渠道查询。可指定查询单个渠道或同时查询两个渠道。

渠道差异

微信支付：返回授权状态、申请单状态、小程序码等信息
支付宝：返回申请单状态、小程序码等信息

请求地址

【POST】/pay/applyment/verify_query

业务参数

参数	必填	类型	说明	示例值
merchant_no	是	String(32)	商户号	1900013511
channel_type	否	String	渠道类型：`wxpay` 微信 / `alipay` 支付宝 / `all` 全部（默认）	all

请求示例

查询全部渠道（默认）

{
  "merchant_no": "1900013511"
}

仅查询微信渠道

{
  "merchant_no": "1900013511",
  "channel_type": "wxpay"
}

仅查询支付宝渠道

{
  "merchant_no": "1900013511",
  "channel_type": "alipay"
}

返回结果

参数	必填	类型	说明	示例值
code	是	String	返回码（000000成功）	000000
message	是	String	返回信息	查询成功
wxpay_mch_id	否	String	微信子商户号（channel_type=wxpay或all时返回）	1900013511
alipay_mch_id	否	String	支付宝子商户号（channel_type=alipay或all时返回）	2088100000000000
wxpay	否	Object	微信渠道认证信息（channel_type=wxpay或all时返回）	-
alipay	否	Object	支付宝渠道认证信息（channel_type=alipay或all时返回）	-

wxpay 对象字段

参数	必填	类型	说明	示例值
qrcode_url	否	String	小程序码URL（待确认联系信息/待账户验证/审核通过/已冻结时返回）	https://xxx
applyment_state	是	String	申请单状态（见下方枚举）	APPLYMENT_STATE_PASSED
reject_reason	否	String	驳回原因（审核驳回时返回）	身份证照片不清晰
authorize_state	是	String	授权状态（见下方枚举）	AUTHORIZE_STATE_AUTHORIZED

alipay 对象字段

参数	必填	类型	说明	示例值
qrcode_url	否	String	小程序码URL（需要确认时返回）	https://xxx
applyment_state	是	String	申请单状态（见下方枚举）	AUDIT_PASS
authorize_state	是	String	确认状态（见下方枚举）	AUTHORIZED

申请单状态枚举

微信 applyment_state

状态值	说明	后续操作
`APPLYMENT_STATE_EDITTING`	编辑中	可能提交出错，可用同一业务编号重新提交
`APPLYMENT_STATE_WAITTING_FOR_AUDIT`	审核中	等待1-2个工作日
`APPLYMENT_STATE_WAITTING_FOR_CONFIRM_CONTACT`	待确认联系信息	扫描小程序码确认联系信息（可修改手机号）
`APPLYMENT_STATE_WAITTING_FOR_CONFIRM_LEGALPERSON`	待账户验证	扫描小程序码完成账户验证
`APPLYMENT_STATE_PASSED`	审核通过	扫描小程序码完成授权流程
`APPLYMENT_STATE_REJECTED`	审核驳回	按驳回原因修改资料，更换业务编号重新提交
`APPLYMENT_STATE_FREEZED`	已冻结	可能主体已完成入驻，通知指定联系人扫码完成授权
`APPLYMENT_STATE_CANCELED`	已作废	申请单已撤销，无需操作

授权状态枚举

微信 authorize_state

状态值	说明
`AUTHORIZE_STATE_UNAUTHORIZED`	未授权，特约商户号还未完成实名认证
`AUTHORIZE_STATE_AUTHORIZED`	已授权，特约商户号已完成实名认证

支付宝 authorize_state

状态值	说明
`AUTHORIZED`	已完成确认
`UNAUTHORIZED`	未完成确认
`CLOSED`	已销户
`SMID_NOT_EXIST`	sub_merchant_id不存在

支付宝 applyment_state

状态值	说明	后续操作
`AUDITING`	审核中	等待审核
`CONTACT_CONFIRM`	待联系人确认	联系人需确认相关信息
`LEGAL_CONFIRM`	待法人确认	法人需确认相关信息
`AUDIT_PASS`	审核通过	认证完成
`AUDIT_REJECT`	审核驳回	按驳回原因修改后重新提交
`AUDIT_FREEZE`	已冻结	联系指定联系人完成相关流程
`CANCELED`	已撤回	申请单已撤销，无需操作
`CONTACT_PROCESSING`	联系人处理中	等待联系人处理完成

返回示例

查询全部渠道

{
  "code": "000000",
  "message": "查询成功",
  "wxpay": {
    "qrcode_url": "https://xxx",
    "applyment_state": "APPLYMENT_STATE_PASSED",
    "authorize_state": "AUTHORIZE_STATE_UNAUTHORIZED"
  },
  "alipay": {
    "qrcode_url": "",
    "applyment_state": "AUDIT_PASS",
    "authorize_state": "AUTHORIZED"
  }
}

仅微信渠道 - 审核中

{
  "code": "000000",
  "message": "查询成功",
  "wxpay": {
    "applyment_state": "APPLYMENT_STATE_WAITTING_FOR_AUDIT",
    "authorize_state": "AUTHORIZE_STATE_UNAUTHORIZED"
  }
}

仅微信渠道 - 审核驳回

{
  "code": "000000",
  "message": "查询成功",
  "wxpay": {
    "applyment_state": "APPLYMENT_STATE_REJECTED",
    "reject_reason": "身份证照片不清晰，请重新上传",
    "authorize_state": "AUTHORIZE_STATE_UNAUTHORIZED"
  }
}

仅微信渠道 - 待账户验证

{
  "code": "000000",
  "message": "查询成功",
  "wxpay": {
    "qrcode_url": "https://xxx",
    "applyment_state": "APPLYMENT_STATE_WAITTING_FOR_CONFIRM_LEGALPERSON",
    "authorize_state": "AUTHORIZE_STATE_UNAUTHORIZED"
  }
}

仅支付宝渠道 - 审核通过

{
  "code": "000000",
  "message": "查询成功",
  "alipay": {
    "applyment_state": "AUDIT_PASS",
    "authorize_state": "AUTHORIZED"
  }
}

错误码

错误码	说明
000000	成功
FAIL	失败
MERCHANT_NO_NOT_FOUND	商户号不存在
PARAM_ERROR	参数错误
CHANNEL_TYPE_INVALID	渠道类型错误

注意事项

查询条件：只能使用 merchant_no 查询，不支持业务申请编号
渠道选择：不传 channel_type 或传 all 时，返回两个渠道的认证信息
微信授权流程：
- 审核通过后，需扫描小程序码完成授权
- authorize_state 为 AUTHORIZE_STATE_UNAUTHORIZED 表示未完成授权
- authorize_state 为 AUTHORIZE_STATE_AUTHORIZED 表示已完成授权
支付宝流程：提交后直接审核，无需扫码授权
状态轮询：建议每隔 10-30 秒查询一次，避免频繁请求

更新时间

更新时间：2025.01.09