签约信息查询 - 星惠付开放平台

功能说明

查询单个机构进件申请单的电子签约状态、签约链接与合同号。机构进件进入签约环节后，渠道商可凭本接口获取签约进度；sign_url 非空时引导商户完成线上签约。

请求键为机构进件申请单号：apply_no 取自进件状态查询响应的 institutions[].apply_no，不是商户录入时的 out_apply_no；
仅可查询本主体录入的商户申请单（渠道商可查询旗下品牌录入的商户），否则返回 403 PERMISSION_DENIED；申请单不存在返回 400 NOT_FOUND；
各机构能力不同：付临门返回完整签约信息；易生返回签约状态与合同号（不返回签约链接）；易宝无签约查询能力，恒返回 UNKNOWN。

支持商户：全部已开通进件权限的渠道商（及其旗下品牌） 请求方式：POST 请求路径：/openapi/v1/merchant/sign/info

字段	是否必填	字段类型	字段说明
`apply_no`	是	String(≤64)	机构进件申请单号，取自进件状态查询的 `institutions[].apply_no`

字段	是否必填	字段类型	字段说明
`sign_status`	是	String	签约状态：`NOT_CREATED`=合同未创建/`PENDING`=待签约/`SIGNING`=签署中/`SIGNED`=已签约/`REJECTED`=已拒绝/`LOCKED`=锁定代签/`EXPIRED`=已过期/`FAILED`=签约失败/`UNKNOWN`=未知或机构不支持
`sign_url`	否	String	签约链接，引导商户完成线上签约；仅部分机构（付临门）返回，其余机构为空
`contract_no`	否	String	电子合同编号；机构未返回时为空

请求

{
  "apply_no": "APL26101808571000003"
}

响应（待签约）

{
  "sign_status": "PENDING",
  "sign_url": "https://esign.example.com/sign?token=xxxx",
  "contract_no": "CT20261018000001"
}

响应（易宝，机构不支持查询）

{
  "sign_status": "UNKNOWN",
  "sign_url": "",
  "contract_no": ""
}

失败示例（申请单不存在）

{
  "code": 400,
  "reason": "NOT_FOUND",
  "message": "记录不存在",
  "metadata": {}
}

签约状态为按需实时查询机构侧结果，平台不缓存；轮询间隔建议不低于 30 秒。签约完成后机构进件状态才会推进至 COMPLETED，进度变化以进件状态查询或审核异步通知为准。