ihela-sdk 0.2.0

Python SDK for the iHela financial services API

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, "[e-mail]", "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.