DocuSign对接:签署接口调用、H5打开合同及签署状态获取咨询
DocuSign对接技术问题解答
以下是对应对接问题的明确结论和实现说明:
- 调用send and sign类接口跳过确认步骤直跳签署页:支持。构造请求时给对应签署方的收件人节点传入
clientUserId字段,将该签署方标记为嵌入式签署用户;后续调用生成签署视图的接口时传入你自有系统的回跳地址returnUrl,接口返回的链接打开后会直接进入签署页面,不会触发额外的确认步骤。如果漏填clientUserId字段,会走默认的邮件通知+身份确认流程,无法直跳。 - 不通过邮件转发、直接在H5端打开合同:支持。只要给签署人配置了
clientUserId,DocuSign默认不会给该签署人发送合同通知邮件,你拿到接口返回的签署URL后,直接在H5端通过页面跳转、webview嵌入的方式打开即可,完全不依赖邮件链路。注意生成的签署URL有效期为5分钟,过期后需要重新调用接口生成,不要提前过长时间预生成。 - 获取各签署方的签署状态:支持。有两种实现方式:一是主动调用信封查询接口,传入信封ID即可拉取该信封下所有签署方的细分状态,包括待签署、已查看、已签署、拒签等;二是在后台配置webhook回调地址,签署方状态发生变更时DocuSign会主动推送状态数据到你的服务,不需要定时轮询。
业务场景可行性确认
- 自有系统提交订单后直接跳转DocuSign签署URL的交互方案完全可行,属于DocuSign标准的嵌入式签署场景,用户签署完成后会自动跳回你提前配置的业务地址,整个流程不需要跳出你的业务链路。
- 两位签署方的场景下通过API获取双方签署状态没有功能限制,只要是你账号下创建的信封,不管签署方数量多少,都可以通过接口查询全量签署人的状态数据。
内容的提问来源于stack exchange,提问作者Vincent
相关产品推荐
相关产品推荐

