回调通知服务 FAQ
什么是异步回调通知?
当合同状态发生变化(如发起、签署、完成等),开放签会向您的回调地址推送 JSON 数据,实现合同状态同步。
回调地址应满足哪些要求?
- 必须为完整的 HTTPS 地址(如
https://yourdomain.com/api/callback); - 必须支持 POST 方法;
- 返回值必须为字符串
"success",否则触发重试机制; - 推荐部署 HTTPS 加密服务保障数据安全。
回调失败会重试吗?
- 系统立即重发 3 次;
- 若仍失败,按 30 分钟、2 小时、24 小时频率继续推送;
- 超过 24 小时未成功,系统停止推送。
回调事件类型
| 事件类型 | 说明 |
|---|---|
| SEND_SIGNING | 发起签署 |
| SUBMIT_WRITE | 员工提交填写 |
| REFUSAL_WRITE | 员工拒填 |
| SUBMIT_SIGN | 签署完成 |
| REFUSAL_SIGN | 签署被拒 |
| RECALLED | 合同撤回 |
| DELETE | 合同删除 |
| COMPLETE | 合同完成 |
| EXPIRED | 合同过期 |
| SIGN_FAILED | 签署失败 |
| DOCUMENT_DELAY | 修改签署截止时间 |


