商户状态查询 - 星惠付开放平台

功能说明

查询本主体录入商户的商户信息与业务状态。商户号由进件状态查询或审核异步通知下发。

商户业务状态与审核状态相互独立：merchant_status 为商户业务状态（是否可交易），audit_status 为商户审核结果；
仅可查询本主体录入的商户（渠道商可查询旗下品牌录入的商户），否则返回 403 PERMISSION_DENIED；
商户不存在时返回 400 NOT_FOUND。

支持商户：全部已开通进件权限的渠道商（及其旗下品牌） 请求方式：POST 请求路径：/openapi/v1/merchant/query

请求参数

字段	是否必填	字段类型	字段说明
`merchant_code`	是	String	平台商户号

响应参数

字段	是否必填	字段类型	字段说明
`merchant_code`	是	String	平台商户号
`merchant_name`	是	String	商户名称
`merchant_status`	是	String	商户业务状态：`INACTIVE`=未生效/`ACTIVE`=正常/`PENDING`=待审核/`FROZEN`=冻结/`CANCELED`=已注销
`audit_status`	是	String	审核状态：`AUDITING`=审核中/`PASSED`=审核通过/`REJECTED`=驳回（与进件状态查询顶层 `apply_status` 同源）
`timestamp`	是	String	商户创建时间，格式 `yyyy-MM-dd HH:mm:ss`

示例

请求

{
  "merchant_code": "801292371559190"
}

响应

{
  "merchant_code": "801292371559190",
  "merchant_name": "杭州西湖云帆智慧零售有限公司",
  "merchant_status": "ACTIVE",
  "audit_status": "PASSED",
  "timestamp": "2026-10-18 08:56:40"
}

失败示例（商户不存在）

{
  "code": 400,
  "reason": "NOT_FOUND",
  "message": "进件商户不存在: 999999999999999",
  "metadata": {}
}