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

# 变更状态查询

## 功能说明

按 `out_apply_no` 查询商户变更申请单的当前状态。变更审核结果以本接口为准；`AUDITING` 期间可轮询本接口获取最新状态。

## 请求地址

`POST https://gw.xft.xin/openapi/v1/merchant/update/query`

## 请求参数

| 字段             | 是否必选 | 字段类型        | 字段说明         |
| -------------- | ---- | ----------- | ------------ |
| `out_apply_no` | 是    | String(≤64) | 申请单号，变更提交时上送 |

## 响应参数

| 字段              | 是否必选 | 字段类型   | 字段说明                                                   |
| --------------- | ---- | ------ | ------------------------------------------------------ |
| `out_apply_no`  | 是    | String | 申请单号                                                   |
| `modify_code`   | 是    | String | 平台变更申请单号                                               |
| `merchant_code` | 是    | String | 平台商户号                                                  |
| `change_type`   | 是    | String | 变更类型，同[商户信息变更](../merchant/merchant-update)            |
| `modify_status` | 是    | String | 变更申请状态：`AUDITING`=审核中、`SUCCESS`=审核通过已生效、`REJECTED`=已驳回 |
| `reject_reason` | 否    | String | 驳回原因，驳回时非空                                             |
| `timestamp`     | 是    | int64  | 状态更新时间，秒级时间戳                                           |

## 示例

**请求**

```json theme={null}
{
  "out_apply_no": "M202608150001M1"
}
```

**响应（审核通过）**

```json theme={null}
{
  "out_apply_no": "M202608150001M1",
  "modify_code": "MMA2026081500001",
  "merchant_code": "M202608150001",
  "change_type": "05",
  "modify_status": "SUCCESS",
  "reject_reason": "",
  "timestamp": 1755360000
}
```

**响应（审核驳回）**

```json theme={null}
{
  "out_apply_no": "M202608150001M1",
  "modify_code": "MMA2026081500001",
  "merchant_code": "M202608150001",
  "change_type": "05",
  "modify_status": "REJECTED",
  "reject_reason": "结算账户户名与商户主体不一致",
  "timestamp": 1755356400
}
```

**失败示例（申请单不存在）**

```json theme={null}
{
  "code": 400,
  "reason": "NOT_FOUND",
  "message": "记录不存在",
  "metadata": {}
}
```

<Note>
  申请单不存在时返回 400 `NOT_FOUND`。驳回后重新调用[商户信息变更](../merchant/merchant-update)（同 `out_apply_no`）覆盖重提，重新进入审核。
</Note>