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

# 名词解释

## 通用名词

| 名词 | 说明 |
| - | - |
| 渠道商（服务商） | 通过开放平台录入商户并与平台合作的机构，以 `partner_code`（渠道商编码）唯一标识 |
| 品牌 | 归属渠道商的品牌商户，以品牌编码标识；品牌调用开放接口时使用其所属渠道商的费率档与配置 |
| 调用主体 | 当前 app\_key 对应的身份：渠道商或品牌，决定可访问的商户范围 |
| 商户录入 | 调用主体将商户主体、法人、联系人、结算、图片与产品费率录入平台（受理即建商户），审核通过后由平台发起机构进件 |
| 进件 | 平台审核通过后，按 `institutions` 逐机构向支付机构提交商户开通申请并跟进至完成 |
| 商户主体（`merchant_type`） | 商户的执照主体类型：`ENTERPRISE`=企业、`INDIVIDUAL`=个体工商户、`PUBLIC_INSTITUTION`=事业单位、`GOVERNMENT`=政府、`MICRO`=小微、`OTHER`=其他 |
| 结算主体（`settlement_subject`） | 商户结算款的收款主体：`CORPORATE`=对公、`LEGAL_PERSON`=法人对私、`NON_LEGAL_PERSON`=非法人对私 |

## 单号与标识

| 名词 | 说明 |
| - | - |
| `out_apply_no` | 申请单号：调用方生成的业务幂等键，同一调用主体下唯一；商户录入、查询、变更均以此定位申请单 |
| `apply_no` | 平台申请单号：商户录入响应与[进件状态查询](https://opendocs.xft.xin/open/payment/merchant/apply-query.md)顶层返回（首机构进件申请单号），供报障使用；`institutions[].apply_no` 为各机构进件申请单号，是[签约信息查询](https://opendocs.xft.xin/open/payment/merchant/sign-info.md)的请求键 |
| `modify_code` | 平台变更申请单号：平台受理商户变更申请（信息变更、微信APPID/授权目录配置）后生成，供报障使用。变更类接口暂未开放 |
| 认证申请号 | 微信/支付宝认证配置域的申请单号，由认证申请接口返回，与进件域的 `apply_no` 相互独立，见[认证申请](https://opendocs.xft.xin/open/payment/auth/apply.md) |
| `merchant_code` | 平台商户号：商户录入受理即分配，全局唯一 |
| `institution_code` | 支付机构编码：进件目标支付机构的平台编码，见[支付机构列表](https://opendocs.xft.xin/open/payment/appendix/institutions.md) |
| `institution_merchant_code` | 机构商户号：商户进件到指定支付机构后，由机构返回的机构侧商户号 |
| `wechat_sub_merchant_code` / `alipay_sub_merchant_code` | 微信/支付宝子商户号：渠道进件完成后由机构侧返回，在进度查询与异步通知中下发 |
| `product_code` | 平台产品码：支付产品唯一标识（如 `WECHAT_JSAPI`），详见[产品清单](https://opendocs.xft.xin/open/payment/appendix/products.md) |

## 接口相关

| 名词 | 说明 |
| - | - |
| `app_key` | 调用方签名凭据：请求头 `Client-Id` 的值，用于平台定位身份与密钥 |
| `app_secret` | 调用方签名密钥：与 `app_key` 配对，用于 HMAC-SHA256 签名计算，**务必妥善保管，不得泄露** |
| `back_url` | 审核结果异步通知地址：商户录入时必填，平台在终态回调该地址，必须为 HTTPS |
| `key` | 对象存储 Key：图片上传接口返回，商户录入时与 `category` 搭配引用，7 天内有效 |
| `category` | 附件类别编码：标识图片用途（营业执照、法人身份证等），编码表见[枚举值说明](https://opendocs.xft.xin/open/payment/appendix/enums.md) |
| `timestamp` | 双层语义：签名头 `Timestamp` 为秒级时间戳；业务响应中的 `timestamp` 为字符串，格式 `yyyy-MM-dd HH:mm:ss`（北京时间） |

## 状态相关

| 名词 | 说明 |
| - | - |
| `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) |
| `merchant_status` | 商户业务状态：`INACTIVE`/`ACTIVE`/`PENDING`/`FROZEN`/`CANCELED` |
| `sign_status` | 电子签约状态：`NOT_CREATED`/`PENDING`/`SIGNING`/`SIGNED`/`REJECTED`/`LOCKED`/`EXPIRED`/`FAILED`/`UNKNOWN`，见[签约信息查询](https://opendocs.xft.xin/open/payment/merchant/sign-info.md) |
| `auth_status` | 商户认证状态：`AUTHORIZED`/`UNAUTHORIZED`/`CLOSED`/`NOTEXIST`，见[状态机说明](https://opendocs.xft.xin/open/payment/appendix/status.md) |


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