https://github.com/dana-id/dana-python
Official DANA REST API Client for Python - Payment Gateway, IPG, and Disbursement
https://github.com/dana-id/dana-python
client-library dana disbursement payment-gateway python sdk sdk-python widget
Last synced: 13 days ago
JSON representation
Official DANA REST API Client for Python - Payment Gateway, IPG, and Disbursement
- Host: GitHub
- URL: https://github.com/dana-id/dana-python
- Owner: dana-id
- License: other
- Created: 2025-04-15T14:02:10.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2026-05-05T08:36:31.000Z (28 days ago)
- Last Synced: 2026-05-05T10:28:19.097Z (27 days ago)
- Topics: client-library, dana, disbursement, payment-gateway, python, sdk, sdk-python, widget
- Language: Python
- Homepage: https://dashboard.dana.id/api-docs-v2/
- Size: 591 KB
- Stars: 1
- Watchers: 0
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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:
```sh
pip install dana-python
```
(you may need to run `pip` with root permission: `sudo pip install dana-python`)
Then import the package, ex:
```python
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. | |
| `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**](docs/payment_gateway/v1/PaymentGatewayApi.md) | API for doing operations in DANA Payment Gateway (Gapura)
[**WidgetApi**](docs/widget/v1/WidgetApi.md) | API for enabling the user to make payment from merchant’s platform with redirecting to DANA’s platform
[**DisbursementApi**](docs/disbursement/v1/DisbursementApi.md) | API for doing operations in DANA Disbursement
[**MerchantManagementApi**](docs/merchant_management/v1/MerchantManagementApi.md) | API for doing operations in DANA Merchant Management