The Official DocuSign eSignature Java Client SDK

Requirements

• Java 1.9+
• Free developer account

Compatibility

• Java 1.9+

Installation

This SDK is provided as open source, which enables you to customize its functionality to suit your particular use case. To do so, download or clone the repository. If the SDK’s given functionality meets your integration needs, or if you’re working through our code examples from the DocuSign Developer Center, you merely need to install it by following the instructions below.

Note: DocuSign uses Eclipse with Maven for testing purposes.

Maven:

1. In Eclipse, create a new project by selecting File > New > Project.
2. In the New Project Wizard, expand Maven, then select Maven Project.
3. Leave Create a simple project unchecked.
4. Select Next, then provide a unique groupId and artifactId.
5. In the directory where you've saved your project, open the pom.xml file.
6. In the pom.xml file, locate the dependencies node.
7. Add:

   <dependency>
     <groupId>com.docusign</groupId>
     <artifactId>docusign-esign-java</artifactId>
     <version>3.18.0</version>
   </dependency>
   

8. If your project is still open, restart Eclipse.

Dependencies

This client has the following external dependencies:

• io.swagger:swagger-annotations:jar:1.5.17
• org.glassfish.jersey.core:jersey-client:jar:2.29.1
• org.glassfish.jersey.media:jersey-media-multipart:jar:2.29.1
• org.glassfish.jersey.media:jersey-media-json-jackson:2.29.1
• com.fasterxml.jackson.core:jackson-core:jar:2.12.1
• com.fasterxml.jackson.core:jackson-annotations:jar:2.12.1
• com.fasterxml.jackson.core:jackson-databind:2.12.1
• junit:junit:jar:4.13.1
• com.apache.oltu.oauth2:org.apache.oltu.oauth2.client:1.0.2
• com.auth0:java-jwt:3.4.1
• org.bouncycastle:bcprov-jdk15on:1.60

Code examples

You can find on our GitHub a self-executing package of code examples for the eSignature Java SDK, called a Launcher, that demonstrates common use cases. You can also download a version preconfigured for your DocuSign developer account from Quickstart. These examples can use either the Authorization Code Grant or JSON Web Token (JWT) authentication workflows.

OAuth implementations

For details regarding which type of OAuth grant will work best for your DocuSign integration, see Choose OAuth Type in the DocuSign Developer Center.

For security purposes, DocuSign recommends using the Authorization Code Grant flow.

Support

Log issues against this client through GitHub. We also have an active developer community on Stack Overflow.

License

The DocuSign eSignature Java Client SDK is licensed under the MIT License.

Additional resources

• DocuSign Developer Center
• DocuSign API on Twitter
• DocuSign For Developers on LinkedIn
• DocuSign For Developers on YouTube