Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/prem-ium/savannah-utility-autopay
💳 Python script utilizing selenium to automate payment for utility 🚰 bill website.
https://github.com/prem-ium/savannah-utility-autopay
automation-selenium autopay billing billspayment budgeting credit-card debit-card georgia-usa payment savannah savannah-ga scripting selenium-webdriver-python utility
Last synced: 26 days ago
JSON representation
💳 Python script utilizing selenium to automate payment for utility 🚰 bill website.
- Host: GitHub
- URL: https://github.com/prem-ium/savannah-utility-autopay
- Owner: Prem-ium
- License: mit
- Created: 2022-07-13T19:21:05.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2023-11-29T16:33:54.000Z (11 months ago)
- Last Synced: 2023-11-30T04:39:20.022Z (11 months ago)
- Topics: automation-selenium, autopay, billing, billspayment, budgeting, credit-card, debit-card, georgia-usa, payment, savannah, savannah-ga, scripting, selenium-webdriver-python, utility
- Language: Python
- Homepage:
- Size: 45.9 KB
- Stars: 2
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE.MD
Awesome Lists containing this project
README
🏤 Savannah, GA Utility Bill Pay Automation 🤖
A Selenium-based Python script that simplifies water utility bill payments for homeowners, landlords, & business owners in Savannah, GA USA.
## Installation
1. Clone this repository, CD into the folder, and install dependancies:
```sh
git clone https://github.com/Prem-ium/Savannah-Utility-AutoPay.git
cd Savannah-Utility-AutoPay
pip install -r requirements.txt
```
2. Configure your `.env` file (See below and example for options)
3. Run the script:
```sh
python main.py
```
## Environment Variables
To run this project, you will need to add the following environment variables to your .env file
#### Required Enviornmental Variables:
| Variable | Description | Type |
|------------------|-------------------------------------------------------------------|---------|
| `ACCOUNT_NUMBERS`| Comma-separated string of account numbers | String |
| `BARCODES` | Comma-separated string of barcodes | String |
| `PAYOR_INFO` | JSON string containing payor's information | JSON |
#### Optional Enviornmental Variables:
| Variable | Description | Type | Default |
|------------------|--------------------------------------------------------------------|---------|---------|
| `HANDLE_PAYMENT` | A boolean value indicating whether the application handles payments | Boolean | True |
| `FULLY_AUTOMATED`| A boolean value indicating fully automated mode | Boolean | False |
| `MULTI_THREADING`| A boolean value indicating multithreading usage | Boolean | True |
| `PAYMENT_METHOD` | String indicating payment method (bank, credit, debit) | String | bank |
| `BANK` | JSON string containing bank information | JSON | |
| `CREDIT_CARD` | JSON string containing credit card information | JSON | |
| `DEBIT_CARD` | JSON string containing debit card information | JSON | |
It is important to note that these variables should be replaced with real values before the application is run in order for it to function properly.
# Donations
If you appreciate my work and would like to show your support, there are two convenient ways to make a donation:
1. **GitHub Sponsors**
- [Donate via GitHub Sponsors](https://github.com/sponsors/Prem-ium)
- This is the preferred donation method as you can place donations with no transaction fees & possibily receive perks for your donation.
- [](https://github.com/sponsors/Prem-ium)
2. **Buy Me A Coffee**
- [Donate via Buy Me A Coffee](https://www.buymeacoffee.com/prem.ium)
- [](https://www.buymeacoffee.com/prem.ium)
Your generous donations will go a long way in helping me cover the expenses associated with developing new features and promoting the project to a wider audience. I extend my heartfelt gratitude to all those who have already contributed. Thank you for your support!
## FAQ
#### How can this repository help Savannah Georgia property owners pay utility bills?
This repository contains a Python script that automates the process of paying utility bills for Savannah properties using Selenium. It can save time and hassle for landlords and business owners who need to pay multiple bills every month.
#### What inspired you to create this script?
I created this script because I was frustrated with the Savannah GA GOV Utility Bill payment website. It was slow, cumbersome, and required me to enter the same information over and over again for each property. I wanted a faster and easier way to pay my utility bills online.
## License
This project operates under the [MIT](https://github.com/Prem-ium/Savannah-Utility-AutoPay/blob/main/LICENSE.MD) license.
## Disclaimer:
Please be careful when storing financial information such as card or bank details in this program. Storing this information in your `.env` is not always secure and could expose you to fraud or theft. We do not recommend storing permanently any sensitive financial information in this program. If you choose to do so, you are solely responsible for any financial loss that may happen. Use at your own risk. It is **highly recommended** you use Privacy to create virtual cards if you chose to leave your info permanently.
[Use Privacy.com to secure your payments. ](https://privacy.com/join/G25UX)
Privacy will allow you to pause and unpause your card at any time, allowing you to securely ensure your financial safety in the event of a breach.
## Example Output
```
Account: 07XXX0 Barcode: 1XXX00 Payment Method: Bank
Account: 07XXX0 with barcode: 1XXX00 found.
An outstanding balance exists... Continuing...
------------------------
Account: 07XXX0
Barcode: 1XXX00
Amount due: $126.26
------------------------
Done! Thank you for using Prem-ium's Savannah, GA Water Bill Automation Script!
```