流程总览
商户进件分四个阶段:渠道商上传图片 → 提交商户信息 → 平台审核 → 审核通过异步通知回调。阶段一:上传图片
进件所需证件图片(营业执照、法人身份证、门店照片等)先通过图片上传接口逐张上传,获得对象存储key。
key 7 天内有效,过期需重新上传。上传时指定 category(附件类别编码),进件提交时只需上送 category + key 即可引用,无需按图片字段名逐张对应。阶段二:提交商户信息
调用商户进件提交接口,提交商户主体、法人、联系人、经营地址、结算账户、图片与产品信息(图片以key 引用),out_apply_no 作为业务幂等键。
提交后平台异步受理,立即返回 apply_no(平台申请单号)与 apply_status=AUDITING,不保证同步进件完成。
阶段三:平台审核
平台审核人员对进件资料进行人工审核(校验素材完整性、合规性)。此阶段可通过进件状态查询轮询状态:- 审核通过:平台完成商户进件(分配
merchant_code),随后向指定支付机构进件(未上送institution_codes时由平台分配);商户进件完成、渠道进件进行中apply_status=PROCESSING(sub_merchant_code未就绪),渠道进件完成apply_status=SUCCESS(sub_merchant_code就绪);机构侧返回的机构商户号以institution_merchant_code标识; - 审核驳回:
apply_status=REJECTED,附reject_reason(标注平台驳回/渠道驳回)。
阶段四:审核通过异步通知回调
平台在**终态(SUCCESS/REJECTED)**时向back_url 异步下发审核结果,见审核异步通知:
- 通知报文需验签(
X-Signature等头信息,与开放平台签名算法一致); - 接收方须在 5 秒内应答 HTTP 2xx,否则平台按指数退避重试(最多 5 次);
- 通知携带
apply_no等字段,接收方按out_apply_no/apply_no幂等处理(终态可能重复送达)。
中间态(AUDITING/PROCESSING)不下发通知,以进件状态查询为准;通知最终失败落库,可联系平台补发。
前置条件
渠道商在星富通管理后台完成入驻后,获得:app_key/app_secret(签名凭据,见签名验签说明);- 渠道商产品模板与支付机构配置(进件时指定
institution_codes,不传由平台分配)。
驳回重提
审核驳回(REJECTED,附reject_reason)后,渠道商按驳回原因修改资料,通过商户进件提交接口重新提交(同 out_apply_no + 完整资料,图片已过期的重新上传),平台以本次提交覆盖原申请单,重新进入待审核(AUDITING)。
不同商户主体的进件差异
完整必填差异见商户进件提交与图片类型编码表。
状态流转
CLOSED(注销/终止)为二期状态,详见状态机说明。
