stellar, payments, nigeria, africa, usdc, fintech, nextjs, open-source, freelance, moonpay, yellowcard.
# AfriPay πΈ
> Instant international payments for Nigerian freelancers β powered by Stellar and stablecoins.
AfriPay enables freelancers to receive payments from global clients in **minutes, not days**, with fees under **1%**. Blockchain complexity is completely abstracted β users see invoices, balances, and bank withdrawals, nothing else.
---
## π― The Problem
- Traditional payment methods (PayPal, Wise) charge **5β10% fees** and take **3β7 days** to settle
- Nigerian freelancers lose significant portions of their earnings to fees and exchange rate markups
- Crypto solutions are too complex for non-technical users
## β
Our Solution
1. **Create invoice** β Get a shareable payment link
2. **Client pays** β Card payment converts to USDC on Stellar
3. **Instant settlement** β Funds arrive in 3β5 seconds
4. **Withdraw to bank** β Convert to NGN via Yellow Card, instant bank transfer
5. **Keep 99%+** β Fees under 1%, zero crypto knowledge required
---
## π οΈ Tech Stack
| Layer | Technology |
|-------|-----------|
| Frontend | Next.js 15 (App Router), React 19, Tailwind CSS v4 |
| Backend | Next.js API Routes, Prisma ORM, PostgreSQL (Neon) |
| Auth | Privy β OAuth + embedded Stellar wallets |
| Blockchain | Stellar Network β USDC stablecoin |
| On-ramp | MoonPay β card β USDC |
| Off-ramp | Yellow Card β USDC β NGN bank transfer |
| Email | Resend |
| Deployment | Vercel |
---
## π Why Stellar?
- β‘ **3β5 second settlement** with fees 90 days ago. Skips invoices with active escrow, active dispute, or `doNotAutoCancel: true`. |
**Test locally:**
```bash
curl -H "Authorization: Bearer YOUR_CRON_SECRET" \
localhost
```
---
## π’ Deployment
### Vercel (recommended)
1. Push to GitHub
2. Import project in Vercel
3. Add all environment variables from `.env.example`
4. Deploy β cron jobs are configured automatically via `vercel.json`
### Webhooks Setup
After deploying, configure these webhook URLs in your provider β¦