Python SDK for the iHela financial services API
Project description
iHela SDK
Python SDK for the iHela Credit Union API for financial services in Burundi.
Installation
pip install ihela-sdk
With Django integration:
pip install "ihela-sdk[django]"
Or with uv:
uv add ihela-sdk
# with django extra
uv add "ihela-sdk[django]"
Quick Start
from ihela_sdk import MerchantClient
client = MerchantClient("your_client_id", "your_client_secret", prod=False)
For async applications (FastAPI, async Django):
from ihela_sdk import AsyncMerchantClient
client = AsyncMerchantClient("your_client_id", "your_client_secret", prod=False)
Exception Handling
from ihela_sdk import iHelaError, iHelaAPIError, iHelaAuthenticationError
try:
bill = client.init_bill(2000, "client@example.com", "Payment", "ref-001")
except iHelaAuthenticationError:
print("Authentication failed. Check your credentials.")
except iHelaAPIError as e:
print(f"API error (HTTP {e.status_code})")
except iHelaError:
print("A client error occurred.")
Features
- Merchant Services: Bill init/verify, cash-in, bank lists, customer lookup
- Banking Services: Deposits, withdrawals, account lookup/balance, statements, transaction fees
- Agent Services: Operations, withdrawal validation
- OAuth2: Client credentials and authorization code flows
- Django Integration: Pre-built views for django-allauth
- Async Support: Full async client variants using httpx
Documentation
Full documentation at UbuhingaVizion.github.io/ihela-sdk.
License
MIT — see LICENSE.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
ihela_sdk-0.1.0.tar.gz
(88.9 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
ihela_sdk-0.1.0-py3-none-any.whl
(17.9 kB
view details)
File details
Details for the file ihela_sdk-0.1.0.tar.gz.
File metadata
- Download URL: ihela_sdk-0.1.0.tar.gz
- Upload date:
- Size: 88.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.16 {"installer":{"name":"uv","version":"0.11.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2e77b770f4e6bf0d42949afe63651a6c9c517157a573dab5a4825f1e7d5e4233
|
|
| MD5 |
3e142d9fbf628b1402410693fe72a828
|
|
| BLAKE2b-256 |
bf7128441f8bf8aa64131f0ff3ea8bc4d479747f82a4f88daca783b57ce00126
|
File details
Details for the file ihela_sdk-0.1.0-py3-none-any.whl.
File metadata
- Download URL: ihela_sdk-0.1.0-py3-none-any.whl
- Upload date:
- Size: 17.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.16 {"installer":{"name":"uv","version":"0.11.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f926b53522d849bdb70f0cfb91a4ba9fb1b32b7baa390d88af0d773ade43015f
|
|
| MD5 |
b2435475607aa63ada4d32cc698794f2
|
|
| BLAKE2b-256 |
11ff7be77bdc25532774820994a1b045619fea62448d24705d29b9d4d8ffb5ce
|
