> ## 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`（渠道商编码）唯一标识 |
| 商户进件                       | 渠道商将其发展的商户提交至平台，平台审核通过后商户进件成功                   |
| 商户主体（`type`）               | 商户的营业执照主体类型：1=企业、2=个体工商户、3=事业单位、4=政府、5=小微、6=其他  |
| 结算主体（`settlement_subject`） | 商户结算款的收款主体：1=对公、2=法人对私、3=非法人对私                  |

## 单号与标识

| 名词                          | 说明                                                                                               |
| --------------------------- | ------------------------------------------------------------------------------------------------ |
| `out_apply_no`              | 申请单号：渠道商生成的业务幂等键，同一渠道商下唯一；进件提交、查询、修改均以此定位申请单                                                     |
| `apply_no`                  | 平台申请单号：平台受理进件后生成的申请单号，在进件提交响应与审核通知中返回，供渠道商向平台报障时使用                                               |
| `modify_code`               | 平台变更申请单号：平台受理商户变更申请（信息变更、微信APPID/授权目录配置）后生成的申请单号，供渠道商向平台报障时使用                                    |
| 认证申请号                       | 微信/支付宝认证配置域的申请单号，由认证申请接口（`/v1/merchant/auth/req`）返回，与进件域的 `apply_no` 相互独立，见[认证申请](../auth/apply) |
| `merchant_code`             | 平台商户号：商户进件成功后由平台分配，全局唯一                                                                          |
| `institution_merchant_code` | 机构商户号：商户进件到指定支付机构后，由机构返回的机构侧商户号                                                                  |
| `sub_merchant_code`         | 微信/支付宝子商户号：渠道进件成功后由机构侧返回（微信 sub\_mch\_id / 支付宝 smid），在进件通知中下发                                    |
| `product_code`              | 平台产品码：支付产品唯一标识（如 `WECHAT_JSAPI`），详见[产品清单](../appendix/products)                                  |

## 接口相关

| 名词             | 说明                                                             |
| -------------- | -------------------------------------------------------------- |
| `app_key`      | 渠道商签名凭据：32 位十六进制字符串，请求头 `Client-Id` 的值，用于平台定位渠道商身份与密钥          |
| `app_secret`   | 渠道商签名密钥：与 `app_key` 配对，用于 HMAC-SHA256 签名计算，**务必妥善保管，不得泄露**     |
| `back_url`     | 审核结果异步通知地址：进件提交时必填，平台在终态（SUCCESS/REJECTED）时回调该地址，必须为 HTTPS     |
| `key`          | 对象存储 Key：图片上传接口返回，进件提交时与 `category` 搭配引用，7 天内有效                |
| `category`     | 附件类别编码：标识图片用途（营业执照、法人身份证等），编码表见[枚举值说明](../appendix/enums)      |
| `timestamp`    | 秒级时间戳：签名头与业务字段统一使用，精确到秒                                        |
| `X-Request-Id` | 请求链路标识：每个请求全局唯一，响应头恒带，失败响应 body 中亦有 `request_id` 字段；渠道商报障时凭此定位 |

## 状态相关

| 名词             | 说明                                                                              |
| -------------- | ------------------------------------------------------------------------------- |
| `apply_status` | 进件申请状态：AUDITING/PROCESSING/SUCCESS/REJECTED/CLOSED，见[状态机说明](../appendix/status) |
| `auth_status`  | 商户认证状态：AUTHORIZED/UNAUTHORIZED/CLOSED/NOTEXIST，见[状态机说明](../appendix/status)     |