dana-python

The official DANA Python SDK provides a simple and convenient way to call DANA's REST API in applications written in Python (based on https://dashboard.dana.id/api-docs-v2/)

⚠️ Run This First - Save Days of Debugging

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.

Why This Matters

• 🧪 Validates your setup instantly
• 👀 See exactly how each scenario flows
• 🧾 Gives us logs to help you faster
• 🚫 Skipping this = guaranteed delays

What It Does

✅ 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.

.

.

Getting Started

Requirements.

Python 3.9.1+

Installation & Usage

pip install

If the python package is hosted on a repository, you can install directly using:

pip install dana-python

(you may need to run pip with root permission: sudo pip install dana-python)

Then import the package, ex:

import dana.payment_gateway.v1

Environment Variables

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.	-----BEGIN PRIVATE KEY-----MIIBVgIBADANBg...LsvTqw==-----END PRIVATE KEY-----
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
X_DEBUG	Set to 'true' to activate debug mode (showing reason of failed request in additionalInfo.debugMessage in response)	true

You can see these variables in .env.example, fill it, and change the file name to .env (remove the .example extension)

Then you can choose these following APIs based on the business solution you want to integrate:

Documentation for API Endpoints

API	Description
PaymentGatewayApi	API for doing operations in DANA Payment Gateway (Gapura)
WidgetApi	API for enabling the user to make payment from merchant’s platform with redirecting to DANA’s platform
DisbursementApi	API for doing operations in DANA Disbursement
MerchantManagementApi	API for doing operations in DANA Merchant Management