Skip to content

An android app built by Knight Ninjas team for the Giza Hackathon. Bills App lets users pay for and track key utility bills.

Notifications You must be signed in to change notification settings

Jackwitwicky/utility-app

Repository files navigation

Bills App

Introducing Bills App, and Android based application to help you organize, pay and track your bills all in one beautifully designed place. Say goodbye to scribbling your 10 digit electricity meter number on a piece of paper as you pay via MPESA, or calling your TV subscription company a third time in a row to ask what your account number is. Using Bills App, simply create a new bill and save all key details about it. This allows you pay via MPESA in the click of button.

Splash Screen Add Bill Screen
Home Screen Confirm Transaction
Successful Transaction

Getting Started

To get the application running, either

Build from source

Prerequisites

What things you need to build the app and how to install them

Android Studio Version 3.6 or higher

Minimum sdk used :- 18

Simply clone the repo, open it in your Android Studio and after dependencies have been downloaded, click play to run it on a connected device

Download from Google Play

This is still in the works. Hope to make it available soon

How it Works

The app utilizes Hover library to automate the Sim Toolkit process for inputting values to initiate an MPESA transaction. After launching the app, the user can use the Add Bill form to create a new bill. Utility app ships with payment details for some Common Utility providers such as KPLC, Nairobi Water, Go TV, Star times and Zuku. However if the user can create a new Utility provider and specify their details.

When a user wants to pay for a particular utility, clicking the PAY button from the home screen will initiate the process while pre-filling all the payment details of the bill and requesting the user for their MPESA pin, after which the process will be completed and the app will show a success dialog to the user.

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

Authors

Jack Kiarie - Other Works

Zephaniah Sefu - Other Works

See also the list of contributors who participated in this project.

About

An android app built by Knight Ninjas team for the Giza Hackathon. Bills App lets users pay for and track key utility bills.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages