> ## 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\_type

| 取值 | 说明 |
| - | - |
| `ENTERPRISE` | 企业 |
| `INDIVIDUAL` | 个体工商户 |
| `PUBLIC_INSTITUTION` | 事业单位 |
| `GOVERNMENT` | 政府 |
| `MICRO` | 小微 |
| `OTHER` | 其他 |

## 商户状态 merchant\_status

[商户查询](https://opendocs.xft.xin/open/payment/merchant/merchant-query.md)返回的商户业务状态：

| 取值 | 说明 |
| - | - |
| `INACTIVE` | 未生效 |
| `ACTIVE` | 正常 |
| `PENDING` | 待审核 |
| `FROZEN` | 冻结 |
| `CANCELED` | 已注销 |

> [!NOTE]
>
> 商户业务状态由[商户查询](https://opendocs.xft.xin/open/payment/merchant/merchant-query.md)返回，与进件状态（`apply_status`）相互独立。审核维度（待审核/审核通过/审核驳回）由独立的 `audit_status` 字段承载。

## 变更类型 change\_type

| 编码 | 说明 |
| - | - |
| `02` | 基础信息变更 |
| `03` | 法人信息变更 |
| `04` | 联系人信息变更 |
| `05` | 结算信息变更 |

> [!WARNING]
>
> 商户变更接口（商户信息变更、变更状态查询、微信 APPID / 授权目录配置）**暂未开放**，上述编码仅作内部规划说明，请勿据此接入。

## 结算主体 settlement\_subject

| 取值 | 说明 |
| - | - |
| `CORPORATE` | 对公 |
| `LEGAL_PERSON` | 法人对私 |
| `NON_LEGAL_PERSON` | 非法人对私 |

## 结算周期 settlement\_cycle

| 取值 | 说明 |
| - | - |
| `D1` | 次日结算（自然日） |

> [!NOTE]
>
> 目前仅支持 D1，其余周期暂不开放。

## 费率类型 fee\_items\[].fee\_type

| 取值 | 说明 |
| - | - |
| `FLAT` | 固定费率 |
| `FLAT_CAPPED` | 固定费率+封顶 |
| `TIERED_CAPPED` | 阶梯费率+封顶 |

> [!NOTE]
>
> 费率值 `val` 为十万分比（例：0.6% → 600，即 `"320"` = 0.32%）；阶梯费率（`TIERED_CAPPED`）按 `min_amt`/`max_amt` 区间逐档上送多条。

## 图片类型 category

`category` 取值为平台附件类别编码，完整编码表（含必传场景）见[图片上传](https://opendocs.xft.xin/open/payment/merchant/file-upload.md#图片类型编码表)：

| category | 说明 | 必传场景 |
| - | - | - |
| `1` | 营业执照 | 企业/个体工商户必传 |
| `2` | 法人身份证正面 | 必传 |
| `3` | 法人身份证反面 | 必传 |
| `4` | 联系人身份证正面 | 联系人不复用法人时必传 |
| `5` | 联系人身份证反面 | 联系人不复用法人时必传 |
| `6` | 门店内景照 | 必传 |
| `7` | 门头照 | 必传 |
| `8` | 银行卡正面照 | 对私结算必传 |
| `9` | 工作人员与商户负责人合影 | 选填 |
| `10` | 商户协议 | 选填（线下签约时） |
| `11` | 开户许可证 | 对公结算必传 |
| `12` | 其他补充资料 | 选填 |
| `13` | 非法人结算授权书 | 企业非法人结算必传 |
| `14` | 结算人身份证正面 | 选填 |
| `15` | 结算人身份证反面 | 选填 |
| `16` | 证书照片 | 选填 |
| `17` | 单位证明函 | 事业单位/政府必传 |
| `22` | 统一社会信用代码证书 | 事业单位/政府/小微/其他必传 |
| `99` | 其他 | 选填 |

## 状态枚举

| 枚举 | 取值 | 说明 |
| - | - | - |
| `apply_status`（顶层） | AUDITING / PASSED / REJECTED | 商户入驻申请状态，见[状态机说明](https://opendocs.xft.xin/open/payment/appendix/status.md) |
| `apply_status`（机构层） | SUBMITTED / VERIFYING / SIGNING / COMPLETED / REJECTED / FAILED | 单机构进件申请状态，见[状态机说明](https://opendocs.xft.xin/open/payment/appendix/status.md) |
| `auth_status` | AUTHORIZED / UNAUTHORIZED / CLOSED / NOTEXIST | 认证（授权）状态，见[认证结果查询](https://opendocs.xft.xin/open/payment/auth/apply-query.md) |
| `apply_status`（认证申请） | 见[认证结果查询](https://opendocs.xft.xin/open/payment/auth/apply-query.md)的状态说明 | 平台统一认证申请状态 |
| `state`（子商户） | INACTIVE / ACTIVE / FAILED / PROCESSING / CLOSED | 子商户功能开通状态，见[子商户信息查询](https://opendocs.xft.xin/open/payment/auth/sub-merchant.md) |
| `cancel_status` | CANCELED / FAILED | 认证撤销结果，见[撤销认证](https://opendocs.xft.xin/open/payment/auth/cancel.md) |


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