嵌入式签名流程返回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小时。

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

  

  
• 收件人代币在DocuSign签发后五分钟到期。如果在过期后调用收件人令牌URL，则会将用户重定向到RequestRecipientToken请求中指定的回调URL，事件代码为TTLExpired。
  
• 收件人代币在成功调用后到期。
  
• 如果信封无效，则Active Recipient Tokens将过期。   开发人员指南85
  
• 默认为五分钟＆＃34;生存时间＆＃34;对于收件人令牌。这是一个可配置的设置。
  

Source

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

Answer 1

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

相反，如果您生成签名URL并且收件人打开它但没有签名并关闭并最终需要重新登录并签署该信封，您只需生成新的收件人视图（签名URL）即可。

使用新生成的URL，相同的规则适用...如果他们在5分钟内没有使用它们或者他们打开但不再签名，则需要创建一个新的URL令牌，但这很多比浪费一个全新的信封更好。这只是一个额外的API调用，每个帐户允许每小时1,000个。

Answer 2

检索到的网址是一次性使用，并在5分钟后过期。一旦Docusign检测到您已加载检索到的URL，它将不再有效。如前面的答案所述，如果你没有在5分钟内加载它，它也将不再起作用。 ttl_expired代码将出现在两种情况下。

如果已使用或已过期，您只需再次请求签名网址。 不重新创建信封。