Skip to content

digimercados/digipaga

Repository files navigation

DigiPaga — Pay Utility Bills with Mento Stablecoins

License: MIT Celo Mento Global Stablecoin Hackathon

Making crypto useful for everyday essentials 💡

Pay electricity, water, internet & more with stablecoins on Celo

📋 Table of Contents

🌟 Overview

DigiPaga bridges the gap between crypto and everyday utility payments. Our platform allows users to pay real-world bills directly with Mento stablecoins on the Celo network, providing a seamless experience between digital currency and essential services.

Demo Video: Watch how DigiPaga works (Stablecoin Mento Celo MiniPay Hackathon)

🔍 The Problem & Solution

Problem: Millions lack access to reliable tools for paying essential services with crypto. In emerging markets, high fees, delays, and infrastructure gaps create significant barriers between digital assets and real-world utilities.

Solution: DigiPaga provides a mobile-first platform enabling instant, secure utility payments using Mento stablecoins. Our integration handles the complexity of blockchain transactions and automatically converts crypto to fiat for service providers, enabling:

  • For Users: Pay bills anytime with low fees using stablecoins
  • For Providers: Receive payments in local currency without blockchain knowledge

💫 Key Features

Feature Description
🧾 Multi-Currency Support Pay with cUSD, cEUR, cREAL, eXOF, and other Mento stablecoins
💱 Automatic Fiat Conversion Backend converts crypto to fiat for service providers
🔍 Transaction Verification On-chain verification with transparent tracking
🌎 Multi-Country Support Initial focus on Mexico & Colombia, expanding across LatAm
📱 MiniPay Integration Seamless experience with the MiniPay wallet
🔄 Status Tracking Real-time payment status updates

🏗️ System Architecture

┌───────────────────┐     ┌──────────────────┐     ┌───────────────────┐
│    Client Side    │     │   Backend Layer   │     │ External Services │
├───────────────────┤     ├──────────────────┤     ├───────────────────┤
│  ┌─────────────┐  │     │  ┌────────────┐  │     │  ┌─────────────┐  │
│  │  Next.js UI │──┼─────┼─▶│ API Routes │  │     │  │   Payment   │  │
│  └─────────────┘  │     │  └────────────┘  │     │  │  Providers  │  │
│  ┌─────────────┐  │     │  ┌────────────┐  │     │  └─────────────┘  │
│  │  MiniPay    │◀─┼─────┼─▶│  Payment   │  │     │  ┌─────────────┐  │
│  │   Wallet    │  │     │  │  Service   │◀─┼─────┼─▶│    Celo     │  │
│  └─────────────┘  │     │  └────────────┘  │     │  │ Blockchain  │  │
└───────────────────┘     └──────────────────┘     └───────────────────┘

📊 Payment Flow

┌─────────┐    ┌──────────┐    ┌─────────────┐    ┌──────────────┐
│  User   │───▶│ DigiPaga │───▶│   MiniPay   │───▶│    Celo      │
│         │    │          │    │   Wallet    │    │  Blockchain   │
└─────────┘    └──────────┘    └─────────────┘    └──────────────┘
     │              │                 │                   │
     │              │                 │                   │
     │              │                 │            Verify │
     │              │          Send   │          Transaction
     │              │      Transaction│                   │
     │              │                 │                   │
     │         Show │                 │                   │
     │       Status │                 │                   │
     │              │                 │                   │
     ▼              ▼                 ▼                   ▼

🧰 Tech Stack

Frontend Backend Blockchain Integration
Next.js 15 API Routes Celo Network Payment APIs
React 19 Payment Service Mento Stablecoins Provider APIs
TypeScript Verification API MiniPay Wallet Status APIs
TailwindCSS Transaction Logger Smart Contracts Analytics
Shadcn UI
Wagmi/Viem

🚀 Getting Started

Prerequisites

You'll need:

Quick Setup

# Clone the repo with submodules
git clone --recurse-submodules https://github.com/digimercados/digipaga.git
cd digipaga

# Install dependencies
bun install

# Install additional dependencies for Mento integration
bun add uuid @types/uuid

# Set up environment variables
echo "NEXT_PUBLIC_CELO_RPC_URL=https://alfajores-forno.celo-testnet.org
NEXT_PUBLIC_DEFAULT_FEE_CURRENCY=0x765DE816845861e75A25fCA122bb6898B8B1282a" > .env.local

# Start development server
bun dev

Visit http://localhost:3000 in your browser.

🔒 Security Architecture

┌─────────────────────┐
│   Authentication    │
├─────────────────────┤
│ - Wallet Auth      │
│ - API Protection   │
└─────────────────────┘
         │
         ▼
┌─────────────────────┐
│ Transaction Security│
├─────────────────────┤
│ - Payment IDs      │
│ - Verification     │
│ - Validation       │
└─────────────────────┘
         │
         ▼
┌─────────────────────┐
│  Data Protection    │
├─────────────────────┤
│ - Env Variables    │
│ - Secure Storage   │
│ - HTTPS            │
└─────────────────────┘

📝 Project Status

Current milestone: Mento Stablecoin Integration (May 2025)

  • ✅ Frontend UI for service selection and payment
  • ✅ MiniPay wallet integration
  • ✅ Mento stablecoin payment processing
  • ✅ Transaction verification and logging
  • ✅ Payment receipt generation
  • 🔜 Service provider API integration
  • 🔜 Multi-country expansion
  • 🔜 Payment history and analytics

👥 Team

  • digipaga.eth - Project Lead
  • ottox.eth - Blockchain and Smart Contract Developer
  • ozkite.eth - Frontend Developer and Product

📚 Documentation

🔗 Links


Built for the Global Stablecoin Hackathon (May 2025)

DigiPaga | GitHub | Website

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •