回调通知服务 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 | 修改签署截止时间 |