> ## Documentation Index
> Fetch the complete documentation index at: https://opendocs.xft.xin/llms.txt
> Use this file to discover all available pages before exploring further.

# 签约信息查询

## 功能说明

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

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

**支持商户**：全部已开通进件权限的渠道商（及其旗下品牌）

**请求方式**：`POST`

**请求路径**：`/openapi/v1/merchant/sign/info`

## 请求参数

| 字段 | 是否必填 | 字段类型 | 字段说明 |
| - | - | - | - |
| `apply_no` | 是 | String(≤64) | 机构进件申请单号，取自[进件状态查询](https://opendocs.xft.xin/open/payment/merchant/apply-query.md)的 `institutions[].apply_no` |

## 响应参数

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

## 状态说明

| 状态 | 语义 | 建议动作 |
| - | - | - |
| `NOT_CREATED` | 合同未创建 | 等待平台发起签约，稍后重查 |
| `PENDING` | 待签约 | 将 `sign_url` 转交商户完成签约 |
| `SIGNING` | 签署中 | 等待商户完成签署，稍后重查 |
| `SIGNED` | 已签约 | 签约完成 |
| `REJECTED` | 已拒绝 | 联系平台处理 |
| `LOCKED` | 锁定代签 | 联系平台处理 |
| `EXPIRED` | 已过期 | 联系平台重新发起签约 |
| `FAILED` | 签约失败 | 联系平台处理 |
| `UNKNOWN` | 未知或机构不支持 | 易宝恒为该值；其他机构出现时联系平台排查 |

## 示例

**请求**

```json theme={"system"}
{
  "apply_no": "APL26101808571000003"
}
```

**响应（待签约）**

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

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

```json theme={"system"}
{
  "sign_status": "UNKNOWN",
  "sign_url": "",
  "contract_no": ""
}
```

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

```json theme={"system"}
{
  "code": 400,
  "reason": "NOT_FOUND",
  "message": "记录不存在",
  "metadata": {}
}
```

> [!NOTE]
>
> 签约状态为按需实时查询机构侧结果，平台不缓存；轮询间隔建议不低于 30 秒。签约完成后机构进件状态才会推进至 `COMPLETED`，进度变化以[进件状态查询](https://opendocs.xft.xin/open/payment/merchant/apply-query.md)或[审核异步通知](https://opendocs.xft.xin/open/payment/merchant/apply-notify.md)为准。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.