流程总览
商户录入与进件分四个阶段：上传资料图片 → 录入商户 → 平台审核并按机构进件 → 终态异步通知。阶段一：上传资料图片
录入所需证件图片（营业执照、法人身份证、门店照片等）先通过图片上传接口逐张上传，获得对象存储key。
key 7 天内有效，过期需重新上传。上传时指定 category（附件类别编码），录入时只需上送 category + key 即可引用，无需按图片字段名逐张对应。阶段二：录入商户
调用商户录入接口，提交商户主体、法人、联系人、经营地址、结算账户、图片与逐机构产品费率，out_apply_no 作为业务幂等键。
- 受理即建商户：接口立即创建商户并返回
merchant_code、apply_no与apply_status=AUDITING，不等待审核与机构进件； - 必须指定进件机构：
institutions必填（至少 1 个），逐个指定支付机构及其产品费率，平台不做兜底分配； - 重复提交幂等：同一调用主体、同一
out_apply_no重复提交返回原申请单当前状态，不报错、不重复建商户。
阶段三：平台审核与机构进件
平台审核人员对资料进行人工审核。此阶段可通过进件状态查询轮询：- 审核通过：顶层
apply_status=PASSED。按渠道商配置决定是否自动发起进件：开启自动进件时，平台自动向institutions指定的每个机构发起进件；未开启时由平台运营手动发起。各机构进度独立，在institutions[]中逐机构返回：SUBMITTED=已提交 →VERIFYING=核身中 →SIGNING=签约中 →COMPLETED=已完成；- 机构驳回
REJECTED、进件失败FAILED； - 进件完成后返回
institution_merchant_code、wechat_sub_merchant_code、alipay_sub_merchant_code、terminal_code等结果字段。
- 审核驳回：顶层
apply_status=REJECTED，附reject_reason。
顶层状态反映商户审核结果，机构层状态反映单机构进件进度，两层独立；某一机构失败不影响其他机构进件，也不会把顶层状态改为驳回。完整取值见状态机说明。
阶段四：异步通知回调
平台在终态向back_url 异步下发结果，见审核异步通知：
- 商户审核通过：
event_type=MERCHANT_PASSED，无机构维度； - 商户审核驳回：
event_type=MERCHANT_REJECTED，无机构维度； - 机构维度终态：
event_type=INSTITUTION_COMPLETED/INSTITUTION_REJECTED/INSTITUTION_FAILED，报文带institution_code，逐机构各发一条； - 通知请求带签名头（
Client-Id/Signature-Type/Timestamp/Nonce-Str/Signature），签名算法与开放平台请求签名一致； - 接收方须在 10 秒内返回 HTTP 200，且 body 为
{"code":"SUCCESS","message":"成功"}（code必须为SUCCESS）；其他状态码或业务码不符视为失败，平台按1s → 5s → 30s → 2min → 6min退避重试，最多 5 次； - 通知按
out_apply_no+institution_code+apply_status幂等，终态可能重复送达，请按该键去重。
中间态（审核中、进件处理中）不下发通知，以进件状态查询为准；通知最终失败落库，可联系平台补发。
前置条件
渠道商/品牌在星惠付管理后台完成入驻后，需具备：app_key/app_secret（签名凭据，见签名验签说明）；- 渠道商费率档：渠道商须已在平台配置各「机构 × 产品」的代理费率，商户录入费率必须在该档位内（见结算周期及手续费说明），否则整体拒绝。
驳回重提
审核驳回（REJECTED，附 reject_reason）后，渠道商按驳回原因修改资料，使用新的 out_apply_no 重新调用商户录入接口（图片已过期的重新上传）。原 out_apply_no 一经受理不再重开，重复提交只会返回原申请单状态。
不同商户主体的进件差异
状态流转
顶层（商户入驻申请，apply_status）
institutions[].apply_status）