Skip to content
English
  • There are no suggestions because the search field is empty.

DocuSign Integration Steps

The following is an outline of the steps that will need to be taken to integrate DocuSign into your FLEX system.

Testing Stage

DocuSign requires that the Credit Union (CU) completes 20 test envelopes before they will allow your system to be in production.

Create a Developer Account

DocuSign requires you to create a developer account or “demo account” for the testing stage of the integration.

You can do this by doing the following steps after being signed in to your DocuSign account:

  1. Select “Admin”
  2. Select “Apps and Keys” under “Integrations”
  3. Select “Developer account” on the warning

I:

Once your DocuSign Developer account is created, you will need to begin the integration process. To do this, you’ll go to the same area as your production account (Apps and Keys). From now on, we will refer to the developer account as the Demo account.

We will be bouncing a lot between FLEX JUICE and DocuSign from here on out.

Find Credit Union Key

Now that your Demo Account is set up, you will begin the integration and will need the Credit Union key, here are the steps to find it:

  1. Find the “Account ID” in the Demo account (Picture II) and input it in “eSignature Configuration” (Picture III) in FLEX JUICE. Follow the steps to find the credit union key listed after Picture II.

II:

  1. Open eSignature Configuration
  2. Ensure that the “Testing Mode” radio button is selected
  3. Make sure that “Use OAuth 2” is selected
  4. Select the “OAuth 2 Setup” Button”
  5. Input the “Account ID” from the Demo Account (Picture II) into the “Credit Union Key” Field in the

OAuth 2 setup (Picture III)

III:

Generate an RSA Key

  1. In the Demo account, follow the steps from creating a developer account to get to the “Apps and Keys” section.
  2. Select the “Add App and Integration Key” button. a.
  3. Name the integration “Flex Integration”
  4. Hit “Ok”
  5. Scroll down to “Service Integration”
  6. Select “Generate RSA”, this will open the “RSA Keypair” dialogue a.
  7. Click the copy icon on “Private Key” (please make sure to select private key) a.
  8. Go into “eSignature configuration” in FLEX JUICE.
  9. Paste your RSA Private key into the “RSA Private Key” field
  10. Select “Ok”
  11. Select “Save”
  12. Select “Refresh”
  13. Select “Close” on the RSA Keypair dialogue ensuring to stay within the Flex Integration page of the apps and keys subsection.

Applying the Integration Key

Next, we will apply the integration key from DocuSign to FLEX JUICE:

  1. In DocuSign, still, on the Flex Integration page, scroll up to the “General Info” section where it states the Integration Key.
  2. Select theicon to save the integration key to your clipboard.
  3. Go to the eSignature Configuration window in FLEX JUICE
  4. Paste the integration key into the “Integrator Key” Field a.
  5. Select “Save”
  6. Select “Refresh”
  1. The integration key will stay the same when in production

Redirect URI

Next, we will make sure that the redirection will take place to go to the credit union’s URL:

  1. Go to “Miscellaneous Information” through the FLEX Juice Main Menu a.
  2. Sign in
  3. Go down to page 5
  4. Enter your credit union’s URL. NOTE: This should not be a FLEX URL. a.
  5. Go to the open DocuSign account session under the created FLEX Integration
  6. Scroll down to “Redirect URIs”
  7. Select “Add URI”
  1. Input the URL exactly as it appeared in Miscellaneous Information~
    1. (ie HTTPS://WWW.MYCREDITUNIONSURL.COM)
    2. Again, this should not be a FLEX URL. If incorrect, update your credit union’s homepage. 9. Scroll down to “Save”

User Confirmation

Now, here we will confirm the added users in FLEX JUICE all have access to DocuSign connection. Before we start confirming others, we need to confirm that the Demo Account is set up correctly in DocuSign’s system. To do this follow these steps:

  1. Click on the profile icon in the top right corner
  2. Select “Manage Profile”
    1. This will open a new window
  3. Select “Connected Apps” on the left side
  4. The user should see Flex integrated here
    1. (If it's not showing there, don't freak out, authorizing the account may resolve the issue, proceed to User Authorization for the steps)

User Authorization

To authorize a user, they need to be signed in to their DocuSign account and integrate it with their Teller account.

To do this, you’ll follow these simple steps:

  1. Go to “eSignature Configuration”
  2. Select the “OAuth 2 setup” button
  3. Select “Authorize”
  1. If the authorize button takes the user to an “unable to locate redirect”, don't worry! Follow steps 4 and on instead!
  1. Select “Copy Authorization URL” and then paste the link into a new browser window.
  2. This should bring up an “input password” type dialogue
  3. Once the password is entered, the user will then see “Allow access”
  4. If all has gone smoothly, the user will now be authorized and you should follow the User Confirmation process if not done already.
  5. This process needs to be repeated for each user to have the Demo Account holder send the URL to each individual that has an eSignature Configuration in the DocuSign tab within FLEX JUICE. Each user needs to sign with their username & password on DocuSign, to permit FLEX to use their account. Note: User ID in DocuSign is a User Key in FLEX JUICE.

Test API Calls

Once all users are confirmed and authorized, it is now time to move into the testing stage of the integration. DocuSign requires that the Demo User sends 20 test envelopes (DocuSign calls them calls) to move into production. To do so, the users will send envelopes through the “Print Forms” section of a member's account. If the 20 consecutive envelopes have gone through and are showing within the Demo Account API dashboard, the user is ready to go into production. If not, we will have to troubleshoot where the client went wrong.

Production Stage

Now that all the Test APIs have been completed, it is time to go live. The next sections will go over how to go from testing mode to production.

Going Live

Once the Test APIs are done, you will see in the dashboard that all 20 test APIs are completed (hopefully). To go live into production, it will be the same process as setting up the testing stage. Here are the steps to begin going live:

  1. Scroll down to the “Apps and Keys” section of the Demo account (shown in steps 1 &2 of Create a Developer Account)
  2. Select the “Actions” button, then “Start Go-Live review” a.
  3. The Go-Live review can take up to 20 minutes to complete but on average has taken less than 60 seconds.

They should see a “Review Pending” Status.

  1. Have the User refresh the page. If it is successful, it should state “App is live” a.
  2. Once the app is live, you will select “Actions” again on the integration, then “Select Go-Live Account”
  3. The user will then select their main DocuSign account and then sign in by choosing their production account.
  4. Now they will go to the main DocuSign.

Find Production Credit Union Key

Now that the Go-Live Account has been selected, you will begin the completion of the integration and will need the Production Credit Union key, here are the steps to find it:

Locate “Account ID” in the Production account (Picture II) and input it in “eSignature Configuration” (Picture III) in FLEX JUICE. Follow the steps to find the credit union key listed after Picture II.

II:

  1. Open eSignature Configuration
  2. Ensure that the “Production Mode” radio button is selected
  3. Make sure that “Use OAuth 2” is selected
  4. Select the “OAuth 2 Setup” Button”
  5. Input the “Account ID” from the Demo Account (Picture II) into the “Credit Union Key” Field in the

OAuth 2 setup (Picture III)

III:

Generate an RSA Key

  1. In the Production account, follow the steps from creating a developer account to get to the “Apps and Keys” section.
  2. Select “Actions” on the integration
  3. Select “Edit”
  4. Select “Generate RSA”, this will open the “RSA Keypair” dialogue a.
  5. Click the copy icon on “Private Key” (please make sure to select private key) a.
  6. Go into eSignature configuration in FLEX JUICE.
  7. Paste your RSA Private key into the “RSA Private Key” field
  8. Select “Ok”
  9. Select “Save”
  10. Select “Refresh”
  11. Select “Close” on the RSA Keypair dialogue ensuring to stay within the Flex Integration page of the apps and keys subsection.

Redirect URI

Next, we will make sure that the redirection will take place to go to the credit union’s URL in the production account:

  1. Go to the open DocuSign account session under the FLEX Integration
  2. Scroll down to “Redirect URIs”
  3. Select “Add URI”
  1. Input the URL exactly as it appeared in Miscellaneous Information~
    1. (ie HTTPS://WWW.MYCREDITUNIONSURL.COM)
    2. Again, this should not be a FLEX URL. If incorrect, update your credit union’s homepage.
  2. Scroll down to “Save”

Update Users

Now that the production account is in use, you’ll want to make sure that all users are in the production account.

You will have to update all tellers by selecting “actions” and making sure it matches.

User Authorization

To authorize a user, they need to be signed in to their DocuSign account and integrate it with their Teller account.

To do this, you’ll follow these simple steps:

  1. Go to “eSignature Configuration”
  2. Select the “OAuth 2 setup” button
  3. Select “Authorize”
  4. If the authorize button takes the user to an “unable to locate redirect”, don't worry! Follow steps 4 and on instead!
  5. Select “Copy Authorization URL” and then paste the link into a new browser window.
  6. This should bring up an “input password” type dialogue
  7. Once the password is entered, the user will then see “Allow access”
  8. If all has gone smoothly, the user will now be authorized and you should follow the User Confirmation process if not done already.
  9. This process needs to be repeated for each user to have the Production Account holder send the URL to each individual that has an eSignature Configuration in the DocuSign tab within FLEX JUICE. Each user needs to sign with their username & password on DocuSign, to permit FLEX to use their account. Note:

User ID in DocuSign is a User Key in FLEX JUICE. This has to be done in both demo and production.

Completion

Log out of FLEX all the way and back in, then send a test envelope to confirm completion of integration. If the status shows sent, you are fully integrated!