Digital marketplace for airtime top-ups, gift cards,and crypto payments across African markets
# π Cardshop
**Your Digital Marketplace β Airtime Β· Gift Cards Β· Crypto Payments**
Cardshop is a Streamlit-based digital utilities platform offering instant airtime/data top-ups, gift card purchases, and multi-method payments with 24/7 customer support.
## Features
### π± Airtime & Data Top-Up
- 8 African countries supported (Nigeria, Ghana, Kenya, South Africa, Cameroon, Tanzania, Uganda, Egypt)
- All major operators (MTN, Airtel, Safaricom, Vodacom, etc.)
- Instant delivery with order confirmation
- Flexible data plans (1GB to Unlimited)
### π Gift Card Marketplace
- 16+ brands (Apple, Google Play, Amazon, Steam, Netflix, PlayStation, Xbox, etc.)
- Multiple denominations per card
- Searchable & filterable catalog
- Instant code delivery with email confirmation
### π³ Multi-Payment Support
- Credit/Debit cards (Visa, Mastercard, Amex)
- PayPal integration
- Crypto payments (BTC, ETH, USDT, USDC, LTC)
- In-app wallet system
### π¬ 24/7 Customer Support
- **AI Chatbot** β Instant answers with quick-action buttons
- **WhatsApp Integration** β Direct chat link for real-time human support
- **Email Support** β Ticketed system with order ID tracking
- **Escalation** β AI-to-human handoff built in
### π Order Management
- Full transaction history
- Order tracking with status badges
- Spending analytics
## Quick Start
```bash
pip install -r requirements.txt
streamlit run app.py
```
## Deployment
### Streamlit Cloud
1. Push to GitHub
2. Connect repo at share.streamlit.io
3. Deploy
### VPS (Ubuntu)
```bash
git clone
cd cardshop
pip install -r requirements.txt
nohup streamlit run app.py --server.port 8501 &
```
## Roadmap
- [ ] Connect live airtime API (Reloadly / DingConnect)
- [ ] Connect gift card supplier API
- [ ] Stripe / Flutterwave payment integration
- [ ] User authentication & accounts
- [ ] SMS/email notification system
- [ ] Admin dashboard
- [ ] Mobile PWA wrapper
- [ ] Referral & loyalty program
## Tech Stack
- **Frontend:** Streamlit + Custom CSS β¦