Payment system for merchants powered by the Stellar network
StellarPay is an open-source payment solution that enables merchants to accept payments on the Stellar network easily and securely. It leverages Stellar blockchain capabilities to offer fast, cost-effective, and reliable transactions.
- Simple merchant integration — onboard in minutes with a clean dashboard
- Real-time payment processing — instant settlement on the Stellar network
- Multi-asset support — accept XLM, USDC, and any Stellar-issued asset
- Payment links — generate shareable links with fixed or variable amounts
- Minimal fees — Stellar's ~0.00001 XLM base fee per transaction
- Webhook notifications — real-time payment event delivery to your backend
- Admin dashboard — full transaction history, analytics, and merchant management
stellarpay/
├── stellarpay-frontend/ # Next.js 14 + TypeScript + Tailwind CSS
└── stellarpay-backend/ # Express + TypeScript + PostgreSQL
| Layer | Technology |
|---|---|
| Frontend | Next.js 14, TypeScript, Tailwind CSS, shadcn/ui |
| Backend | Node.js, Express, TypeScript |
| Database | PostgreSQL + Prisma ORM |
| Blockchain | Stellar SDK (@stellar/stellar-sdk) |
| Auth | JWT + bcrypt |
| Testing | Jest, React Testing Library |
| CI/CD | GitHub Actions |
| Container | Docker + Docker Compose |
- Node.js ≥ 18
- PostgreSQL ≥ 14
- Docker (optional)
git clone https://github.com/PrincessnJoy/stellarpay.git
cd stellarpay
cp stellarpay-backend/.env.example stellarpay-backend/.env
cp stellarpay-frontend/.env.example stellarpay-frontend/.env.local
docker compose up --buildFrontend: http://localhost:3000
Backend API: http://localhost:4000
# Backend
cd stellarpay-backend
npm install
npx prisma migrate dev
npm run dev
# Frontend (new terminal)
cd stellarpay-frontend
npm install
npm run devContributions are welcome! Please read our Contributing Guide before submitting a PR.
- Fork the project
- Create your feature branch:
git checkout -b feat/amazing-feature - Commit your changes:
git commit -m 'feat: add amazing feature' - Push to the branch:
git push origin feat/amazing-feature - Open a Pull Request
Found a vulnerability? Please read our Security Policy and report it responsibly.
This project is licensed under the MIT License — see the LICENSE file for details.
If you find StellarPay useful, please consider:
- ⭐ Starring the repository
- 🐛 Reporting bugs
- 💡 Suggesting features
- 🤝 Contributing code