如何在React网页应用中捕获签名并通过DocuSign自动应用发送文档？
2026-6-12
该工作流的可行性与DocuSign实现方案
这个工作流完全可以通过DocuSign实现，核心思路是先让用户完成签名的创建/采用并关联至其DocuSign账户，后续发起签署请求时直接调用该签名完成自动签署，无需用户重复操作。以下是两种具体实现方案：
方案一：嵌入DocuSign签名采用UI（官方推荐）
- 集成方式：在React页面中通过DocuSign的Client SDK或iframe加载Signature Adoption UI，引导用户一次性创建并确认自己的签名样式。这个UI支持手绘、输入文字生成签名等多种方式。
- 核心操作：用户完成签名采用后，该签名会自动保存到用户的DocuSign账户中。后续创建签署信封时，只需在签署方配置中指定
defaultSignatureId参数为该签名的ID，DocuSign就会自动使用该签名完成签署流程。 - 关键API：
- 生成签名采用嵌入URL：调用
POST /v2.1/accounts/{accountId}/signature_adoptions接口，获取可嵌入React页面的UI地址，让用户完成签名采用。 - 获取用户签名列表：调用
GET /v2.1/accounts/{accountId}/users/{userId}/signatures接口，获取用户已保存的签名ID。 - 创建自动签署信封：在创建信封的请求体中，为目标签署方添加
defaultSignatureId字段，值为上述获取的签名ID，同时确保签署方的邮箱、姓名与关联签名的用户信息一致。
- 生成签名采用嵌入URL：调用
方案二：自定义签名画布捕获并上传签名
- 集成方式：在React项目中使用第三方签名画布库（如
react-signature-canvas）捕获用户手绘签名，将画布内容转为Base64编码的图片格式。 - 核心操作：将捕获的签名图片上传至DocuSign，关联到用户账户并设置为默认签名。后续创建信封时同样指定该签名ID实现自动签署。
- 关键API：
- 上传用户签名：调用
POST /v2.1/accounts/{accountId}/users/{userId}/signatures接口，将Base64格式的签名图片上传，接口返回该签名的ID。 - 创建自动签署信封：同方案一，在信封创建请求中为签署方配置
defaultSignatureId，同时可设置signerMustSign为false，确保流程自动完成。
- 上传用户签名：调用
重要注意事项
- 身份授权：必须通过DocuSign的OAuth 2.0或JWT授权方式，获取用户账户的操作权限，才能访问用户签名资源和创建信封。
- 信息匹配：创建信封时，签署方的邮箱、姓名必须与上传/采用签名的用户信息完全一致，否则无法自动匹配签名。
- 合规要求：需确保用户已明确同意使用该签名完成后续签署操作，符合电子签名的合规规范。
内容的提问来源于stack exchange，提问作者Varun
相关产品推荐
相关产品推荐
