> ## 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/PROCESSING）**以本接口查询为准**；通知未收到时，也以本接口结果为准。

## 请求地址

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

## 请求参数

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

## 响应参数

| 字段                  | 是否必选 | 字段类型   | 字段说明                              |
| ------------------- | ---- | ------ | --------------------------------- |
| `out_apply_no`      | 是    | String | 申请单号                              |
| `apply_no`          | 是    | String | 平台申请单号                            |
| `merchant_code`     | 否    | String | 平台商户号，进件成功后返回                     |
| `sub_merchant_code` | 否    | String | 微信/支付宝子商户号，渠道进件成功后返回              |
| `apply_status`      | 是    | String | 申请状态，见[状态机说明](../appendix/status) |
| `reject_reason`     | 否    | String | 驳回原因，驳回时非空（标注平台驳回/渠道驳回）           |
| `channel_ret_code`  | 否    | String | 渠道侧原始返回码，透传，可为空                   |
| `timestamp`         | 是    | int64  | 状态更新时间，秒级时间戳                      |

## 示例

**请求**

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

**响应（进件成功）**

```json theme={null}
{
  "out_apply_no": "P20260815001",
  "apply_no": "AP2026081500001",
  "merchant_code": "M202608150001",
  "sub_merchant_code": "1900000101",
  "apply_status": "SUCCESS",
  "reject_reason": "",
  "channel_ret_code": "",
  "timestamp": 1755320400
}
```

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

```json theme={null}
{
  "out_apply_no": "P20260815001",
  "apply_no": "AP2026081500001",
  "merchant_code": "",
  "sub_merchant_code": "",
  "apply_status": "REJECTED",
  "reject_reason": "营业执照信息与工商登记不一致",
  "channel_ret_code": "",
  "timestamp": 1755312000
}
```

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

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

<Note>
  申请单不存在时返回 400 `NOT_FOUND`；中间态（AUDITING/PROCESSING）无异步通知，请轮询本接口获取最新状态。
</Note>