PayFlow — Continuous Subscription Billing on Stellar

🚀 Core Feature

Real-time pay‑as‑you‑go subscriptions where users pay only while consuming a service.

🏗 Architecture Overview

Web UI → Billing API → Pricing Engine → Stellar Network

📂 Repository Structure

payflow/
├── web/
├── api/
├── billing-engine/
├── workers/
├── database/
├── docs/
├── tests/
└── README.md

⚙️ Setup Instructions

Prerequisites

• Node.js ≥ 18
• PostgreSQL ≥ 14
• Redis ≥ 6

Installation

git clone https://github.com/your-org/payflow.git
cd payflow
npm install

Environment

PORT=3000
DATABASE_URL=postgres://localhost/payflow
REDIS_URL=redis://localhost:6379
STELLAR_NETWORK=testnet
HORIZON_URL=https://horizon-testnet.stellar.org
JWT_SECRET=super_secret

Run

npm run start:api
npm run start:workers
cd web && npm run dev

🏁 Getting Started

Create plan → Share link → Users subscribe → Billing streams live

🧑‍💻 Coding Standards

Clean architecture, REST APIs, ≥80% test coverage.

🔀 Pull Request Guidelines

Feature branch, passing CI, updated docs.

🗺 Roadmap

Q1: Core engine
Q2: Coupons & team plans
Q3: Marketplace integrations

📜 License

Apache 2.0