Pay Bill

This method creates a bill payment to a supported service providers using the merchant’s OneKhusa account balance. To make a payment, provide the ServiceCode for the selected provider, the provider-specific ServiceAccountNumber, and the required transaction details. For example, when paying an ESCOM Prepaid bill, the service account number represents the customer’s meter number. For a list of supported service providers and their service codes, see Service Providers. For sandbox testing and the expected response for each test account, see Test Accounts. For detailed explanations of the request and response payloads, see the Bill Payments Overview. On a successful payment, the provider’s response is returned in ServiceResponse, together with the transaction reference and response code.

using OneKhusa.SDK;
using OneKhusa.SDK.Models.Transactions.BillPayments;

//code omitted for brevity

OneKhusaResponse<PayBillPaymentResponse> response = await client
    .Transactions
    .BillPayments
    .PayBillAsync(new PayBillPaymentRequest
    {
        BillDescription = "ESCOM Bill payment",
        CapturedBy = "joe.doe@example.com",
        MerchantAccountNumber = 12345678,
        ServiceAccountNumber = "10001000",
        ServiceCode = "101",
        SourceReferenceNumber = "EFTTEST0001",
        TransactionAmount = 100.00M
    });

if (response is { IsSuccess: true, Data: not null })
{
    Console.WriteLine($"""
        ServiceResponse: {response.Data.ServiceResponse};
        TransactionReferenceNumber: {response.Data.TransactionReferenceNumber};
        ResponseCode: {response.Data.ResponseCode}
        """);
    return;
}
//it means an error has occurred: RFC7807 compliant error object
Console.WriteLine($"""
        Type: {response.Error?.Type};
        Title: {response.Error?.Title};
        Detail: {response.Error?.Detail};
        ErrorCode: {response.Error?.ErrorCode};
        Status: {response.Error?.Status};
        Instance: {response.Error?.Instance};
        Errors: {string.Join(";", response.Error?.Errors ?? [])}
""");
Console.ReadLine();

Note: This method accepts custom idempotency key generated by your system. By default, if not specified, it will create one on your behalf.

Getting Started

C# SDK