DocuSign API：签名完成后如何配置用户重定向或API回调？

没错，你的理解完全到位！在创建信封时配置eventNotification就是实现这两个需求的标准方案，我给你拆解下具体怎么操作：

一、用户完成签名后重定向至你的应用 #

要实现签名后的前端跳转，核心是在eventNotification里配置returnUrl参数：

• 直接把returnUrl设为你的应用页面地址，用户完成签名流程后会被自动重定向到这里
• 你还可以在returnUrl里拼接自定义参数，比如信封ID、用户ID等，方便回到应用后做后续业务处理，示例：https://your-app.com/sign-complete?envelopeId=XXXXXX
• 额外提醒：如果需要确保DocuSign收到你的回调确认，可以把requireAcknowledgment设为true，但这不影响returnUrl的跳转逻辑，两者是独立的

二、触发你的API端点（Webhook回调） #

这部分是eventNotification的核心用途，通过配置以下参数来实现：

• url：填写你的API端点地址，DocuSign会在信封状态变更时向这个地址发送POST请求，携带信封的完整状态数据
• events：指定你需要监听的事件类型，比如只关心签名完成的话，就设置为["completed"]，避免接收不必要的回调通知
• 安全配置：建议开启includeCertificateOfCompletion获取完成证书，同时设置hmacSecret生成请求签名，你的后端可以通过这个签名验证请求确实来自DocuSign，防止伪造请求

简化的请求体示例 #

下面是创建信封时包含eventNotification的JSON请求体片段：

{
  "emailSubject": "请签署这份文档",
  "templateId": "你的模板ID",
  "templateRoles": [
    {
      "email": "signer@example.com",
      "name": "签名人姓名",
      "roleName": "Signer"
    }
  ],
  "eventNotification": {
    "url": "https://your-api.com/webhook/docusign",
    "returnUrl": "https://your-app.com/sign-success",
    "events": ["completed"],
    "requireAcknowledgment": true,
    "includeCertificateOfCompletion": true,
    "hmacSecret": "你的加密密钥"
  },
  "status": "sent"
}

几个注意事项 #

• 你的回调端点必须是公网可访问的，开发环境可以用内网穿透工具来测试
• DocuSign的回调请求超时时间是10秒，你的后端要快速返回200响应，复杂业务逻辑建议异步处理
• 测试阶段可以先监听sent、delivered等事件，确认回调通道正常后再切换到completed事件

内容的提问来源于stack exchange，提问作者Mauri1OA