StackPay is a decentralized, Bitcoin-native payment processor built on the Stacks blockchain. Inspired by Paystack and Stripe, StackPay empowers merchants, platforms, and developers to accept seamless crypto payments in STX, sBTC, and BTC, with on-chain verification and no intermediaries.

• Unique address generation for every payment
• Real-time blockchain monitoring (STX/sBTC/BTC)
• Webhooks to notify your app of confirmed payments
• Easy-to-share payment links & QR codes
• Merchant dashboard with payment history
• REST API + JS SDK (coming soon)
• Refunds & retries (optional)
• Fully open-source and extensible

• Digital creators accepting payments for courses or services
• DAOs collecting contributions in Bitcoin-native assets
• Web3 startups building Bitcoin-native checkout flows
• Freelancers and solopreneurs paid in sBTC/BTC

Frontend (Vite + Tailwind)
       |
       |— Merchant Dashboard
       |— Payment Pages
       |
Backend (TypeScript)
       |
       |— Address Generator (HD Wallet)
       |— Blockchain Listeners (BTC & STX)
       |— Webhook Dispatcher
       |
Smart Contracts (Clarity)
       |
       |— Invoice Registry
       |— Payment Verification Logic

• How It Works
• Integrating StackPay (Coming Soon)
• Webhook Reference
• Address Derivation Logic
• Event Listener Setup
• Testnet Usage Guide

# 1. Clone the repo
git clone https://github.com/yourname/stackpay.git && cd stackpay

# 2. Install dependencies
npm install

# 3. Start dev server
npm run dev

You’ll need your own HD wallet seed for testing address generation.

• Launch MVP on Stacks Testnet
• Smart Contract audits & refinements
• REST API for merchant integrations
• Webhooks & retry queue
• Full payment analytics dashboard
• Mainnet Launch 🚀

StackPay is open-source and welcomes contributions! Whether you're a Clarity dev, frontend builder, or just love payments — PRs are welcome.

# Run linter & tests
npm run lint
npm test

StackPay is inspired by the simplicity of Paystack and Stripe, with the mission to bring Bitcoin-native programmable commerce to life using the Stacks blockchain.

Built with ❤️ by @psalmuel_1st

MIT © 2025 Samuel Dahunsi