快速开始
集成 / SDK
用户验证
企业验证
交易监控
更新日志签名等级
高级（AES）仅支持 PAdES 格式签署。对于 AES，
signature_format 取值 xades 和 cades 会被拒绝并返回 signature_format_not_supported。在保存 AES 步骤之前，请检查工作流上的 signature_availability：当 aes 为 false 时，保存新步骤将返回 400 及 aes_not_available。
工作原理
1
对于高级（AES），工作流会先验证签署人
在高级（AES）等级下，签名步骤将在确立签署人身份的步骤之后运行：包括身份证件验证，以及对用于接收验证码的邮箱或电话号码进行邮箱验证或电话验证。请参阅准备工作。简单等级不需要任何前置步骤。
2
Didit 准备文件
当签署人进入该步骤时，Didit 会将文件及其字段复制到会话中，并记录每份文件的 SHA-256。之后对工作流的更改不会影响当前签署人所看到的内容。
3
签署人逐一查看文件
对于包含字段的文件，签署人将被引导按顺序填写各个字段。他们只需设置一次签名，该签名就会应用到所有签名和姓名缩写字段，同时他们需要填写文本和复选框字段。Didit 从已验证的身份、会话或您的系统中获取的字段值已预先填入页面。对于没有字段的文件，他们阅读并同意即可。
4
对于高级（AES），签署人使用验证码进行确认
当任何文件包含字段时，签署人首先需要同意以电子方式签署文件。在高级（AES）等级下，Didit 随后会向他们在会话前期验证过的邮箱或电话发送一个六位数验证码，输入该验证码即可授权签署该步骤中的所有文件。在简单等级下则没有验证码：同意即授权签名。
5
Didit 进行签署和盖章
Didit 会填入签署日期，将所有字段值盖印到每份 PDF 中，并附加证据页。在高级（AES）等级下，随后会应用 PAdES 签名和时间戳，使签名覆盖页面上的所有内容。在简单等级下，生成的文件是带有证据页的 PDF，不包含数字签名、印章或时间戳。
6
您获取结果
决策和会话 Webhook 会携带包含签署人、确认信息、证书、时间戳、每份文件哈希值及每个字段值的
signatures[]。您可以下载已签署的 PDF 和证据 PDF，Didit 也可以向签署人发送电子邮件副本。开始之前
在高级（AES）级别下，签名人必须在签署前完成验证。Didit 会从会话自身的已验证记录中提取其姓名和联系方式，绝不使用您或签名人输入的任何内容。简单级别无需这些：它不包含身份证件验证、邮箱验证、电话验证或验证码功能，且不适用于 KYB 签名人。 对于用户验证（KYC），请在工作流中的电子签名之前添加以下步骤：- 身份证件验证，状态为已通过，且包含可读姓名。若未完成该验证，电子签名步骤将记录
SIGNATURE_IDENTITY_NOT_VERIFIED。 - 当验证码通过电子邮件发送（默认方式）时需要邮箱验证；当通过短信发送时需要电话验证。验证码仅会发送至在同一会话中验证过的联系方式。
- 如果工作流中还包含活体检测，则其状态必须为已通过。
KYB 步骤包含 1 到 20 位签名人，每位签名人在签署时都必须拥有已通过的 KYC。每位签名人签署属于自己的文件副本，并通过发送至其本人 KYC 会话中已验证联系方式的验证码进行确认。为关键人员申报的姓名必须与其已验证姓名一致（忽略大小写和空格），否则该步骤将记录
SIGNATURE_NAME_MISMATCH。一旦所有签名人均已签署或已拒绝，该步骤即告完成。
文档
文档来源
signature_documents_source 设置步骤获取文档的来源：
按会话指定的文档适用于让用户签署已由您的系统预填好其姓名、金额或条款的合同。
支持的文件
当您上传 Word 文档时，Didit 会在上传过程中将其转换为 PDF，最多耗时 60 秒。转换后的页面即为签署人查看和签署的内容，因此在放置字段之前请先进行检查：换行可能与 Word 中略有不同。Word 文件及其 PDF 属于同一文档，并会随文档一同删除。证据 PDF 会记录此次转换以及两个文件的 SHA-256 哈希值。
当待签署内容存在歧义时，Didit 会拒绝 Word 文件并返回
signature_document_not_supported 及对应的 reason：包含宏（macros）、未接受的修订（tracked_changes）、外部内容链接（external_links）或嵌入对象（embedded_objects）。请在上传前接受或拒绝所有修订，以确保 PDF 显示的是您确认一致的文本。
无法转换的文件将被拒绝并返回 signature_document_conversion_failed 以及以下原因之一：
文档上的字段
字段将文档转换为签署人需要填写的模板，类似于在桌面端签署工具中准备签署信封的方式。没有字段的文档保持更简单的流程：签署人只需阅读并同意即可。
此版本暂无日期选择器。对于签署人输入的日期，请使用
text 字段。
字段具有以下属性：
role_not_used。在文档上拥有字段的每个角色都必须在该文档上至少包含一个 signature 或 initials 字段，否则工作流版本无法发布（signature_field_missing）。
验证
validation 适用于 text 字段：
kind：any；letters（任何文字系统中的字母、空格、连字符和撇号）；number（带有可选小数分隔符的数字）；email；或pattern。min_length：从0到max_length。max_length：从1到500。默认值为120。pattern：当kind: "pattern"时为必填项。最多 200 个字符的正则表达式，整个值必须与该表达式匹配。不支持环视和反向引用。message：最多 120 个字符，用于替代默认错误消息。
预填值
prefill 指定字段值的来源：
data 字段必须包含 prefill。full_name 字段始终使用 identity.full_name，email 字段使用 contact.email，而 text 字段也可以设置一个。data、full_name 和已验证的 email 字段的值在签署人开始签署时即已固定：会话后续发生的更改不会改变这些值。除非您设置了 editable_when_prefilled，否则预填的 text 或 email 字段为只读状态。
当必填字段的来源在当时没有值（例如会话中没有地址）时，该字段将保持为空，签署人仍可继续签署。系统不会触发警告，报告中的 value_unavailable_reason 会说明原因。
在控制台中进行设置
- 前往工作流，打开一个工作流，并在验证签署人的步骤之后添加电子签名步骤。
- 在文件中，选择上传以添加 PDF 或 Word 文件，并拖动文件以调整签署人看到的顺序。Word 文件会转换为 PDF：在放置字段之前，请先检查转换后的页面。替换会替换文档文件并保留其字段，但新文件中已不存在的页面上的字段除外。
- 在在文件上放置字段下，选择打开编辑器。从面板中将字段拖动到页面上，或选中字段后点击要放置的位置，然后移动并调整其大小。针对每个字段，设置填写人、其标签、是否为必填、接受的内容、其值的来源以及其 API 密钥（字段的
key）。以签署人身份预览可以展示签署人在手机或桌面上看到的文件效果。编辑器会在操作过程中自动保存（已保存到草稿），并在您选择完成之前列出需要修复的内容。 - 仍是在文件中，选择文件的来源：此工作流、每次会话或两者。对于没有字段的文件，选择签署人是否必须签署前阅读至末尾并每份文件单独同意。
- 在签名中，选择签署人、级别（简单为默认值，或高级（AES）；合格（QES）显示为即将推出）、格式以及验证码发送方式（一次性验证码发送方式）。
- 在规则中，设置每个警告对结论的影响。
- 在高级中，选择是否通过电子邮件发送已签署副本以及添加证据页，并设置签署链接的有效天数。您还可以添加自定义状态规则。
- 保存工作流。
签署体验
签署步骤可在托管验证页面、Web SDK 和原生 SDK 中运行，支持桌面端和手机端。您无需构建任何签署界面。- 简介。签署人会看到他们即将签署的文件。
- 按顺序查看每份文件。对于包含字段的文件，签署人将按
position顺序填写各个字段。第一个签名或姓名缩写字段会打开一个面板，供其采用签名。可选字段标记为 可选。Didit 预填的值在页面上显示带有锁定图标，不作为填写步骤。点击页面上的字段可直接跳转至该字段。在手机上，一次在保持于键盘上方的面板中显示一个字段。在宽度至少为 1200 px 的屏幕上，文件页面与字段列表并排显示。如果必填字段仍为空便尝试完成文件，系统会提示剩余未填数量并跳转至第一个未填字段。不含字段的文件只需按您的配置进行阅读并同意。 - 审核。签署人再次查看文件，当其中任何文件包含字段时，同意以电子方式签署。
- 验证码（仅限高级电子签名 (AES)）。签署人请求接收验证码。验证码有效期为 5 分钟，60 秒后可重新发送，签署人最多可获取 5 次验证码并允许 3 次错误尝试。次数耗尽将记录为
SIGNATURE_OTP_FAILED。在初级电子签名级别下无需验证码：签署人直接从审核进入签署。 - 已签署。签署完成后，签署人可以下载已签署的文件。如果您启用了该功能，Didit 还会通过电子邮件向其发送一份副本。
- 拒绝。签署人可以选择拒绝而非签署。这将记录为
SIGNATURE_DECLINED。在签署链接有效期间，被拒绝的会话可以重新打开，以便签署人在改变主意时仍能完成签署。
signature_link_validity_days 天内有效（1 到 30 天，默认为 7 天），自会话创建时起算。会话保持开放的时间至少与此相同。
原生 SDK 从添加该功能的版本开始显示签署步骤，该版本在发布时会列在原生 SDK 概述中。包含字段的文件需要支持字段的版本：旧版本无法显示这些字段，并且该步骤会显示错误。不含字段的文件在支持签署步骤的所有版本中均可使用。在您的应用运行支持工作流所用功能的版本之前，请引导用户访问托管页面或 Web SDK。
采用签名
签署人只需在文件首次要求提供签名或姓名缩写时，在一个面板中采用一次自己的签名和姓名缩写：- 键入：以其选择的手写风格显示经过核验的姓名，标记为 来自您的证件。签署人无法键入其他姓名。键入的缩写取自该姓名的首字母。
- 手写：用手指或鼠标绘制，包括签名和姓名缩写。
结果
每位签署人的结果是会话决策以及会话 Webhook 的decision 中 signatures[] 的一个元素。没有单独的签名 Webhook：会话的 status.updated 事件会通知您何时获取决策。
您将获得每份文件的已签署 PDF、每位签署人的证据 PDF，以及每份原始文件和已签署文件的 SHA-256 哈希值，以便您日后证明文件未被篡改。对于包含字段的文件，您还可以获取每个字段的值、其来源和填写时间，以及采用的签名和签署人同意进行电子签名的时间。有关每个字段、下载方式以及如何重新验证签名，请参阅电子签名报告。
在控制台中，会话的 签名 标签页会显示文件，随后是包含每页预览的 字段 区块、采用的签名和姓名缩写，以及每个字段的值、时间和来源。PDF 报告包含签名部分，当文件含有字段时，还包含 电子签名 · 字段 页面。
定价
电子签名每完成一次已签署会话费用为 $0.10，计入您的免费额度中，无论单次签署包含多少份文件，也无论级别是初级还是高级电子签名 (AES)。拒绝、失败或过期的签名不收费。合格电子签名 (QES) 为暂未推出的附加功能，目前尚无定价。删除签名数据
当您删除会话时，其签名数据会随之一并删除：随会话发送的文件及其原始 Word 文件、为每位签署人准备的副本、已签署的 PDF、证据 PDF、采用的签名和姓名缩写图像，以及每个字段的值。其下载链接将失效。当会话在数据保留期结束时被删除，情况亦相同。删除操作不可逆，因此请先下载需要保留的所有内容。- 企业验证的已签署文件属于该企业的会话。删除该会话将一并删除这些文件。
- 从工作流中移除文件会将其彻底删除，连同其字段和原始 Word 文件。已经开始签署的签署人仍会保留其看到的副本（作为其会话的一部分），直到您删除该会话为止。请仅在没有等待签署的会话时从工作流中移除文件。
- Didit 已经通过电子邮件发送给签署人的副本保留在他们的邮箱中，不受影响。