Inline signature stream returns ttl_expired status
I have applied DocuSign inline subscription flow with our application. Our use case: A client of our application sends an email with a link to the client who needs to sign the document. This is our application. When we click on the email, we open DocuSign (in the IFrame of our application) and open the URL like this:
https://demo.docusign.net/Signing/startinsession.aspx?t=776a1a9c-72c6-4c62-9243-2807db18f78a
If the user clicks on the link and finishes subscribing / canceling, everything goes OK. Elsewhere, the user opens the link, does nothing, and reopens the link. DocuSign sends status ttl_expired. The same answer I get if the user clicks on the link after a while - say 1 hour.
As I found online, for this thread:
- Recipients' tokens expire five minutes after they are issued by DocuSign. If the recipient-recipient URL is called after it expires, the user is redirected to the callback URL specified in the RequestRecipientToken with the TTLExpired event ID.
- Recipients tokens expire after a successful call.
- Active recipient tokens expire if the envelope is canceled. Developer Guide 85
- Five minutes is the default Time to Live for recipient tokens. This is a custom setting.
If so, which DocuSign stream can satisfy our use case or do I need to change something in the existing stream?
source to share
You don't have to create a new envelope every time you encounter this error. In fact, this is a bad decision as it will start feeding according to your monthly envelope limits that are allowed in your DocuSign account plan.
Instead, if you create a signature url and the recipient opens it but doesn't sign or close it and eventually needs to go back and sign that envelope, you can simply create a new recipient view (signature url).
The same rules apply with the newly generated url ... if they don't use it for 5 minutes or they open but don't subscribe again, you will need to create a new url token, but much better than wasting a whole new envelope ... It just counts as one of the extra API calls that are allowed 1000 per hour per account.
source to share
The resulting URL is used once and expires after 5 minutes. Once Docusign detects that you have downloaded the resulting URL, it will no longer work. As stated in the previous answer, if you haven't downloaded it within 5 minutes, it won't work anymore either. In both cases, the ttl_expired code will appear.
You just need to request the signing URL again if it is in use or has expired. Do not recreate the envelope.
source to share