Docusign嵌入式签名未显示收件人视图仅展示管理员视图问题求助

直接触发原因：收件人匹配参数不一致 #

使用嵌入式签名时，创建信封时的Signer参数、创建收件人视图的RecipientViewRequest参数、实际发往Docusign的API请求参数三者必须完全一致，才能精准匹配到指定签名人，你当前的参数存在多处不匹配：

• 创建Signer时的参数：邮箱xzr@gmail.com、姓名abc、client_user_id123
• 代码中填写的RecipientViewRequest参数：邮箱xzr@gmail.com、姓名xyz、client_user_id123（姓名已和Signer参数不匹配）
• 实际发出的create_recipient_view请求体参数：邮箱xyz@gmail.com、姓名Shilpa、clientUserId123（邮箱、姓名均和Signer参数完全不匹配）
  参数不匹配时Docusign无法定位到对应收件人，就会默认使用当前API授权的管理员身份打开签名链接，和你遇到的现象完全吻合。

深层配置问题：JWT模拟身份规则不满足 #

如果你需要以指定签名人身份操作信封，还需要检查JWT授权逻辑：

• 确保你的集成应用申请的权限scope包含impersonation和signature，缺少impersonation权限无法开启身份模拟
• DsClient.update_token()方法获取JWT令牌时，请求参数中的sub（用户ID）必须设置为你要模拟的目标签名人的Docusign用户ID，不能固定填写管理员的用户ID
• 确保目标签名人已对你的集成应用授予模拟权限，要么是用户单独完成授权流程，要么是组织管理员给应用开启了全域模拟同意

修复步骤 #

1. 统一所有签名人参数：保证创建Signer时的email、name、client_user_id，和创建RecipientViewRequest时的三个参数完全一致，同时排查代码逻辑，确保实际发出的API请求参数和代码中填写的参数一致，没有变量覆盖、赋值错误的问题
2. 调整JWT令牌获取逻辑，根据当前要操作的用户动态修改JWT请求中的sub参数值
3. 测试阶段可先将RecipientViewRequest的authentication_method改为email，避免因身份校验配置问题导致额外异常

内容的提问来源于stack exchange，提问作者Shilpa-RD