通用名词
| 名词 | 说明 |
|---|---|
| 渠道商（服务商） | 通过开放平台录入商户并与平台合作的机构，以 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 | 平台申请单号：商户录入响应与进件状态查询顶层返回（首机构进件申请单号），供报障使用；institutions[].apply_no 为各机构进件申请单号，是签约信息查询的请求键 |
modify_code | 平台变更申请单号：平台受理商户变更申请（信息变更、微信APPID/授权目录配置）后生成，供报障使用。变更类接口暂未开放 |
| 认证申请号 | 微信/支付宝认证配置域的申请单号，由认证申请接口返回，与进件域的 apply_no 相互独立，见认证申请 |
merchant_code | 平台商户号：商户录入受理即分配，全局唯一 |
institution_code | 支付机构编码：进件目标支付机构的平台编码，见支付机构列表 |
institution_merchant_code | 机构商户号：商户进件到指定支付机构后，由机构返回的机构侧商户号 |
wechat_sub_merchant_code / alipay_sub_merchant_code | 微信/支付宝子商户号：渠道进件完成后由机构侧返回，在进度查询与异步通知中下发 |
product_code | 平台产品码：支付产品唯一标识（如 WECHAT_JSAPI），详见产品清单 |
接口相关
| 名词 | 说明 |
|---|---|
app_key | 调用方签名凭据：请求头 Client-Id 的值，用于平台定位身份与密钥 |
app_secret | 调用方签名密钥：与 app_key 配对，用于 HMAC-SHA256 签名计算，务必妥善保管，不得泄露 |
back_url | 审核结果异步通知地址：商户录入时必填，平台在终态回调该地址，必须为 HTTPS |
key | 对象存储 Key：图片上传接口返回，商户录入时与 category 搭配引用，7 天内有效 |
category | 附件类别编码：标识图片用途（营业执照、法人身份证等），编码表见枚举值说明 |
timestamp | 双层语义：签名头 Timestamp 为秒级时间戳；业务响应中的 timestamp 为字符串，格式 yyyy-MM-dd HH:mm:ss（北京时间） |
状态相关
| 名词 | 说明 |
|---|---|
apply_status（顶层） | 商户入驻申请状态：AUDITING/PASSED/REJECTED，见状态机说明 |
apply_status（机构层） | 单机构进件申请状态：SUBMITTED/VERIFYING/SIGNING/COMPLETED/REJECTED/FAILED，见状态机说明 |
merchant_status | 商户业务状态：INACTIVE/ACTIVE/PENDING/FROZEN/CANCELED |
sign_status | 电子签约状态：NOT_CREATED/PENDING/SIGNING/SIGNED/REJECTED/LOCKED/EXPIRED/FAILED/UNKNOWN，见签约信息查询 |
auth_status | 商户认证状态：AUTHORIZED/UNAUTHORIZED/CLOSED/NOTEXIST，见状态机说明 |