[Account Owner] Get Started with eSignatures: Enabling/Disabling (DocuSign)
In This Article:
AdvicePay's DocuSign integration allows you to connect your existing DocuSign account to get financial planning agreements and other documents signed as part of your payment requests or independently. Easily access your templates through AdvicePay and become more efficient instantly!
How to Enable
To enable: Go to Firm Settings > eSignature and click Enable eSignature:
Select that you want to turn on eSignatures on your account using DocuSign:
You will be prompted to log in to DocuSign to link your account to AdvicePay:
Click Accept to allow AdvicePay to create and send documents on your behalf, and obtain links for signing:
And that's it! Once enabled, all firm advisors with billing permissions in AdvicePay can send out templates you've added to your DocuSign account.
Enable Signer PIN
1. Under Firm Settings > eSignature toggle Enable signer PIN to on
2. Click Save
When this feature is turned on and Recipient Authentication is enabled in DocuSign, the signee will receive an email letting them know that they have a document that requires signature. Once they click on the View and Sign button in the email, they will be taken to a DocuSign screen (see example below) where they will see the phone number the PIN will be sent to.
Signees will need to click on the Send SMS button to receive a SMS message via the phone number listed. Once the PIN has been entered into the box, signees will be taken immediately to the document to sign.
Enabling a signer PIN will only apply to future documents sent. 😀 Any existing documents already sent out for signature at the time of modifying this setting will not require signers to enter a PIN.
- Advisors can add a new client attribute named phone number under Firm Settings > Client. Once Advisors add phone numbers in the client's profile under the Clients tab, AdvicePay will auto populate the phone number when Advisors go to send the document.
- When sending a document, Advisors will see the requirement to enter in a phone number (if there is not one already auto populated from the attribute in the client's profile).
- A phone number cannot be edited once the document has been sent. If a phone number was added incorrectly, the document would need to be canceled and re-sent.
How to Enable Recipient Authentication in DocuSign
For SMS authentication to work properly, this feature also requires Recipient Authentication to be enabled under DocuSign's Security Settings. Here's how to do that!
1. Ensure Signer PIN is enabled (see above).
2. Navigate to your DocuSign Authentication Settings ( Security Settings > Authentication Settings) and enable your Recipient Authentication Triggers to Every time a recipient accesses an envelope.
This setting ensures that every time the signed document is viewed, it will require SMS authentication.
How to Reconnect Authorization
If for some reason the connection with your linked DocuSign account were to break, you can easily reestablish the integration by navigating to Docusign Authorization and clicking Reconnect.
Doing this will prompt the Account Owner for the Docusign login credentials again!
Template Setup Tips
Take advantage of more advanced options -- like auto-populated (or pre-filled) fields -- to make a stellar template!
To set up fields that automatically populate when the document is sent out for signature:
- When creating or editing a template in DocuSign, go to Pre-fill Tools and place a Text field into your document template.
- In the field's drop down menu under under Sender Permissions, ensure that Mandatory is unchecked unless this template will ALWAYS have the item required (e.g. an attached payment request, an upfront invoice, etc). See the callout below for more info!
- In the field's drop down menu under Data Label, enter one of the following as written:
- advicepay_client_name -- when sent, this will auto-populate the printed name of the client signer for that role (as entered in AdvicePay)
- advicepay_engagement_name -- when sent, this will auto-populate the printed name of the engagement template
- advicepay_invoice_amount -- when sent with a payment request, this will auto-populate the invoice amount
- advicepay_invoice_frequency -- when sent with a payment request, this will auto-populate the invoice frequency (e.g. one-time, monthly, etc)
- advicepay_upfront_invoice_amount -- when sent with a payment request, this will auto-populate the upfront invoice amount for one-time invoices attached to subscriptions
- advicepay_due_date -- when sent with a payment request, this will auto-populate the due date
Please note that if you mark a pre-filled Text field as Mandatory and we do not have information to populate for the item that is required, when a signer goes to sign it will say “the document may still be in drafts” and they won't be able to proceed. (For example, if a field for "advicepay_upfront_invoice_amount" is Mandatory but the document is sent when there is no upfront invoice attached, signatures cannot be obtained.)
If a pre-filled field is something that may or may not be filled out depending on the circumstance when sending out the document for signatures, as a best practice we recommend leaving Mandatory unchecked!
How to Disable eSignature
Visit Firm Settings > eSignature and toggle Enable eSignature to off. Then confirm that you want to disable!
This will remove the ability to attach documents with payment requests. If you had open documents out for signature, signing will no longer be required before a client makes a payment.
If you have signed or voided documents, they will still be viewable!
1. Log out of all DocuSign accounts.
2. Disable eSignature in AdvicePay by visiting Firm Settings > eSignature and toggling Enable eSignature to off. Then confirm that you want to disable.
3. Re-enable eSignature at Firm Settings > eSignature by clicking Enable eSignature.
More context on how the DocuSign integration works
Pass this info on to your IT team!
AdvicePay uses Docusign’s OAuth 2.0 Authorization Code flow to act on behalf of a Docusign user. When you enable Docusign in your Firm Settings, we’ll request the “extended” and “signature” scopes so we can create envelopes, view envelopes, and send signing requests on your behalf. We don't save your credentials -- in AdvicePay we store the refresh token and access token.
Once you’ve authorized the integration, you’re all set! The systems are connected and you’re ready to send documents.
If you’ve done a Docusign integration in the past, this might sound a little different than what you’re used to. Following Docusign’s best practices, AdvicePay uses a single integration key and relies on the OAuth flow to give us permissions to act on behalf of your user. This means that you don’t need to do any complex key configuration in your Docusign instance. It just works. 🙂
When an advisor is ready to send a new document from AdvicePay, we’ll request the available templates for the Docusign user and present that to the advisor as a list.
Once the advisor has set up the signers, we’ll give them the option of sending the document right away or saving it as a draft and entering the embedded Docusign editor so they can edit it before sending.
Behind the scenes, we’re going to create a new envelope via the Docusign API, including a callback URL so Docusign can notify AdvicePay of status changes to the envelope. When it’s time for a signer to sign, AdvicePay will send an email to them letting them know it’s their turn. Following the link in the email, they’ll be directed into the Docusign embedded signing flow.
Ready to do more with eSignature via DocuSign?
Check out the articles below!