> ## 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.

# 商户状态查询

## 功能说明

查询平台商户及其状态（正常/停用/冻结等）。商户号由[进件状态查询](../merchant/apply-query)或[审核异步通知](../merchant/apply-notify)下发，进件成功后可通过本接口随时查询商户状态。

* 商户状态与进件状态相互独立：进件成功（`apply_status=SUCCESS`）后，商户状态为 1=正常，后续可被平台停用/冻结；
* 商户不存在或不属于当前渠道商时返回 `MERCHANT_NOT_EXIST`。

**支持商户**：全部已开通进件权限的渠道商

**请求方式**：`POST`

**请求路径**：`/openapi/v1/merchant/query`

## 请求参数

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

## 响应参数

| 字段                | 是否必选 | 字段类型   | 字段说明                                   |
| ----------------- | ---- | ------ | -------------------------------------- |
| `merchant_code`   | 是    | String | 平台商户号                                  |
| `merchant_name`   | 是    | String | 商户名称                                   |
| `merchant_status` | 是    | String | 商户状态：1=正常/2=停用/3=待审核/4=审核驳回/5=冻结/6=已注销 |
| `timestamp`       | 是    | int64  | 查询时间，秒级时间戳                             |

## 示例

**请求**

```json theme={null}
{
  "merchant_code": "M202608150001"
}
```

**响应**

```json theme={null}
{
  "merchant_code": "M202608150001",
  "merchant_name": "杭州星富通科技有限公司",
  "merchant_status": "1",
  "timestamp": 1755342000
}
```

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

```json theme={null}
{
  "code": 400,
  "reason": "MERCHANT_NOT_EXIST",
  "message": "商户号不存在",
  "metadata": {}
}
```