Skip to content

A closed-loop payment card for handling both retail and transit transactions (Written in Go).

Notifications You must be signed in to change notification settings

devzeeh/unicard

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

UniCard

This is a practice ground for my personal project PayCard

GitHub go.mod Go version MySQL Status GitHub Created At GitHub last commit GitHub language count GitHub Repo stars

A unified contactless payment system for retail stores and public transportation. "The single card for all your retail and fare payments."

DocumentationFeaturesQuick StartContributing

Overview

PayCard is a cashless payment solution designed for retail stores and transportation. Built with affordable hardware and accessible technology as a school project.

Note: This project is for educational purposes only and not intended for commercial use.

Why PayCard?

  • Fast Contactless Payments - Utilizes RFID (ESP32 + RC522) for quick, tap-to-pay functionality.
  • Affordable Hardware - Built using low-cost, readily available components.
  • Rewards & Discount Logic - Includes a proof-of-concept for a 20% fare discounts (e.g., for PWD/Students).
  • Unified System - A single card system designed to handle both retail (itemized) and transport (fare) transactions.
  • Analytics Dashboard - A simple dashboard for viewing transaction history and user data.

Features

  • Card Lifecycle Management - Core functions to register, activate, load, and block RFID cards.
  • Dual Payment Logic - Handles both itemized billing (for retail) and distance-based fare calculation (for transport).
  • Reward Points System - A proof-of-concept for calculating 0.2% cashback points per transaction.
  • Email Receipts - Automatically sends transaction details via SMTP (e.g., Gmail) after a payment.
  • Web Dashboard - A simple web interface for users, merchants, and admins to review transaction logs.
  • Transaction Security - Implements card-to-server authentication, balance verification, and basic audit logging.

Tech Stack (MVP Stack)

Component Technology
Backend Go 1.22+
Database MySQL 8.0+
Payments Stripe API
Hardware ESP32 + RC522 RFID
Frontend HTML, Tailwind CSS, JavaScript
Email SMTP (Gmail)
Version Control Git & GitHub

Quick Start

Demo

A video demonstration will be available here once the project is finalized.

Transaction Flow

User taps card ➔ Validates balance ➔ Deducts payment ➔ Earns points ➔ Receipt sent

Sample Fare Receipt

Sample Fare Receipt

Sample Retail Receipt

Sample Retail Receipt

Acknowledgements

This project was made possible by the incredible work of the following communities and technologies:

  • The Go Community - For a robust and efficient backend language.
  • MySQL - For a reliable and powerful database solution.
  • ESP & Arduino Developers - For versatile microcontroller support.
  • Tailwind Labs - For a utility-first CSS framework.
  • Stripe - For accessible and developer-friendly payment infrastructure.
  • The entire Open Source Community - For the countless tools and libraries that power modern development.

Made with ❤️ in the Philippines

Philippine Flag

Helping local businesses and campuses build cashless ecosystems

Copyright © 2025 devzeeh. All Rights Reserved.
Back to Top

About

A closed-loop payment card for handling both retail and transit transactions (Written in Go).

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published