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

# 状态机说明

## 商户入驻申请状态（顶层 `apply_status`）

商户录入后，平台对商户审核的结果。由商户审核驱动，见[进件状态查询](https://opendocs.xft.xin/open/payment/merchant/apply-query.md)响应顶层字段。

| 状态 | 语义 | 说明 |
| - | - | - |
| `AUDITING` | 审核中 | 平台人工审核中，尚未发起机构进件 |
| `PASSED` | 审核通过 | 平台已发起机构进件（或已入驻），各机构进度看 `institutions[].apply_status` |
| `REJECTED` | 驳回 | 附 `reject_reason`，需使用新的 `out_apply_no` 重新录入 |

```
商户录入 ──► AUDITING ──► PASSED ──► 各机构进件（机构层状态）
                │
                ▼
            REJECTED ──(换新 out_apply_no)──► AUDITING
```

## 机构进件申请状态（`institutions[].apply_status`）

审核通过后，平台对每个机构各建一条进件申请单并推进；每机构状态相互独立。由机构申请单驱动，仅审核通过后才有值，未进件时为空。

| 状态 | 语义 | 说明 |
| - | - | - |
| `SUBMITTED` | 已提交 | 已向机构提交进件申请 |
| `VERIFYING` | 核身中 | 机构侧核身/验证流程中 |
| `SIGNING` | 签约中 | 等待商户完成电子签约（可用[签约信息查询](https://opendocs.xft.xin/open/payment/merchant/sign-info.md)获取签约链接） |
| `COMPLETED` | 已完成 | 进件完成，机构商户号/终端号就绪，可交易（终态） |
| `REJECTED` | 驳回 | 机构驳回（终态），附 `reject_reason` |
| `FAILED` | 失败 | 进件失败或签约失败（终态），附 `reject_reason` |

```
SUBMITTED ──► VERIFYING ──► SIGNING ──► COMPLETED
                 │             │
                 ▼             ▼
             REJECTED       FAILED（签约失败）
```

> [!NOTE]
>
> 机构层状态由平台申请单状态映射而来，上游为各支付机构的原始状态码；机构原始码不对外暴露，统一以本表为准。

## 签约状态（`sign_status`）

[签约信息查询](https://opendocs.xft.xin/open/payment/merchant/sign-info.md)返回的电子签约状态，按机构实时查询后映射为平台统一码：

| 状态 | 语义 |
| - | - |
| `NOT_CREATED` | 合同未创建，待平台发起签约 |
| `PENDING` | 待签约 |
| `SIGNING` | 签署中 |
| `SIGNED` | 已签约 |
| `REJECTED` | 已拒绝 |
| `LOCKED` | 锁定代签 |
| `EXPIRED` | 已过期 |
| `FAILED` | 签约失败 |
| `UNKNOWN` | 未知或机构不支持（易宝恒为此值） |

## 变更申请状态（modify\_status）

| 状态 | 语义 | 说明 |
| - | - | - |
| `AUDITING` | 审核中 | 平台审核中（含通过后向机构同步中） |
| `SUCCESS` | 审核通过已生效 | 平台同步完成，变更生效 |
| `REJECTED` | 已驳回 | 附 `reject_reason`，可重新提交（同 `out_apply_no`）重提 |

```
提交 ──► AUDITING ──► SUCCESS
            │
            ▼
         REJECTED ──(重新提交)──► AUDITING
```

变更申请状态用于商户信息变更、微信APPID/授权目录配置申请，审核结果以[变更状态查询](../merchant/modify-query)为准。

> [!WARNING]
>
> 商户变更、微信 APPID / 授权目录配置接口**暂未开放**，本状态表仅作规划说明。

## 认证状态（auth\_status）

| 状态 | 语义 |
| - | - |
| `AUTHORIZED` | 认证通过，对应产品可正常交易 |
| `UNAUTHORIZED` | 未认证（可发起认证申请） |
| `CLOSED` | 认证已关闭/注销 |
| `NOTEXIST` | 机构侧无认证记录 |

## 状态与通知

| 状态 | `event_type` | 异步通知 |
| - | - | - |
| 顶层 `AUDITING`、机构层 `SUBMITTED`/`VERIFYING`/`SIGNING` | — | 不下发，以[进件状态查询](https://opendocs.xft.xin/open/payment/merchant/apply-query.md)为准 |
| 顶层 `PASSED`（商户审核通过） | `MERCHANT_PASSED` | 终态下发至 `back_url`，无机构维度 |
| 顶层 `REJECTED`（商户审核驳回） | `MERCHANT_REJECTED` | 终态下发至 `back_url`，无机构维度 |
| 机构层 `COMPLETED`/`REJECTED`/`FAILED` | `INSTITUTION_COMPLETED`/`INSTITUTION_REJECTED`/`INSTITUTION_FAILED` | 终态下发至 `back_url`，带 `institution_code` |

通知报文与重试约定见[审核异步通知](https://opendocs.xft.xin/open/payment/merchant/apply-notify.md)。

> [!NOTE]
>
> 认证申请状态（`apply_status`）为平台统一英文码（各机构原始码已由平台映射，不透出数字码），取值见[认证结果查询](https://opendocs.xft.xin/open/payment/auth/apply-query.md#认证申请状态)。


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