The official DANA Java SDK provides a simple and convenient way to call DANA's REST API in applications written in Java (based on https://dashboard.dana.id/api-docs-v2/).
Before writing any integration code, run our automated test suite. It takes under 2 minutes and shows you how the full flow works — with your own credentials.
Here is the link: https://github.com/dana-id/uat-script.
- 🧪 Validates your setup instantly
- 👀 See exactly how each scenario flows
- 🧾 Gives us logs to help you faster
- 🚫 Skipping this = guaranteed delays
✅ Runs full scenario checks for DANA Sandbox
✅ Installs and executes automatically
✅ Shows real-time results in your terminal
✅ Runs in a safe, simulation-only environment
Don't fly blind. Run the test first. See the flow. Build with confidence.
.
.
- JDK 1.8 or later.
To install the SDK to your Maven project, simply add the following dependency to your pom.xml:
<dependency>
<groupId>id.dana</groupId>
<artifactId>dana-java</artifactId>
<version>2.2.3</version>
</dependency>Before using the SDK, please make sure to set the following environment variables (In .env):
| Name | Description | Example Value |
|---|---|---|
ENV or DANA_ENV | Defines which environment the SDK will use. Possible values: SANDBOX or PRODUCTION. | SANDBOX |
X_PARTNER_ID | Unique identifier for partner, provided by DANA, also known as clientId. | 1970010100000000000000 |
PRIVATE_KEY | Your private key string. | |
PRIVATE_KEY_PATH | Path to your private key file. If both are set, PRIVATE_KEY_PATH is used. | /path/to/your_private_key.pem |
DANA_PUBLIC_KEY | DANA public key string for parsing webhook. | -----BEGIN PUBLIC KEY-----MIIBIjANBgkq...Do/QIDAQAB-----END PUBLIC KEY----- |
DANA_PUBLIC_KEY_PATH | Path to DANA public key file for parsing webhook. If both set, `DANA_PUBLIC_KEY_PATH is used. | /path/to/dana_public_key.pem |
ORIGIN | Origin domain. | https://yourdomain.com |
CLIENT_SECRET | Assigned client secret during registration. Must be set for DisbursementApi | your_client_secret |
You can see these variables in .env.example, fill it, and change the file name to .env (remove the .example extension)
By default, the SDK will read the configuration from environment variables.
importid.dana.invoker.Dana;
publicclassExample {
publicstaticvoidmain(String[] args) {
DanadanaClient = Dana.getInstance();
}
}Alternatively, you can also set the configuration programmatically by using DanaConfig.Builder to build the configuration and then passing it to DanaConfig.getInstance() before calling Dana.getInstance().
importid.dana.invoker.Dana;
importid.dana.invoker.model.DanaConfig;
importid.dana.util.ConfigUtil;
publicclassExample {
publicstaticvoidmain(String[] args) {
DanaConfig.BuilderdanaConfigBuilder = newDanaConfig.Builder();
danaConfigBuilder
.partnerId("YOUR_PARTNER_ID")
.privateKey("YOUR_PRIVATE_KEY")
.origin("YOUR_ORIGIN");
.env("SANDBOX"); // or "PRODUCTION"DanaConfig.getInstance(danaConfigBuilder);
DanadanaClient = Dana.getInstance();
}
}Find detailed API information and usage examples for each of our products by clicking the links below:
Find detailed util information and usage examples by clicking the links below: