合同签署回调通知

# 说明

* 回调通知使用http服务进行通知，被通知方响应HTTP状态码为 `2xx`即认为通知成功
* 为了保障异步通知的可靠性，建议业务方在回调请求处理中，尽可能减少业务操作，改用异步方式处理后续业务流程,系统在 `30`秒内未得到回应则判断为失败并进行重试。
* 重试次数共15次，每次重试时间间隔如下：
	10s、10s、30s、1m、3m、6m、10m、30m、1h、1h30m、2h、2h、2h、2h、2h

# 通知参数

| 参数名 | 类型 | 说明 |
| --- | ---- | --- |
| action| enum | 用于区分通知的类型，参考`Action`     |
| body   | object |  对应`action`的不同对象，可参考末尾的"附件.zip"代码    |

# Action

## `VERIFY_FACTORS`
### 说明
签署人要素验证结果通知
### 通知BODY参数

| 参数名 | 类型 | 说明 |
| --- | --- | --- |
| contractDocumentsNumber | string | 合同文档编号 |
| verified | boolean | 是否验证成功 |
| way | string | 要素验证方式，Bank4Factors 银行卡四要素；Telecom3Factors 运营商三要素，Base2Factors 基础二要素 |
| reason | string | 失败原因 |

## `SIGNATORY_SIGNED`
###  说明
每一个合同在签署人签署后进行通知
### 通知BODY参数

| 参数名 | 类型 | 说明 |
| --- | ---- | --- |
| contractDocumentsNumber | 合同文档编号 |
| contractNumber | 合同编号 |
| templateNumber | 模版编号 |
| bizData | 合同业务数据 |
| contractUrl | 合同链接 |
| signatoryIdNumber | 签署人证件号 |
| signatoryType | 签署人类型：/** * 自然人 */PERSONAL,/** * 企业 */CORPORATE,/** * 平台自身 */PLATFORM; |
| facePhotoUrl | 签署人人脸（仅自然人有） |
| signTime | 签署时间 |

## `CONTRACT_SIGNED`
### 说明
合同所有签署人签署完后通知
### 通知BODY参数
| 参数名 | 类型 | 说明 |
| --- | ---- | --- |
| contractDocumentsNumber | string | 合同文档编号 |
| contractNumber | string | 合同编号 |
| templateNumber | string |模版编号 |
| bizData | string | 合同业务数据 |
| contractUrl | string | 合同链接 |

## `CONTRACT_DOCUMENTS_SIGNED`
### 说明
文档中所有合同签署完后通知
### 通知BODY参数

| 参数名 | 类型 | 说明 |
| --- | ---- | --- |
| contractDocumentsNumber | string | 合同文档编号 |
| contracts | array[object] | 合同列表，参考`CONTRACT_SIGNED`参数 |

## `REPORT`
### 说明
出证报告，只有模版关联了证据字典并进行申请后才会回调
### 通知BODY参数

| 参数名 | 类型 | 说明 |
| --- | --- | --- |
| signatoryIdNumber | string | 签署人证件号 |
| signatoryType | string | 签署人类型 |
| contractDocumentsNumber | string | 合同文档编号 |
| contractNumber | string | 合同编号 |
| templateNumber | string | 模版编号 |
| bizData | string | 业务数据 |
| contractUrl | string | 合同地址 |
| reportUrl | string | 报告地址 |

## `CONTRACT_DOCUMENTS_CANCELED`
### 说明
合同集取消，用户拒签、程序主动取消等情况会触发通知
### 通知BODY参数

| 参数名 | 类型 | 说明 |
| --- | --- | --- |
| contractDocumentsNumber | string | 合同文档编号 |
| reason | string | 取消原因 |
## 附件

[【附件】body.zip](/media/attachment/2024/10/body.zip)