Python SDK

pip install usebila

import os
from usebila import Bila
 
client = Bila(
    api_key=os.environ.get("BILA_API_KEY"),  # This is the default and can be omitted
    environment="sandbox",  # defaults to "production"
)
 
accounts = client.accounts.list()
print(accounts.message)

ACCOUNT_ID = "68f11209-451f-4a15-bfcd-d916eb8b09f4"
 
account = client.accounts.retrieve(ACCOUNT_ID)
print("retrieve:", account)

accounts = client.accounts.list(page=1, per_page=50)
print("list:", accounts)

balance = client.accounts.get_balance(ACCOUNT_ID)
print("get_balance:", balance)

TRANSFER_RECIPIENT_ID = "68f11209-451f-4a15-bfcd-d916eb8b09f4"
 
recipient = client.transfer_recipients.retrieve(TRANSFER_RECIPIENT_ID)
print("retrieve:", recipient)

recipients = client.transfer_recipients.list(page=1, per_page=50)
print("list:", recipients)

bank_recipient = client.transfer_recipients.create_bank_account(
    account_number="1234567890",
    bank_id="bank-001",
    country="zm",
    name="John Doe",
)
print("create_bank_account:", bank_recipient)

mobile_recipient = client.transfer_recipients.create_mobile_money(
    phone="0977433571",
    operator="airtel",
    country="zm",
    name="Jane Doe",
)
print("create_mobile_money:", mobile_recipient)

TRANSFER_ID = "68f11209-451f-4a15-bfcd-d916eb8b09f4"
 
transfer = client.transfers.retrieve(TRANSFER_ID)
print("retrieve:", transfer)

transfers = client.transfers.list(
    account_id="68f11209-451f-4a15-bfcd-d916eb8b09f4",
    start_date="2024-01-01T00:00:00Z",
    end_date="2024-12-31T23:59:59Z",
    page=1,
    per_page=50,
    status="pending",
    type="bank-account",
)
print("list:", transfers)

BANK_REFERENCE = "transfer-001"
 
status = client.transfers.get_status_by_reference(BANK_REFERENCE)
print("get_status_by_reference:", status)

bank_transfer = client.transfers.initiate_bank_transfer(
    account_id="68f11209-451f-4a15-bfcd-d916eb8b09f4",
    amount=1000,
    reference="transfer-001",
    account_number="1234567890",
    bank_id="bank-001",
    country="zm",
    narration="Payment for services",
    recipient_name="Jane Doe",
    transfer_recipient_id="68f11209-451f-4a15-bfcd-d916eb8b09f4",
    wallet_id="68f11209-451f-4a15-bfcd-d916eb8b09f4",
)
print("initiate_bank_transfer:", bank_transfer)

mobile_transfer = client.transfers.initiate_mobile_money_transfer(
    amount=250,
    country="zm",
    operator="airtel",
    phone="0977433571",
    reference="mobile-transfer-001",
    narration="Mobile money payout",
    recipient_name="Jane Doe",
    wallet_id="68f11209-451f-4a15-bfcd-d916eb8b09f4",
)
print("initiate_mobile_money_transfer:", mobile_transfer)

COLLECTION_ID = "68f11209-451f-4a15-bfcd-d916eb8b09f4"
 
collection = client.collections.retrieve(COLLECTION_ID)
print("retrieve:", collection)

collections = client.collections.list(
    account_id="68f11209-451f-4a15-bfcd-d916eb8b09f4",
    start_date="2024-01-01T00:00:00Z",
    end_date="2024-12-31T23:59:59Z",
    page=1,
    per_page=50,
    status="pending",
)
print("list:", collections)

REFERENCE = "collection-001"
 
status = client.collections.get_status_by_reference(REFERENCE)
print("get_status_by_reference:", status)

initiated = client.collections.initiate_mobile_money_collection(
    amount=100.5,
    country="zm",
    operator="airtel",
    phone="0977433571",
    reference="collection-001",
    wallet_id="68f11209-451f-4a15-bfcd-d916eb8b09f4",
    bearer="customer",
    customer_name="John Doe",
    narration="Payment for subscription",
)
print("initiate_mobile_money_collection:", initiated)

TRANSACTION_ID = "68f11209-451f-4a15-bfcd-d916eb8b09f4"
 
transaction = client.transactions.retrieve(TRANSACTION_ID)
print("retrieve:", transaction)

transactions = client.transactions.list(page=1, per_page=50)
print("list:", transactions)

webhook = client.webhooks.create(
    events=["payment.completed", "withdrawal.completed", "transfer.completed"],
    url="https://example.com/webhooks",
)
print("create:", webhook)

WEBHOOK_ID = "68f11209-451f-4a15-bfcd-d916eb8b09f4"
 
updated_webhook = client.webhooks.update(
    WEBHOOK_ID,
    events=["payment.completed", "collection.completed", "transfer.failed"],
    url="https://example.com/webhooks/v2",
    is_active=True,
)
print("update:", updated_webhook)

webhooks = client.webhooks.list()
print("list:", webhooks)

deactivated = client.webhooks.deactivate(WEBHOOK_ID)
print("deactivate:", deactivated)

deliveries = client.webhooks.get_deliveries(
    WEBHOOK_ID,
    start_date="2026-04-01T00:00:00.000Z",
    end_date="2026-04-30T23:59:59.999Z",
    event_type="payment.completed",
    page=1,
    per_page=20,
    status="DELIVERED",
)
print("get_deliveries:", deliveries)

events = client.webhooks.list_events()
print("list_events:", events)

rotated = client.webhooks.rotate_secret(WEBHOOK_ID)
print("rotate_secret:", rotated)

banks = client.banks.list(country="zm")
print("list:", banks)

resolution = client.resolve.bank_account(
    account_number="1234567890",
    bank_id="bank-001",
)
print("bank_account:", resolution)

resolution = client.resolve.mobile_money(
    phone="0977433571",
    operator="airtel",
    country="zm",
)
print("mobile_money:", resolution)

import os
import asyncio
from usebila import AsyncBila
 
client = AsyncBila(
    api_key=os.environ.get("BILA_API_KEY"),
    environment="sandbox",
)
 
 
async def main() -> None:
    accounts = await client.accounts.list()
    print(accounts.message)
 
 
asyncio.run(main())

import usebila
from usebila import Bila
 
client = Bila()
 
try:
    client.accounts.list()
except usebila.APIConnectionError as e:
    print("The server could not be reached")
    print(e.__cause__)
except usebila.RateLimitError as e:
    print("A 429 status code was received; we should back off a bit.")
except usebila.APIStatusError as e:
    print("Another non-200-range status code was received")
    print(e.status_code)
    print(e.response)

from usebila import Bila
from usebila.types import AccountListResponse, CollectionListParams
 
client = Bila(
    api_key="Your API key",
    environment="sandbox",
)
 
# Response type — what the API returns
accounts: AccountListResponse = client.accounts.list()
 
# Request type — what you send to the API
params: CollectionListParams = {
    "account_id": "your-wallet-id",
    "page": 1,
    "per_page": 50,
}
collections = client.collections.list(**params)