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

Repository files navigation

UniCard

This is an Open Source of 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