通用名词
| 名词 | 说明 |
|---|---|
| 渠道商（服务商） | 通过开放平台向星富通进件商户的合作机构，以 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 相互独立，见认证申请 |
merchant_code | 平台商户号：商户进件成功后由平台分配，全局唯一 |
institution_merchant_code | 机构商户号：商户进件到指定支付机构后，由机构返回的机构侧商户号 |
sub_merchant_code | 微信/支付宝子商户号：渠道进件成功后由机构侧返回（微信 sub_mch_id / 支付宝 smid），在进件通知中下发 |
product_code | 平台产品码：支付产品唯一标识（如 WECHAT_JSAPI），详见产品清单 |
接口相关
| 名词 | 说明 |
|---|---|
app_key | 渠道商签名凭据：32 位十六进制字符串，请求头 Client-Id 的值，用于平台定位渠道商身份与密钥 |
app_secret | 渠道商签名密钥：与 app_key 配对，用于 HMAC-SHA256 签名计算，务必妥善保管，不得泄露 |
back_url | 审核结果异步通知地址：进件提交时必填，平台在终态（SUCCESS/REJECTED）时回调该地址，必须为 HTTPS |
key | 对象存储 Key：图片上传接口返回，进件提交时与 category 搭配引用，7 天内有效 |
category | 附件类别编码：标识图片用途（营业执照、法人身份证等），编码表见枚举值说明 |
timestamp | 秒级时间戳：签名头与业务字段统一使用，精确到秒 |
X-Request-Id | 请求链路标识：每个请求全局唯一，响应头恒带，失败响应 body 中亦有 request_id 字段；渠道商报障时凭此定位 |