跳到主要内容

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

服务热线
15010993257