DocuSign API: Redirection Issues with Envelope Authentication View URLs

0
votes

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:

  • When logged in to DocuSign (valid browser session), the redirection URL successfully ends up at the prepare Envelope URL.
  • When signed out, the redirection URL takes the user to a sign in page, and after signing in, redirects to the homepage.

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.

2
authenticationdocusignapienvelope

2 Answers

1
votes

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 [email protected] 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

0
votes

Your step 2 is not right...

Do you want an embedded sending view for the envelope before it is sent to recipients?

Use EnvelopeViews::createSender

Also, what to you want to happen during the sending view? What is your use case? (Please update/edit your question with the added info.)

Or an embedded signing view? -- The signing ceremony?

Use EnvelopeViews::createRecipient