docusignapi - 嵌入式签名流程返回 ttl_expired 状态

Question

我已经实现了 DocuSign 的 Embedded signing flow与我们的应用程序。我们的用例:我们应用程序的客户向必须签署文件的客户发送带有链接的电子邮件。那是我们的应用程序链接。单击电子邮件后，我们将打开 DocuSign(在我们应用程序的 IFrame 中)并打开 url，如下所示:

https://demo.docusign.net/Signing/startinsession.aspx?t=776a1a9c-72c6-4c62-9243-2807db18f78a

如果用户点击链接并完成签名/拒绝一切正常。在其他地方，用户打开一个链接，什么都不做，然后立即重新打开一个链接 DocuSign 发送 ttl_expired 状态。如果用户在一段时间后单击链接，我会得到相同的响应 - 比如说 1 小时。

正如我在网上找到的，对于这个流程:

• Recipient Tokens expire five minutes after they are issued by DocuSign. If a Recipient Token URL is invoked after it is expired, the user is re-directed to the Callback URL specified in the RequestRecipientToken request with event code TTLExpired.
• Recipient Tokens expire upon being successfully invoked.
• Active Recipient Tokens expire if the envelope is voided. Developer Guide 85
• Five minutes is the default "Time to Live" for Recipient tokens. This is a configurable setting.

Source

如果是这样，哪个DocuSign流程可以满足我们的用例，或者我必须在现有流程中进行更改？

Answer 1

每次遇到此错误时，您无需创建新信封。事实上，这是一个错误的决定，因为这将开始消耗您 DocuSign 帐户计划允许的每月信封限制。

相反，如果您生成一个签名 URL 并且收件人打开它但没有签名并关闭并且最终需要返回并签署该信封，您可以简单地生成一个新的收件人 View (签名 URL)。

对于新生成的 URL，同样的规则适用......如果他们在 5 分钟内没有使用它或者他们打开但没有再次签名，你将需要创建一个新的 URL token ，但这比浪费好得多一个全新的信封。这仅算作一次额外的 API 调用，每个账户每小时允许调用 1,000 次。