How to add multiple signers on a single document using docusign REST API Embedded Signing - docusignapi

I have a web application developed which we want to sign a sales contract pdf from the end customer. It’s a responsive web application which can be used from desktop/laptop, tablet or mobile phones.
I am trying to implement Embedded Signing with multiple signer using docusign REST API.
So the flow in my app is the following:-
Dealer goes to the sold to party and sold to party will sign.
Dealer goes to the payer and payer will sign.
And finally dealer will do the final signing and all the signer will receive the signed document via mail.
My app status-
I have successfully created signing url for first signer and signing is completed and returning to my web page.
But for the second signer i want to sign on the first signer url.But it is redirecting to web page.
My scenario is -
Is this possible without opening three recipients views - one for the sold to party, one for the payer and one for dealer? Can we achieve this just by opening one view where all recipients can sign the order with mobile verification authentication?
In one signing url all the signer will complete the sign process with mobile verification authentication.
I tried to add a single recipient with three signing boxes with mobile verification authentication. But after complete the first signer it is returning to main web page.
Please check this scenario also-
My question is is there any way this is possible? I am assuming that it isn't since each envelope id can really only relate to a single signer. It doesn't even make sense to me how a second signer could sign the same document with the same envelope id and put in different data and it maintain the integrity of both signers since envelope id seems to be a sort of session for the document.
Please help me Thanks.

No, you have to open separate signing ceremonies for each signer. Each captive recipient (for embedded signing) is defined by their email, name, and clientUserId. ClientUserId needs to be unique to each individual, such as a customerId in your system. If you don't have a unique identifier for each person, then simply use their email address.
You should also consider how you will validate the identity of the person signing and link it to the DocuSign signing, since DocuSign is not sending an email link for validating who was invited in. You can link that data using the additional parameters for the createRecipient Envelope View API call, i.e. assertionId, authenticationInstant, authenticationMethod, and securityDomain.

Related

Docusign Embedded Signing , How can sender share the “recipient signing URL” with multiple signer?

I am building a customer web portal or a self-service platform, one of the features of the portal is for customer to upload required documents. Customer would have to go through full authentication to access the web portal to upload required documents and perform other functions.
I want to embed DocuSign and use its signature capabilities for customer to fill out forms and provide signatures. Some of the documents requires multiple signatures from legal parties of an organization.
My questions:
How do I send DocuSign to multiple signers?
Would each signer have to authenticate to the portal to sign documents or is there a way DocuSign can route document to the signers without all of them authenticating to the portal?
Each signers/recipient can have their own unique URL which is different based on the recipient involved.
You can have multiple recipients sign the same document/envelope and each of time can sign, either in turn, or whenever based on the routing order.
URLs for signing should not be shared, as they are private for the signer.
Your app can either embed the URL inside, or if you would rather use remote signing, then each recipient would get an email with the link to sign.
There's no need for signers to authenticate, unless you wish them to do so, which is certainly more secure, but not a requirement of DocuSign.
Here is a code example for embedded signing in 7 languages.
Here is a code example for remote signing in 7 languages.

Using docusign EnvelopeViews: createSender as preview

createSender creates a URL, which I would like to use to let the sender preview the document before it's send out. Hence the documents are created using templates and and the API.
The link which is created would lead me out of my UI. Does the user need to sign in? Future plan is to have many user's, which have no DocuSign account.
For embedded sending Your app will have to authenticate the user. If you are doing a Service Integration then your Api account will be used as the sender.
Once the sending url is generated using the createSenderView api, there is no authentication required to access the URL.
You also have an option to build a User Application using the docusign Api where your App can support sending from multiple accounts.
The createSenderView requires that the person is a DocuSign user (with their own account and password).
Only DocuSign users can send. We charge for sending, not for signing or receiving.
What exactly do you want to preview? (And why?)
the documents themselves? Use the EnvelopeDocuments resource. You can also preview the thumbnails of the documents.
the documents with the "fields" ("tabs") that indicate where people will sign? I'm not sure that is do-able.
or the recipients and their routing order? Use EnvelopeRecipients: list method.
Added
Another solution is to use a dummy certified delivery "recipient". Add this recipient as the first recipient. This will block the envelope from proceeding on the recipient routing.
Then get the envelope's documents to show as a preview.
Then, if ok, alter the envelope's recipients to remove the certified delivery recipient. The envelope will then continue on with the first "real" recipient.

Getting an embed url for an already created docusign envelope

In docusign is it possible to create a signing request via the web interface and then retrieve the sigining URL via the API
at the moment, I update the Envelope using the API to attach a clientUserID as this is lacking when created via the web interface.
Then I retrieve the signing view url however, there is no signing tab when navigating to that url. The only action I have is to close.
I have tested using the API and the envelope contains signing tabs so I'm not sure what the issue would be.
Any help would be much appreciated!
When you send a DocuSign envelope if you assign one or more tabs to your recipient it becomes what's known as a Free Form signing experience, where the recipient decides where to sign the document.
On the other hand if you specify one or more tabs for the recipient then it's a Guided Signing experience. In guided signing the recipient can only sign and take actions at the tabs the sender has specified.
It sounds like you are successfully creating the envelope and signing URL but that there are no tabs configured for the signer. If that's the case you should confirm your code is identifying the recipient correctly by specifying the name, email, recipientId, and clientUserId values.
I would also check that the tabs are being set in your request body correctly for the given recipient. First get the recipient information for the envelope using the EnvelopeRecipients: list API to ensure the data is what you expect, then generate the signing URL using the corresponding data.

DocuSign Embedded Signing Workflow

Using this python example from github as an example, I wrote an R package for interacting with the DocuSign embedded signing API.
I don't appear to fully understand the workflow for embedded signing, and I am hoping someone can help.
Here is what I would like:
I have an application with a sign up page. When users sign up I would like them to sign a document. So when they submit the sign up form, I generate an envelope using a template, and use their name and email in the templateRole parameter. I get a URL which I send the user to, which allows them to sign the document.
It appears though that the actual workflow involves sending an email to the signer first, and having them sign from a link in the email. This does not seem very "embedded" so I am a bit confused. Is this because I am using the sandbox API?
I see that that there is an authenticationMethod parameter, which takes values of either email, or HTTPBasicAuth or Password or PaperDocuments. Is this the reason it is using email instead of directly sending the user to a page where they can sign because I am chooseing email as the authenticationMethod?
Have I fundamentally misunderstood embedded signing?
The script you are referencing is for Embedded Sending.
The Embedded Sending view of an envelope allows users to edit the tabs, documents, recipients, and other settings of draft envelopes before sending them out for approval
So you are basically giving the Signer access to potentially modify the envelope(Add more signers, remove documents etc). The sender view should never be presented to the Signer.
If you are looking for Embedded Signing, then see this code
Embedded Signing - or the Recipient View workflow - allows users to sign directly through your app or website. When you embed your recipients you are telling the DocuSign platform your app will generate signing URLs, authenticate your recipients, present the signing request, and re-direct once the transaction is complete.

Create an envelope without sending an email to signer

I'm working on a C#.net website and using DuoSecurity services to request electronic signatures. I want the users to sign the documents trough my web site so I decided to use the embedded signing feature.
To use this feature, you first need to create an envelope, but while creating an envelope I'm required to enter the signer's email address so DocuSign sends him an email with a link to the document, but I don't want this email to be sent.
To make it short, is there any way to create a DocuSign envelope without having DocuSign send an email to the signer? (I don't mind entering the signer's email, I have all the required information, it's just that for security purposes I don't want the end-user to receive the document URL trough email).
If not, is there any way to use the embedded signing feature without creating an envelope (I doubt it, but I really need a way to upload a document to DocuSign without them sending an email to the signer).
Thanks in advance,
The system will not send them an email if you are using Embedding functionality. To make use of Embedding and generate a URL token for a given envelope you need to set the clientUserId property for your recipients.
When the clientUserId property is present and its value is not null no email is sent to the recipient (only the envelope complete email gets sent once signing is done, but that is configurable). Basically the only thing you have to remember with embedding is that you set the clientUserId property for your recipients at the time they are added to the envelope, then when you are request a URL token you need to reference the same email, name, and clientUserId combination.
You're two best resources on this are the Embedding API Walkthroughs (see the bottom 3):
http://iodocs.docusign.com/APIWalkthroughs
And the DocuSign Dev Center page on Embedding functionality:
Features -> Embedding

Resources