Bill Payments

Pay utility bills including electricity, water, and TV subscriptions across supported African countries.

Supported billers

Electricity

Prepaid and postpaid electricity bills.

UgandaKenya

Water

Municipal water bills.

UgandaKenya

TV Subscriptions

DStv, GoTV, Startimes, and other TV providers.

All countries

Internet

Broadband and data subscriptions.

UgandaKenya

Pay a bill

Tab Title
Tab Title

curl -X POST https://api.wearemarz.com/v1/bills/pay \
  -H "Authorization: Bearer YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "biller_code": "UMEME",
    "account_number": "123456789",
    "amount": 50000,
    "currency": "UGX",
    "reference": "BILL-2024-001",
    "callback_url": "https://your-app.com/webhooks/bills"
  }'

{
  "status": "success",
  "data": {
    "reference": "MZ_BILL_20240115_abc123",
    "biller_code": "UMEME",
    "account_number": "123456789",
    "amount": 50000,
    "currency": "UGX",
    "status": "success",
    "fee": 500,
    "net_amount": 49500,
    "receipt_number": "RCPT-20240115-001",
    "completed_at": "2024-01-15T10:32:15Z"
  }
}

Bill payment statuses

Status	Meaning
pending	Payment being processed
success	Bill paid successfully
failed	Payment failed - check biller details

Bill payment webhooks

{
  "event": "bill_payment.completed",
  "data": {
    "reference": "MZ_BILL_20240115_abc123",
    "biller_code": "UMEME",
    "account_number": "123456789",
    "amount": 50000,
    "currency": "UGX",
    "status": "success",
    "fee": 500,
    "receipt_number": "RCPT-20240115-001",
    "completed_at": "2024-01-15T10:32:15Z"
  }
}

Fees

Bill payment fees vary by biller and country. Typically 1-2% of the bill amount with a minimum fee.

API Playground - Bill Payments - Test bill payment endpoints live

Get started

Collections

Disbursements

Bills & airtime

Webhooks & platform

Build tools

Support

Supported billers

Electricity

Water

TV Subscriptions

Internet

Pay a bill

Bill payment statuses

Bill payment webhooks

Fees

​Supported billers

Electricity

Water

TV Subscriptions

Internet

​Pay a bill

​Bill payment statuses

​Bill payment webhooks

​Fees

Supported billers

Pay a bill

Bill payment statuses

Bill payment webhooks

Fees