authenticationdocusignapienvelope

DocuSign API: Redirection Issues with Envelope Authentication View URLs


We have a DocuSign integration that allows our customers to sign their documents in DocuSign. Here are the steps we follow:

  1. We create a new document envelope by hitting the Envelopes: create endpoint.
  2. Using the Envelope ID from previous step, we hit the EnvelopeViews: createConsole endpoint to get a redirection URL. We get a URL that looks like this:

    https://demo.docusign.net/Member/StartInSession.aspx?StartConsole=1&t=[GUID]&DocuEnvelope=[ENVELOPE_ID]

  3. We redirect our user to the redirection URL from previous step.

Expected behaviour: the redirection URL should take our user to the Envelope draft page, i.e. /prepare/<ENVELOPE_ID> Observed behaviour: user ends up on DocuSign homepage.


We were able to observe the problem when user is not signed into DocuSign, and tries to navigate to the redirection URL:

ps. We have been using the same work flow with no problems in that past. This issue was brought to our attention a few days ago. (Feb 15 2020)

pps. All users are affected by this issue.


Solution

  • DocuSign has had a few reports of this behavior. The issue is being tracked under ticket number EC-2126 - I'd recommend reaching out to your account team to have your info added to that ticket. If you have a web account, you can email go-live@docusign.com with that issue number and your account ID to have it added.

    For the time being, the recommendation is to instead use the CreateSenderView call: https://developers.docusign.com/esign-rest-api/reference/Envelopes/EnvelopeViews/createSender