C# SDK

dotnet add package Usebila

using System;
using Usebila;
using Usebila.Models.Accounts;
 
BilaClient client = new()
{
    ApiKey = "Your API key",
    BaseUrl = EnvironmentUrl.Sandbox, // either EnvironmentUrl.Production or EnvironmentUrl.Sandbox
};
 
AccountListParams parameters = new();
 
AccountListResponse accounts = await client.Accounts.List(parameters);
 
Console.WriteLine(accounts);

using Usebila;
 
// Configured using the BILA_API_KEY and BILA_BASE_URL environment variables
BilaClient client = new();

const string accountId = "68f11209-451f-4a15-bfcd-d916eb8b09f4";
 
AccountRetrieveResponse account = await client.Accounts.Retrieve(accountId);
Console.WriteLine("retrieve: {0}", account);

AccountListParams listParams = new() { Page = 1, PerPage = 50 };
 
AccountListResponse accounts = await client.Accounts.List(listParams);
Console.WriteLine("list: {0}", accounts);

AccountGetBalanceResponse balance = await client.Accounts.GetBalance(accountId);
Console.WriteLine("getBalance: {0}", balance);

const string transferRecipientId = "68f11209-451f-4a15-bfcd-d916eb8b09f4";
 
TransferRecipientRetrieveResponse recipient = await client.TransferRecipients.Retrieve(
    transferRecipientId
);
Console.WriteLine("retrieve: {0}", recipient);

TransferRecipientListParams listParams = new()
{
    Page = 1,
    PerPage = 50,
    Type = Usebila.Models.TransferRecipients.Type.BankAccount,
};
 
TransferRecipientListResponse recipients = await client.TransferRecipients.List(listParams);
Console.WriteLine("list: {0}", recipients);

TransferRecipientCreateBankAccountParams bankParams = new()
{
    AccountNumber = "1234567890",
    BankID = "bank-001",
    AccountName = "John Doe",
    Country = Country.Zm,
};
 
TransferRecipientCreateBankAccountResponse bankRecipient =
    await client.TransferRecipients.CreateBankAccount(bankParams);
Console.WriteLine("createBankAccount: {0}", bankRecipient);

TransferRecipientCreateMobileMoneyParams mobileParams = new()
{
    Country = TransferRecipientCreateMobileMoneyParamsCountry.Zm,
    Operator = Operator.Airtel,
    Phone = "0977433571",
    AccountName = "Jane Doe",
};
 
TransferRecipientCreateMobileMoneyResponse mobileRecipient =
    await client.TransferRecipients.CreateMobileMoney(mobileParams);
Console.WriteLine("createMobileMoney: {0}", mobileRecipient);

const string transferId = "68f11209-451f-4a15-bfcd-d916eb8b09f4";
 
TransferRetrieveResponse transfer = await client.Transfers.Retrieve(transferId);
Console.WriteLine("retrieve: {0}", transfer);

TransferListParams listParams = new()
{
    AccountID = "68f11209-451f-4a15-bfcd-d916eb8b09f4",
    StartDate = "2024-01-01T00:00:00Z",
    EndDate = "2024-12-31T23:59:59Z",
    Page = 1,
    PerPage = 50,
    Status = Status.Pending,
    Type = Usebila.Models.Transfers.Type.BankAccount,
};
 
TransferListResponse transfers = await client.Transfers.List(listParams);
Console.WriteLine("list: {0}", transfers);

const string bankReference = "transfer-001";
 
TransferGetStatusByReferenceResponse status = await client.Transfers.GetStatusByReference(
    bankReference
);
Console.WriteLine("getStatusByReference: {0}", status);

TransferInitiateBankTransferParams bankParams = new()
{
    AccountID = "68f11209-451f-4a15-bfcd-d916eb8b09f4",
    Amount = 1000,
    Reference = "transfer-001",
    AccountNumber = "1234567890",
    BankID = "bank-001",
    Country = Country.Zm,
    Narration = "Payment for services",
    RecipientName = "Jane Doe",
    TransferRecipientID = "68f11209-451f-4a15-bfcd-d916eb8b09f4",
    WalletID = "68f11209-451f-4a15-bfcd-d916eb8b09f4",
};
 
TransferInitiateBankTransferResponse bankTransfer = await client.Transfers.InitiateBankTransfer(
    bankParams
);
Console.WriteLine("initiateBankTransfer: {0}", bankTransfer);

TransferInitiateMobileMoneyTransferParams mobileParams = new()
{
    Amount = 250,
    Country = TransferInitiateMobileMoneyTransferParamsCountry.Zm,
    Operator = Operator.Airtel,
    Phone = "0977433571",
    Reference = "mobile-transfer-001",
    Narration = "Mobile money payout",
    RecipientName = "Jane Doe",
    WalletID = "68f11209-451f-4a15-bfcd-d916eb8b09f4",
};
 
TransferInitiateMobileMoneyTransferResponse mobileTransfer =
    await client.Transfers.InitiateMobileMoneyTransfer(mobileParams);
Console.WriteLine("initiateMobileMoneyTransfer: {0}", mobileTransfer);

const string collectionId = "68f11209-451f-4a15-bfcd-d916eb8b09f4";
 
CollectionRetrieveResponse collection = await client.Collections.Retrieve(collectionId);
Console.WriteLine("retrieve: {0}", collection);

CollectionListParams listParams = new()
{
    AccountID = "68f11209-451f-4a15-bfcd-d916eb8b09f4",
    StartDate = "2024-01-01T00:00:00Z",
    EndDate = "2024-12-31T23:59:59Z",
    Page = 1,
    PerPage = 50,
    Status = Status.Pending,
};
 
CollectionListResponse collections = await client.Collections.List(listParams);
Console.WriteLine("list: {0}", collections);

const string reference = "collection-001";
 
CollectionGetStatusByReferenceResponse status = await client.Collections.GetStatusByReference(
    reference
);
Console.WriteLine("getStatusByReference: {0}", status);

CollectionInitiateMobileMoneyCollectionParams initiateParams = new()
{
    Amount = 100.5,
    Country = Country.Zm,
    Operator = Operator.Airtel,
    Phone = "0977433571",
    Reference = "collection-001",
    WalletID = "68f11209-451f-4a15-bfcd-d916eb8b09f4",
    Bearer = Bearer.Customer,
    CustomerName = "John Doe",
    Narration = "Payment for subscription",
};
 
CollectionInitiateMobileMoneyCollectionResponse initiated =
    await client.Collections.InitiateMobileMoneyCollection(initiateParams);
Console.WriteLine("initiateMobileMoneyCollection: {0}", initiated);

const string transactionId = "68f11209-451f-4a15-bfcd-d916eb8b09f4";
 
TransactionRetrieveResponse transaction = await client.Transactions.Retrieve(transactionId);
Console.WriteLine("retrieve: {0}", transaction);

TransactionListParams listParams = new() { Page = 1, PerPage = 50 };
 
TransactionListResponse transactions = await client.Transactions.List(listParams);
Console.WriteLine("list: {0}", transactions);

WebhookCreateParams createParams = new()
{
    Events = [Event.PaymentCompleted, Event.WithdrawalCompleted, Event.TransferCompleted],
    UrlValue = "https://example.com/webhooks",
};
 
WebhookCreateResponse created = await client.Webhooks.Create(createParams);
Console.WriteLine("create: {0}", created);

const string webhookId = "68f11209-451f-4a15-bfcd-d916eb8b09f4";
 
WebhookUpdateParams updateParams = new()
{
    Events =
    [
        WebhookUpdateParamsEvent.PaymentCompleted,
        WebhookUpdateParamsEvent.CollectionCompleted,
        WebhookUpdateParamsEvent.TransferFailed,
    ],
    UrlValue = "https://example.com/webhooks/v2",
    IsActive = true,
};
 
WebhookUpdateResponse updated = await client.Webhooks.Update(webhookId, updateParams);
Console.WriteLine("update: {0}", updated);

WebhookListResponse webhooks = await client.Webhooks.List();
Console.WriteLine("list: {0}", webhooks);

WebhookDeactivateResponse deactivated = await client.Webhooks.Deactivate(webhookId);
Console.WriteLine("deactivate: {0}", deactivated);

WebhookGetDeliveriesParams deliveriesParams = new()
{
    StartDate = "2026-04-01T00:00:00.000Z",
    EndDate = "2026-04-30T23:59:59.999Z",
    EventType = "payment.completed",
    Page = 1,
    PerPage = 20,
    Status = "DELIVERED",
};
 
WebhookGetDeliveriesResponse deliveries = await client.Webhooks.GetDeliveries(
    webhookId,
    deliveriesParams
);
Console.WriteLine("getDeliveries: {0}", deliveries);

WebhookListEventsResponse events = await client.Webhooks.ListEvents();
Console.WriteLine("listEvents: {0}", events);

WebhookRotateSecretResponse rotated = await client.Webhooks.RotateSecret(webhookId);
Console.WriteLine("rotateSecret: {0}", rotated);

BankListParams listParams = new() { Country = "zm" };
 
BankListResponse banks = await client.Banks.List(listParams);
Console.WriteLine("list: {0}", banks);

ResolveBankAccountParams bankParams = new()
{
    AccountNumber = "1234567890",
    BankID = "bank-001",
    Country = Country.Zm,
};
 
ResolveBankAccountResponse resolution = await client.Resolve.BankAccount(bankParams);
Console.WriteLine("bankAccount: {0}", resolution);

ResolveMobileMoneyParams mobileParams = new()
{
    Country = ResolveMobileMoneyParamsCountry.Zm,
    Operator = Operator.Airtel,
    Phone = "0977433571",
};
 
ResolveMobileMoneyResponse resolution = await client.Resolve.MobileMoney(mobileParams);
Console.WriteLine("mobileMoney: {0}", resolution);

var response = await client.WithRawResponse.Accounts.List();
var statusCode = response.StatusCode;
var headers = response.Headers;

using Usebila.Exceptions;
 
try
{
    await client.Accounts.Retrieve("invalid-id");
}
catch (BilaApiException ex)
{
    Console.Error.WriteLine($"Status: {ex.StatusCode}");
    Console.Error.WriteLine($"Message: {ex.Message}");
}
catch (Exception ex)
{
    Console.Error.WriteLine($"Unexpected error: {ex.Message}");
}