Skip to main content

流程总览

商户进件分四个阶段:渠道商上传图片 → 提交商户信息 → 平台审核 → 审核通过异步通知回调

阶段一:上传图片

进件所需证件图片(营业执照、法人身份证、门店照片等)先通过图片上传接口逐张上传,获得对象存储 key
key 7 天内有效,过期需重新上传。上传时指定 category(附件类别编码),进件提交时只需上送 category + key 即可引用,无需按图片字段名逐张对应。

阶段二:提交商户信息

调用商户进件提交接口,提交商户主体、法人、联系人、经营地址、结算账户、图片与产品信息(图片以 key 引用),out_apply_no 作为业务幂等键。 提交后平台异步受理,立即返回 apply_no(平台申请单号)与 apply_status=AUDITING不保证同步进件完成

阶段三:平台审核

平台审核人员对进件资料进行人工审核(校验素材完整性、合规性)。此阶段可通过进件状态查询轮询状态:
  • 审核通过:平台完成商户进件(分配 merchant_code),随后向指定支付机构进件(未上送 institution_codes 时由平台分配);商户进件完成、渠道进件进行中 apply_status=PROCESSINGsub_merchant_code 未就绪),渠道进件完成 apply_status=SUCCESSsub_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(注销/终止)为二期状态,详见状态机说明