Java SDK
Java SDK
basistheory-java
Getting Started
- Sign-in to Basis Theory and go to Applications
- Create an Application using the Full Access template
- Use the API Key issued for this application when initializing an
ApiClient
Requirements
Building the API client library requires:
- Java 8+
- Maven (3.8.3+)/Gradle (7.2+)
Installation
Gradle users
Add this dependency to your project's build file:
repositories {
maven { url 'https://jitpack.io' }
}
dependencies {
implementation 'com.github.Basis-Theory:basistheory-java:[version]'
}
The latest release version can be found in GitHub.
Maven users
Add the JitPack repository to your build file:
<repositories>
<repository>
<id>jitpack.io</id>
<url>https://jitpack.io</url>
</repository>
</repositories>
Then add the following dependency to your project's POM:
<dependency>
<groupId>com.github.Basis-Theory</groupId>
<artifactId>basistheory-java</artifactId>
<version>[version]</version>
</dependency>
The latest release version can be found in GitHub.
Initialization
Please follow the installation instruction and execute the following Java code:
// Import classes:
import com.basistheory.ApiClient;
import com.basistheory.ApiException;
import com.basistheory.Configuration;
import com.basistheory.auth.*;
import com.basistheory.models.*;
import com.basistheory.ApplicationsApi;
public class Example {
public static void main(String[] args) {
ApiClient defaultClient = Configuration.getDefaultApiClient();
defaultClient.setBasePath("https://api.basistheory.com");
// Configure API key authorization: ApiKey
ApiKeyAuth ApiKey = (ApiKeyAuth) defaultClient.getAuthentication("ApiKey");
ApiKey.setApiKey("YOUR API KEY");
// Uncomment the following line to set a prefix for the API key, e.g., "Token" (defaults to null)
//ApiKey.setApiKeyPrefix("Token");
ApplicationsApi apiInstance = new ApplicationsApi(defaultClient);
CreateApplicationRequest createApplicationRequest = new CreateApplicationRequest(); // CreateApplicationRequest |
try {
Application result = apiInstance.create(createApplicationRequest);
System.out.println(result);
} catch (ApiException e) {
System.err.println("Exception when calling ApplicationsApi#create");
System.err.println("Status code: " + e.getCode());
System.err.println("Reason: " + e.getResponseBody());
System.err.println("Response headers: " + e.getResponseHeaders());
e.printStackTrace();
}
}
}