使用DocuSign.eSign REST API签署后跳转指定URL及绕过默认页面问题

可以绕过DocuSign的默认页面直接跳转到指定URL，按以下步骤排查配置：

• 优先设置签署人级别的重定向地址
  在创建信封的API请求里，给每个签署人添加recipientRedirectUrl参数，这个设置的优先级高于品牌级配置，能确保签署完成后直接跳转。示例JSON片段：

  "recipients": {
    "signers": [
      {
        "email": "signer@example.com",
        "name": "Test Signer",
        "recipientId": "1",
        "clientUserId": "123", // 嵌入式签署必填
        "recipientRedirectUrl": "https://your-target-url.com"
      }
    ]
  }
  

  要是用的是嵌入式签署（带clientUserId），这个参数会直接跳过后续的DocuSign页面。

• 检查品牌配置的跳转触发选项
  进入Account/Settings/Brands/[你的品牌]/Destination Url，确认"Signing completed"的URL配置正确，并且必须勾选**"Redirect immediately after signing"**——这个选项默认可能没开，会导致显示保存副本页面。

• 确认BrandLock配置生效
  信封里的brandLock要设为true，保证信封强制使用你配置的品牌规则，不会继承默认品牌的设置。示例配置：

  "brandId": "your-brand-id",
  "brandLock": true
  

• 关闭签署后的注册邀请提示
  若签署人是首次使用DocuSign，系统会弹出注册邀请，可在品牌的Destination Url设置区域，关闭**"Show sign-up prompt after signing"**选项来禁用这个提示。

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