> ## Documentation Index
> Fetch the complete documentation index at: https://opendocs.xft.xin/llms.txt
> Use this file to discover all available pages before exploring further.

# 商户状态查询

## 功能说明

查询本主体录入商户的商户信息与业务状态。商户号由[进件状态查询](https://opendocs.xft.xin/open/payment/merchant/apply-query.md)或[审核异步通知](https://opendocs.xft.xin/open/payment/merchant/apply-notify.md)下发。

* 商户业务状态与审核状态相互独立：`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`=驳回（与[进件状态查询](https://opendocs.xft.xin/open/payment/merchant/apply-query.md)顶层 `apply_status` 同源） |
| `timestamp` | 是 | String | 商户创建时间，格式 `yyyy-MM-dd HH:mm:ss` |

## 示例

**请求**

```json theme={"system"}
{
  "merchant_code": "801292371559190"
}
```

**响应**

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

**失败示例（商户不存在）**

```json theme={"system"}
{
  "code": 400,
  "reason": "NOT_FOUND",
  "message": "进件商户不存在: 999999999999999",
  "metadata": {}
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.